aboutsummaryrefslogtreecommitdiffstats
path: root/sources/shiboken6/doc/shibokengenerator.rst
diff options
context:
space:
mode:
Diffstat (limited to 'sources/shiboken6/doc/shibokengenerator.rst')
-rw-r--r--sources/shiboken6/doc/shibokengenerator.rst15
1 files changed, 13 insertions, 2 deletions
diff --git a/sources/shiboken6/doc/shibokengenerator.rst b/sources/shiboken6/doc/shibokengenerator.rst
index ee0b54800..a5092bfd6 100644
--- a/sources/shiboken6/doc/shibokengenerator.rst
+++ b/sources/shiboken6/doc/shibokengenerator.rst
@@ -49,8 +49,16 @@ care of interfacing Python and the underlying C++ library.
Handwritten inputs
==================
-Creating new bindings involves creating two pieces of "code": the typesystem and
-the inject code.
+Creating new bindings involves creating several pieces of "code": the header,
+the typesystem and, in most cases, the injected code.
+
+:header: A header with ``#include`` directives listing all the headers of the
+ desired classes. This header is not referenced by the generated code.
+ Alternatively, it is possible to pass a list of the headers of the
+ desired classes directly on the command line. In this case,
+ the command line option ``--use-global-header`` should be passed as
+ well to prevent the headers from being suppressed in the generated
+ code.
:typesystem: XML files that provides the developer with a tool to customize the
way that the generators will see the classes and functions. For
@@ -127,6 +135,9 @@ Options
fully qualified Python type names ('Module.Class'), but the module can
be omitted ('Class').
+``--use-global-header``
+ Use the global headers passed on the command line in generated code.
+
.. _generation-set:
``--generation-set``