latexpand (21aug13)

git-svn-id: svn://tug.org/texlive/trunk@31489 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 59 insertions, 52 deletions

diff --git a/Master/texmf-dist/doc/support/latexpand/README b/Master/texmf-dist/doc/support/latexpand/README
index 605466deb12..18ab86cce42 100644
--- a/Master/texmf-dist/doc/support/latexpand/README
+++ b/Master/texmf-dist/doc/support/latexpand/README
@@ -1,52 +1,59 @@
-LATEXPAND(1)          User Contributed Perl Documentation         LATEXPAND(1)
-
-
-
-NNAAMMEE
-       latexpand - Flatten LaTeX file by expanding \include and \input, remove
-       comments
-
-SSYYNNOOPPSSIISS
-       latexpand [options] FILE...
-
-        Options:
-               --verbose        show what's going on
-               --keep-comments  don't strip comments
-               --empty-comments keep empty comments (i.e. % at end of lines) for clarity
-               --keep-includes  don't expand \input and \include directives
-               --expand-usepackage
-                                Expand \usepackage{...} directives if the
-                                corresponding .sty file is found in
-                                $TEXINPUTS
-               --expand-bbl FILE
-                                Expand the bibliography by inlining FILE
-                                (should be a *.bbl file)
-               --help           this help message
-               --output <file>, -o <file>
-                                generate output in <file>
-               --explain        generate explanatory comments in output
-               --show-graphics  show included graphics
-               --graphics_extensions
-                                colon-separated list of possible graphics extensions
-                                (used by --show-graphics to find the actual graphics files)
-
-UUSSEESS
-       The most common use of latexpand is to simplify distribution of source
-       LaTeX files, typically to satisfy the requirement of editors and
-       archival sites (springer, arXiv.org, ...) who force the authors to
-       submit sources. One does not necessarily want to submit sources with
-       comments, and uploading a document made of several files including each
-       other is a bit painful. By default, latexpand answers both problems by
-       outputing a single LaTeX file that contain no comment.
-
-GGEETTTTIINNGG LLAATTEEXXPPAANNDD
-       The latest version of latexpand is available here:
-
-         https://gitorious.org/latexpand
-
-BBUUGGSS
-       Please, report bugs to Matthieu Moy <Matthieu.Moy@imag.fr>.
-
-
-
-perl v5.10.1                      2012-11-07                      LATEXPAND(1)
+NAME
+    latexpand - Flatten LaTeX file by expanding \include and \input, ... and
+    remove comments
+
+SYNOPSIS
+    latexpand [options] FILE...
+
+  Options:
+            --verbose        show what's going on
+            --keep-comments  don't strip comments (comments are lines
+                             starting with %, and anything below
+                             \end{document})
+            --empty-comments keep empty comments (i.e. % at end of lines) for clarity
+            --keep-includes  don't expand \input and \include directives
+            --expand-usepackage
+                             Expand \usepackage{...} directives if the
+                             corresponding .sty file is found in
+                             $TEXINPUTS
+            --expand-bbl FILE
+                             Expand the bibliography by inlining FILE
+                             (should be a *.bbl file)
+            --help           this help message
+            --output <file>, -o <file>
+                             generate output in <file>
+            --explain        generate explanatory comments in output
+            --show-graphics  show included graphics
+            --graphics_extensions
+                             colon-separated list of possible graphics extensions
+                             (used by --show-graphics to find the actual graphics files)
+
+USES
+    The most common use of latexpand is to simplify distribution of source
+    LaTeX files, typically to satisfy the requirement of editors and
+    archival sites (springer, arXiv.org, ...) who force the authors to
+    submit sources. One does not necessarily want to submit sources with
+    comments, and uploading a document made of several files including each
+    other is a bit painful. By default, latexpand answers both problems by
+    outputing a single LaTeX file that contain no comment.
+
+GETTING LATEXPAND
+    The latest version of latexpand is available here:
+
+      https://gitorious.org/latexpand
+
+    Versions are uploaded to ctan.org from time to time:
+
+      http://www.ctan.org/pkg/latexpand
+
+BUGS
+    Please, report bugs to Matthieu Moy <Matthieu.Moy@imag.fr>.
+
+  Known bugs
+    latexpand currently ignores \begin{verbatim} ... \end{verbatim}, and
+    will therefore process any \include, \input, ... directives that appear
+    within verbatim environments (while it shouldn't).
+
+    It would be nice to remove code between \begin{comment} and
+    \end{comment} too if \usepackage{comment} is used.
+