[doc] add note about x-ref in doc's README stable
authorSylvain Thénault <sylvain.thenault@logilab.fr>
Wed, 15 Sep 2010 11:13:17 +0200
branchstable
changeset 6245 e7e9d73d0c07
parent 6244 1c4ac1626f3c
child 6246 62e25fac41cd
[doc] add note about x-ref in doc's README
doc/book/README
--- a/doc/book/README	Wed Sep 15 11:03:48 2010 +0200
+++ b/doc/book/README	Wed Sep 15 11:13:17 2010 +0200
@@ -46,9 +46,26 @@
 .. [foot note] the foot note content
 
 
+Cross references
+================
 
-XXX
-* lien vers cw.cwconfig.CW_CUBES_PATH par ex.
+To arbitrary section
+--------------------
+
+:ref:`identifier` ou :ref:`label <identifier>`
+
+Label required of referencing node which as no title, else the node's title will be used.
 
 
-automodule, autofunction, automethod, autofunction
+To API objects
+--------------
+See the autodoc sphinx extension documentation. Quick overview:
+
+* ref to a class: :class:`cubicweb.devtools.testlib.AutomaticWebTest`
+
+* if you can to see only the class name in the generated documentation, add a ~:
+  :class:`~cubicweb.devtools.testlib.AutomaticWebTest`
+
+* you can also use :mod: (module), :exc: (exception), :func: (function), :meth: (method)...
+
+* syntax explained above to specify label explicitly may also be used