New ``latex_preamble`` setting, PDF standard fonts as default.

Use Times/Helvetica/Courier (the PDF standard fonts) as default fonts.

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

3 files changed, 29 insertions, 23 deletions

diff --git a/docutils/docs/api/publisher.txt b/docutils/docs/api/publisher.txt
index 60f322927..54e6e4b6c 100644
--- a/docutils/docs/api/publisher.txt
+++ b/docutils/docs/api/publisher.txt
@@ -312,12 +312,6 @@ docinfo
 
     'dedication' and 'abstract' are always moved to separate parts.
 
-.. footer
-    ``parts['footer']`` contains the document footer content, meant to
-    appear at the bottom of every printed page.
-    It is not used in the standard template but can be in a custom template
-    to define running heads/foots.
-
 fallbacks
     ``parts['fallbacks']`` contains fallback definitions for
     Docutils-specific commands and environments.
@@ -326,6 +320,10 @@ head_prefix
     ``parts['head_prefix']`` contains the declaration of
     documentclass and document options.
 
+latex_preamble
+    ``parts['latex_preamble']`` contains the argument of the
+    ``--latex-preamble`` option.
+
 pdfsetup
      ``parts['pdfsetup']`` contains the PDF properties
      ("hyperref" package setup).
diff --git a/docutils/docs/dev/todo.txt b/docutils/docs/dev/todo.txt
index 6728ba1b7..1383a5ba0 100644
--- a/docutils/docs/dev/todo.txt
+++ b/docutils/docs/dev/todo.txt
@@ -2103,20 +2103,6 @@ Which packages do we want to use?
 Default layout
 --------------
 
-* Which `default font`__ should we use for the output?
-
-  Proposal: Use one of the Postscript default fonts supported by standard
-  LaTeX (pages 10 and 11 of the `PSNFSS documentation`_), e.g. Times or
-  Palatino.
-
-  In PDF 1.3 there are 14 standard fonts:
-
-    Times-Roman, Times-Bold, Times-Italic, Times-BoldItalic, Helvetica,
-    Helvetica-Bold, Helvetica-Oblique, Helvetica-BoldOblique, Courier,
-    Courier-Bold, Courier-Oblique, Courier-BoldOblique, Symbol, ZapfDingbats
-
-  The rest you need to embed.
-
 * Use italic instead of slanted for titlereference?
 
 * Start a new paragraph after lists (as currently)
diff --git a/docutils/docs/user/config.txt b/docutils/docs/user/config.txt
index 9b0eb20b6..49d06cae8 100644
--- a/docutils/docs/user/config.txt
+++ b/docutils/docs/user/config.txt
@@ -951,8 +951,10 @@ _`font_encoding`
 
 embed_stylesheet
     Embed the stylesheet(s) in the header of the output file.  The
-    stylesheets must be accessible during processing. Also defined for
-    the `HTML Writer`__ (with default *on*).
+    stylesheets must be accessible during processing.  Currently, this
+    fails if the file is not available via the given path (i.e. the
+    file is *not* searched in the `TeX input path`_).
+    Also defined for the `HTML Writer`__ (with default *on*).
 
     Default: off.  Options: ``--embed-stylesheet, --link-stylesheet``.
 
@@ -970,12 +972,16 @@ stylesheet
     referenced with ``\usepackage`` (extension ``.sty`` or no extension) or
     ``\input`` (any other extension).
 
-    Default: no stylesheet ("").  Option: ``--stylesheet``.
+    LaTeX will search the specified files in the `TeX input path`_.
 
+    Default: no stylesheet ("").  Option: ``--stylesheet``.
 
     __ `stylesheet_path [latex2e writer]`_
     __ `embed_stylesheet [latex2e writer]`_
     __ `stylesheet [html4css1 writer]`_
+    .. _TeX input path:
+       http://www.tex.ac.uk/cgi-bin/texfaq2html?label=what-TDS
+
 
 .. _stylesheet_path [latex2e writer]:
 
@@ -996,6 +1002,22 @@ stylesheet_path
     __
     __ `stylesheet [latex2e writer]`_
 
+
+_`latex_preamble`
+    LaTeX code that will be inserted in the document preamble.
+    Can be used to load packages with options or (re-) define LaTeX
+    macros without writing a custom style file (new in Docutils 0.7).
+
+    Default: Load the "PDF standard fonts" (Times, Helvetica,
+    Courier)::
+
+      \usepackage{mathptmx} % Times
+      \usepackage[scaled=.90]{helvet}
+      \usepackage{courier}
+
+    Option: ``--latex-preamble``
+
+
 .. _template [latex2e writer]:
 
 template