From fa1b3cb700b25aea78eb84392e44993c2799b9e4 Mon Sep 17 00:00:00 2001
From: milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>
Date: Mon, 3 Jun 2013 09:57:07 +0000
Subject: [PATCH] Add section on customizing page headers and footers

git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk/docutils@7666 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
---
 docs/user/latex.txt | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/user/latex.txt b/docs/user/latex.txt
index 3eac80f4e..25d4582f2 100644
--- a/docs/user/latex.txt
+++ b/docs/user/latex.txt
@@ -1356,6 +1356,28 @@ Example 2:
    http://mirror.ctan.org/macros/latex/contrib/geometry/geometry.pdf
 
 
+page headers and footers
+------------------------
+
+With the fancyhdr_ package or the `KOMA-script`_ classes, you can define
+custom page head- and foot-lines.
+
+The "header" and "footer" directives save their content in the macros
+``\DUheader`` rsp. ``\DUfooter``. The macros can be used in LaTeX code and
+will be replaced by LaTeX with the content of the directives.
+
+Example:
+  Place left-aligned "header" and "footer" on every page with fancyhdr_::
+
+    \usepackage{fancyhdr}
+    \fancyhead[L]{\DUheader}
+    \fancyfoot{} % reset
+    \fancyfoot[L]{\DUfooter}
+    \pagestyle{fancy}
+
+.. _fancyhdr: http://www.ctan.org/pkg/fancyhdr
+
+
 page numbering
 --------------
 
-- 
2.11.4.GIT