From: Georg Brandl Date: Sat, 12 Jun 2010 09:45:01 +0000 (+0000) Subject: Use newer toctree syntax. X-Git-Tag: v2.7rc2~28 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fd3eff68f58646c5f32c8957b1d3a8ddd5e6e72e;p=python Use newer toctree syntax. --- diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst index eec86501d3..9cffc6c8b8 100644 --- a/Doc/documenting/markup.rst +++ b/Doc/documenting/markup.rst @@ -698,10 +698,10 @@ tables of contents. The ``toctree`` directive is the central element. .. toctree:: :maxdepth: 2 - intro.rst - strings.rst - datatypes.rst - numeric.rst + intro + strings + datatypes + numeric (many more files listed here) This accomplishes two things: @@ -709,8 +709,8 @@ tables of contents. The ``toctree`` directive is the central element. * Tables of contents from all those files are inserted, with a maximum depth of two, that means one nested heading. ``toctree`` directives in those files are also taken into account. - * Sphinx knows that the relative order of the files ``intro.rst``, - ``strings.rst`` and so forth, and it knows that they are children of the + * Sphinx knows that the relative order of the files ``intro``, + ``strings`` and so forth, and it knows that they are children of the shown file, the library index. From this information it generates "next chapter", "previous chapter" and "parent chapter" links.