aboutsummaryrefslogtreecommitdiffstats
path: root/doc/compiling/setup-generator.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/compiling/setup-generator.rst')
-rw-r--r--doc/compiling/setup-generator.rst54
1 files changed, 54 insertions, 0 deletions
diff --git a/doc/compiling/setup-generator.rst b/doc/compiling/setup-generator.rst
new file mode 100644
index 000000000..28fe2fbb3
--- /dev/null
+++ b/doc/compiling/setup-generator.rst
@@ -0,0 +1,54 @@
+
+.. _python-bindings-generator:
+
+*************************
+Python Bindings Generator
+*************************
+
+Overview
+=========================================
+
+The **Python Bindings Generator** (A.K.A. :program:`shiboken`) is
+the program that creates the bindings source files from Qt headers and
+auxiliary files (typesystems, ``global.h`` and glue files). It makes
+heavy use of the :ref:`api-extractor` library.
+
+
+Getting the sources
+===================
+
+* Git URL: https://dvcs.projects.maemo.org/git/python/shiboken
+* Web interface: https://dvcs.projects.maemo.org/git/?p=python/shiboken
+
+To checkout the most updated version, use the following command::
+
+ $ git svn clone https://dvcs.projects.maemo.org/git/?p=python/shiboken
+
+Build requirements
+==================
+
++ CMake >= 2.6.0
++ Qt4.5 libraries and development headers >= 4.5.0
++ :ref:`api-extractor` + development headers
+
+Building and installing
+=======================
+
+To build and install just follow the generic cmake instructions in
+section :ref:`cmake-primer`.
+
+Debian packaging
+================
+
+In order to compile this package in a debian environment, make sure the
+following packages are installed:
+
+* debhelper (>= 5)
+* cdbs
+* cmake (>= 2.6.0)
+* libqt4-dev (>= 4.5)
+* libapiextractor-dev (>= 0.1)
+
+And then you can build the package using::
+
+ $ dpkg-buildpackage -rfakeroot