Manipulating Documentation
--------------------------
inject-documentation
^^^^^^^^^^^^^^^^^^^^
The inject-documentation node inserts the documentation into the generated
documentation. This node is a child of the object-type, value-type and
modify-function nodes.
.. code-block:: xml
// the documentation
The **mode** attribute default value is *replace*.
The **format** attribute specifies when the documentation injection will
occur and it accepts the following values:
* native: Before XML<->Backend transformation occur, so the injected code *must* be a valid XML.
* target: After XML<->Backend transformation occur, so the injected code *must* be a valid backend format.
At the moment the only supported backend is Sphinx.
modify-documentation
^^^^^^^^^^^^^^^^^^^^
The modify-documentation node allows you to change the auto-generated
documentation. API Extractor transforms XML's from qdoc3 (the Qt documentation
tool) into .rst files to be processed later using Sphinx. So you can modify
the XML before the transformation occur.
.. code-block:: xml
The **xpath** attribute is the XPath to the node that you want to modify.