[Docutils-checkins] r6985 - trunk/docutils/docs/user/latex.txt

[<mi...@us...>]

Author: milde
Date: 2011-03-03 22:30:44 +0100 (Thu, 03 Mar 2011)
New Revision: 6985

Modified:
   trunk/docutils/docs/user/latex.txt
Log:
Update latex writer documentation.

Add hints for configuring the indentation of a literal block with
lstlisting.

Replace the legacy pstricks+ucs workaround to get Unicode block characters
with the advise to use XeTeX.

Modified: trunk/docutils/docs/user/latex.txt
===================================================================
--- trunk/docutils/docs/user/latex.txt	2011-03-03 04:26:28 UTC (rev 6984)
+++ trunk/docutils/docs/user/latex.txt	2011-03-03 21:30:44 UTC (rev 6985)
@@ -1226,6 +1226,15 @@
     \lstset{columns=fullflexible,
          basewidth={0.5em,0.4em}}
 
+
+  The indentation of literal blocks can be reset with ::
+
+    \lstset{resetmargins=true}
+
+  and/or configured with e. g.::
+
+    \lstset{xleftmargin=-2em}
+
 __ ../ref/rst/restructuredtext.html#literal-blocks
 .. _literal-block-env:
    config.html#literal-block-env
@@ -1924,6 +1933,10 @@
 Unicode box drawing and block characters
 ````````````````````````````````````````
 
+The easiest solution is to use xelatex_ for `PDF generation`_.
+
+With "traditional" TeX engines (e.g. pdflatex_):
+
 - Generate LaTeX code with `output-encoding`_ "utf-8".
 
 - Add the pmboxdraw_ package to the `style sheets`_.
@@ -1932,18 +1945,6 @@
 Unfortunately, this defines only a subset of the characters
 (see pmboxdraw.pdf_ for a list).
 
-Alternatively:
-
-- In the latex file, edit the preamble to load ucs_ with "postscript"
-  option and also load the pstricks package::
-
-      - \usepackage[utf8]{inputenc}
-      + \usepackage[postscript]{ucs}
-      + \usepackage{pstricks}
-      + \usepackage[utf8x]{inputenc}
-
-- Convert to PDF with ``latex``, ``dvips``, and ``ps2pdf``.
-
 .. _pmboxdraw:
    http://mirror.ctan.org/help/Catalogue/entries/pmboxdraw.html