summaryrefslogtreecommitdiff
path: root/doc/invocation.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/invocation.rst')
-rw-r--r--doc/invocation.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/invocation.rst b/doc/invocation.rst
index 2c69d32f..da052bdb 100644
--- a/doc/invocation.rst
+++ b/doc/invocation.rst
@@ -227,6 +227,17 @@ The :program:`sphinx-apidoc` script has several options:
This sets the maximum depth of the table of contents, if one is generated.
+.. option:: -l, --follow-links
+
+ This option makes sphinx-apidoc follow symbolic links when recursing the
+ filesystem to discover packages and modules. You may need it if you want
+ to generate documentation from a source directory managed by
+ `collective.recipe.omelette
+ <http://pypi.python.org/pypi/collective.recipe.omelette/>`_.
+ By default, symbolic links are skipped.
+
+ .. versionadded:: 1.2
+
.. option:: -T, --no-toc
This prevents the generation of a table-of-contents file ``modules.rst``.