From 5fdec2672365d73d7b44d37fc694c5eb70655c5b Mon Sep 17 00:00:00 2001
From: grubert <grubert@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>
Date: Thu, 19 Oct 2006 17:27:27 +0000
Subject: [PATCH] More notes on section numbering.

git-svn-id: https://docutils.svn.sourceforge.net/svnroot/docutils/trunk/docutils@4771 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
---
 docs/user/latex.txt | 37 ++++++++++++++++++++++++++-----------
 1 file changed, 26 insertions(+), 11 deletions(-)

diff --git a/docs/user/latex.txt b/docs/user/latex.txt
index 56ee56626..160ac17ed 100644
--- a/docs/user/latex.txt
+++ b/docs/user/latex.txt
@@ -220,17 +220,32 @@ LaTeX also has a command ``\listoftables``.
 Section numbering
 -----------------
 
-If section numbering and LaTeX table of contents is used LaTeX and 
-docutils will number sections. To switch off displaying of LaTeX's
-numbers one has to add following lines to the stylesheet ::
-
-  % no section number display
-  \makeatletter
-  \def\@seccntformat#1{}
-  \makeatother
-  % no numbers in toc
-  \renewcommand{\numberline}[1]{}
-
+The options ``--section-numbering`` and ``--use-latex-toc``, both 
+influence section numbering.
+
+* If ``--use-latex-toc`` is specified the latex-writer generates 
+  LaTeX output, so that LaTeX generates a table of contents and
+  generates section numbers. Usually one does not want to have 
+  section numbers generated by docutils in this case, therefore
+  ``--no-section-numbering`` should be specified.
+
+  The advantage is that LaTeX does put page numbers into the
+  table of contents, but the section depth is limited by the 
+  used LaTeX-documentclass, usually to three levels.
+
+* If section numbering and LaTeX table of contents is used LaTeX and 
+  docutils will number sections. To switch off displaying of LaTeX's
+  numbers one has to add following lines to the stylesheet ::
+
+    % no section number display
+    \makeatletter
+    \def\@seccntformat#1{}
+    \makeatother
+    % no numbers in toc
+    \renewcommand{\numberline}[1]{}
+
+  This enables to have the same section numbers as in other docutils-
+  writers and page numbers in the table of contents.
 
 Number pages by chapter
 -----------------------
-- 
2.11.4.GIT