documentation update: Parts Provided by the LaTeX2e Writer

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

1 files changed, 14 insertions, 5 deletions

diff --git a/docutils/docs/api/publisher.txt b/docutils/docs/api/publisher.txt
index 9717fcc34..d614e582d 100644
--- a/docutils/docs/api/publisher.txt
+++ b/docutils/docs/api/publisher.txt
@@ -273,19 +273,28 @@ Parts Provided by the LaTeX2e Writer
 ````````````````````````````````````
 
 __`head_prefix`
-    ``parts['head_prefix']`` contains the LaTeX document class, package 
-    and stylesheet inclusion.
+    ``parts['head_prefix']`` contains the first part of the LaTeX preamble:
+    LaTeX document class, required packages and setup before the stylesheet
+    inclusion.
+    
+__`stylesheet`
+    ``parts['stylesheet']`` contains the embedded stylesheet(s) or
+    stylesheet loading command(s).
 
 __`head`
-    ``parts['head']`` currently is empty. 
+    ``parts['head']`` contains the part of the LaTeX preamble following
+    the stylesheet(s): fallback definitions for Docutils-specific commands,
+    PDF hyperlink setup and title metadata (if present). 
 
 __`body_prefix`
     ``parts['body_prefix']`` contains the LaTeX ``\begin{document}`` and
-    title page. 
+    the title page or ``\maketitle`` (in titled documents). 
 
 __`body`
     ``parts['body']`` contains the LaTeX document content, less
-    the ``\begin{document}`` and ``\end{document}`` tags themselves.
+    the ``\begin{document}`` and ``\end{document}`` tags themselves, i.e.
+    the part that can be included into another LaTeX document body using
+    ``\input{}``.
 
 __`body_suffix`
     ``parts['body_suffix']`` contains the LaTeX ``\end{document}``.