Add some explanation for use-verbatim-if-possible

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

1 files changed, 12 insertions, 0 deletions

diff --git a/docs/user/latex.txt b/docs/user/latex.txt
index 0d49913be..095d743fa 100644
--- a/docs/user/latex.txt
+++ b/docs/user/latex.txt
@@ -127,6 +127,18 @@ line spacing           Is done with package *setspace*, which gives
 
                        for bigger linespacing.
 ---------------------  ------------------------------------------------
+use verbatim when      When possibile, use verbatim for literal-blocks.
+possible               Default is to always use the mbox environment.
+
+                       A literal-block element, when processed by a
+                       docutils-writer might have it's origin in a
+                       markup with "::" syntax or a 
+                       ".. parsed-literal::" directive.
+
+                       A LaTeX verbatim environment is only useable if
+                       there are no elements contained in the 
+                       literal-block.
+---------------------  ------------------------------------------------
 font selection         see below
 =====================  ================================================