From a7880bedd92bfed75908c055eae641610f6f6ca2 Mon Sep 17 00:00:00 2001
From: Hugo Lima <hugo.lima@openbossa.org>
Date: Fri, 23 Oct 2009 15:41:56 -0200
Subject: Added documentation for tag conversion-rule.

---
 doc/typesystem_manipulating_objects.rst | 18 ++++++++++++++++++
 doc/typesystem_specifying_types.rst     | 10 +++++++++-
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/doc/typesystem_manipulating_objects.rst b/doc/typesystem_manipulating_objects.rst
index 9428df7e2..34b5f7194 100644
--- a/doc/typesystem_manipulating_objects.rst
+++ b/doc/typesystem_manipulating_objects.rst
@@ -97,3 +97,21 @@ add-function
          </object-type>
 
     The ``return-type`` attribute defaults to *void*, and the ``access`` to *public*.
+
+.. _conversion-rule:
+
+conversion-rule
+^^^^^^^^^^^^^^^
+
+    The conversion-rule node allows you to write customized code to convert the given argument between the target
+    language and C++, and is a child of the :ref:`value-type`, :ref:`object-type`, :ref:`primitive-type` and
+    :ref:`container-type` nodes.
+
+    The code pointed by the file attribute is very tied to the generator using APIExtractor, so it don't follow any
+    rules, but the generator rules..
+
+    .. code-block:: xml
+
+        <value-type name="Foo">
+            <convertion-rule file="my_converter_implementation.h" />
+        </value-type>
diff --git a/doc/typesystem_specifying_types.rst b/doc/typesystem_specifying_types.rst
index 9535a6aee..e94873834 100644
--- a/doc/typesystem_specifying_types.rst
+++ b/doc/typesystem_specifying_types.rst
@@ -63,6 +63,7 @@ rejection
     function, set the class attribute to \*. You can use an empty class field
     to denote a global function.
 
+.. _primitive-type:
 
 primitive-type
 ^^^^^^^^^^^^^^
@@ -207,7 +208,7 @@ interface-type
 
     The interface-type node indicates that the given class is replaced by an
     interface pattern when mapping from C++ to the target language. Using the
-    interface-type node implicitly makes the given type an :ref:`object type`.
+    interface-type node implicitly makes the given type an :ref:`object-type`.
 
     .. code-block:: xml
 
@@ -222,3 +223,10 @@ interface-type
     If there is no C++ base class, the *optional* **default-superclass** attribute
     can be used to specify a superclass in the generated target language API, for
     the given class.
+
+.. _container-type:
+
+container-type
+^^^^^^^^^^^^^^
+
+    .. note:: This tag is not documented yet.
-- 
cgit v1.2.3