diff options
Diffstat (limited to 'doc/commandlineoptions.rst')
-rw-r--r-- | doc/commandlineoptions.rst | 22 |
1 files changed, 14 insertions, 8 deletions
diff --git a/doc/commandlineoptions.rst b/doc/commandlineoptions.rst index ddd864a48..eede06b31 100644 --- a/doc/commandlineoptions.rst +++ b/doc/commandlineoptions.rst @@ -1,15 +1,21 @@ Command line options ******************** -At the moment, there is just one flag to change the |project| behaviour, ``--enable-parent-ctor-heuristic``. This flag enable an usefull heuristic which can save a lot of work when writing the typesystem. +Usage +----- -This heuristic will be triggered when generating code for a method and: +:: -* The function is a constructor. -* The argument name is "parent". -* The argument type is a pointer to an object. + shiboken [options] -When triggered, the heuristic will set the argument named "parent" as the parent of the current object. -Being a child of an object means that when the object's parent dies, the C++ instance also dies, so the Python references will be invalidated. -The main focus of this tag was to remove a lot of hand written code from typesystem when binding Qt libraries, for Qt, this heuristic is never wrong, but be aware that it might be when binding your own libraries. +Options +------- + +.. _option-heuristic: + +``--enable-parent-ctor-heuristic`` + This flag enable an useful heuristic which can save a lot of work related to object ownership when + writing the typesystem. + For more info, check :ref:`ownership-parent-heuristics`. + |