sol2/docs/source/index.rst
ThePhD 22c41d9482 Update documentation, refactor examples out of docs, fix warning about static entry path
Still need help refactoring out more code from docs...
2018-02-24 17:19:16 -05:00

88 lines
2.2 KiB
ReStructuredText

.. Sol documentation master file, created by
sphinx-quickstart on Mon Feb 29 21:49:51 2016.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
.. image:: media/sol.png
:target: https://github.com/ThePhD/sol2
:alt: sol2 repository
Sol |version|
=============
*a fast, simple C++ and Lua Binding*
When you need to hit the ground running with Lua and C++, `Sol`_ is the go-to framework for high-performance binding with an easy to use API.
get going:
----------
.. toctree::
:maxdepth: 1
:name: mastertoc
tutorial/all-the-things
tutorial/tutorial-top
errors
compilation
features
functions
usertypes
containers
threading
traits
api/api-top
mentions
benchmarks
performance
safety
exceptions
rtti
codecvt
cmake
licenses
origin
"I need feature X, maybe you have it?"
--------------------------------------
Take a look at the :doc:`Features<features>` page: it links to much of the API. You can also just straight up browse the :doc:`api<api/api-top>` or ease in with the :doc:`tutorials<tutorial/tutorial-top>`. To know more about the implementation for usertypes, see :doc:`here<usertypes>` To know how function arguments are handled, see :ref:`this note<function-argument-handling>`. Don't see a feature you want? Send inquiries for support for a particular abstraction to the `issues`_ tracker.
the basics:
-----------
.. note::
The code below *and* more examples can be found in the `examples directory`_
.. literalinclude:: ../../examples/docs/simple_functions.cpp
:name: simple-functions-example
:linenos:
.. literalinclude:: ../../examples/docs/simple_structs.cpp
:name: simple-structs-example
:linenos:
helping out
-----------
You can support the library by submitting pull requests to fix anything (the code, typos, even contribute your own examples).
You can support me and my family by `donating a little something here`_.
Thank you for using sol2!
Indices and tables
==================
* :ref:`genindex`
* :ref:`search`
.. _Sol: https://github.com/ThePhD/sol2
.. _issues: https://github.com/ThePhD/sol2/issues
.. _examples directory: https://github.com/ThePhD/sol2/tree/develop/examples
.. _donating a little something here: https://www.paypal.me/LMeneide