diff options
author | Luciano Wolf <luciano.wolf@openbossa.org> | 2010-04-29 15:14:05 -0300 |
---|---|---|
committer | Luciano Wolf <luciano.wolf@openbossa.org> | 2010-05-03 17:21:33 -0300 |
commit | 29ad9f3baf3540a82c008d66373e7e8534aff5a6 (patch) | |
tree | 7650843f33e9d518179cd029e2047883492832db /doc/tutorial/introduction.rst | |
parent | 55e4336840093a118da89602b43b91f36a115344 (diff) |
Update shiboken documentation.
Diffstat (limited to 'doc/tutorial/introduction.rst')
-rw-r--r-- | doc/tutorial/introduction.rst | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/doc/tutorial/introduction.rst b/doc/tutorial/introduction.rst new file mode 100644 index 000000000..40240f80a --- /dev/null +++ b/doc/tutorial/introduction.rst @@ -0,0 +1,32 @@ +Binding Generation Tutorial +*************************** + +This tutorial intends to describe the process of binding creation with +Shiboken and using a very simple Qt4 based library will be used as an +example. + +The image below shows the inputs needed to generate the binding source code. + +.. image:: images/generatorworkings.png + +Putting in words, the user provides the headers for the library along with a +`typesystem <http://www.pyside.org/docs/apiextractor/typesystem.html>`_ file +describing how the classes will be exposed in the target language, as well as +any needed custom source code to be merged with the generated source code. + +This tutorial will go through the steps needed to have the binding +ready to be imported and used from a Python program. The tutorial +source code is available as a tar ball `here <../_static/bindingexample.tar.gz>`_. + +**NOTE:** the binding generator is intended to be used with Qt4 based libraries +only, at least for the time being. + +.. toctree:: + :maxdepth: 3 + + libfoo + bindinglibfoo + typesystemcreation + globalheader + buildingthebinding + |