Document page break configuration

git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@6140 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 36 insertions, 0 deletions

diff --git a/docutils/docs/user/latex.txt b/docutils/docs/user/latex.txt
index 36557d031..ca9b76f65 100644
--- a/docutils/docs/user/latex.txt
+++ b/docutils/docs/user/latex.txt
@@ -981,6 +981,42 @@ Example:
 
 __ ../ref/rst/restructuredtext.html#option-lists
 
+page breaks
+```````````
+
+* Page breaks before top-level sections are the default with a
+  documentclass that provides "chapters", e.g.  "book", "memoir" or
+  "scrbook".
+
+* Redefining the \section or \section* command in a
+  style sheet is possible too.
+
+* `Raw latex`_ can be used::
+
+    .. raw:: latex
+
+      \newpage % hard pagebreak at exactly this position
+
+  or
+
+    .. raw:: latex
+
+      \pagebreak[2] % recommended page break after line end (precedence 1...4)
+
+* The transition element can be re-defined to produce a page break,
+  e.g.
+
+  in a style sheet::
+
+    \newcommand*{\DUtransition}{\pagebreak[4]}
+
+  or in the document::
+
+    .. raw:: latex
+
+      \renewcommand*{\DUtransition}{\pagebreak[4]}
+
+
 page layout
 ```````````