diff options
author | Renato Filho <renato.filho@openbossa.org> | 2010-05-25 16:15:23 -0300 |
---|---|---|
committer | Hugo Parente Lima <hugo.pl@gmail.com> | 2012-03-09 19:10:03 -0300 |
commit | da684da266fe4ca63c7dd7a880988ef08a1fe4ac (patch) | |
tree | 0634caa93c93e9031c868442720505494ee5098a /doc/typesystem_manipulating_objects.rst | |
parent | 2060c23e8d2d80c721dd4eb31a777f4be0fefdfc (diff) |
Document about the flag "since".
Reviewer: Luciano Wolf <luciano.wolf@openbossa.org>,
Marcelo Lira <marcelo.lira@openbossa.org>
Diffstat (limited to 'doc/typesystem_manipulating_objects.rst')
-rw-r--r-- | doc/typesystem_manipulating_objects.rst | 15 |
1 files changed, 12 insertions, 3 deletions
diff --git a/doc/typesystem_manipulating_objects.rst b/doc/typesystem_manipulating_objects.rst index 84a5c1ad7..4c8121135 100644 --- a/doc/typesystem_manipulating_objects.rst +++ b/doc/typesystem_manipulating_objects.rst @@ -15,7 +15,7 @@ inject-code <value-type> <inject-code class="native | target | target-declaration" - position="beginning | end"> + position="beginning | end" since="..."> // the code </inject-code> </value-type> @@ -33,6 +33,8 @@ inject-code is inserted at the beginning of the function. If it is set to *end*, the code is inserted at the end of the function. + The ``since`` attribute specify the API version where this code was injected. + modify-field ^^^^^^^^^^^^ @@ -66,6 +68,7 @@ modify-function <object-type> <modify-function signature="..." + since="..." remove="all | c++" access="public | private | protected" rename="..." /> @@ -74,6 +77,8 @@ modify-function The ``signature`` attribute is a normalized C++ signature, excluding return values but including potential const declarations. + The ``since`` attribute specify the API version when this function was modified. + The ``remove``, ``access`` and ``rename`` attributes are *optional* attributes for added convenience; they serve the same purpose as the deprecated tags :ref:`remove`, :ref:`access` and :ref:`rename`. @@ -93,11 +98,13 @@ add-function .. code-block:: xml <object-type> - <add-function signature="..." return-type="..." access="public | protected" static="yes | no" /> + <add-function signature="..." return-type="..." access="public | protected" static="yes | no" since="..."/> </object-type> The ``return-type`` attribute defaults to *void*, the ``access`` to *public* and the ``static`` one to *no*. + The ``since`` attribute specify the API version when this function was added. + .. _conversion-rule-on-types: conversion-rule @@ -113,8 +120,10 @@ conversion-rule .. code-block:: xml <value-type name="Foo"> - <convertion-rule file="my_converter_implementation.h" /> + <convertion-rule file="my_converter_implementation.h" since="..."/> </value-type> + The ``since`` attribute specify the API version when this conversion rule became valid. + .. note:: You can also use the conversion-rule node to specify :ref:`how the conversion of a single function argument should be done in a function <conversion-rule>`. |