new script dosepsbin (11nov11)

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

1 files changed, 119 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/support/dosepsbin/dosepsbin.txt b/Master/texmf-dist/doc/support/dosepsbin/dosepsbin.txt
new file mode 100644
index 00000000000..3980a9e55c4
--- /dev/null
+++ b/Master/texmf-dist/doc/support/dosepsbin/dosepsbin.txt
@@ -0,0 +1,119 @@
+NAME
+
+    dosepsbin -- Extract PS/WMF/TIFF sections from DOS EPS binary files
+
+VERSION
+
+    2011-11-10 v1.0
+
+SYNOPSIS
+
+    The progam dosepsbin analyses an EPS file that is not a plain ASCII
+    PostScript file but given as DOS EPS binary file.
+
+        dosepsbin [options] <input file>
+
+    First it analyzes the *input file*, validates its header and summarizes
+    the available sections. Depending on the given options, the sections are
+    then written to files.
+
+    Options:
+
+        --eps-file <file>      Write PS section to <file>.
+        --wmf-file <file>      Write WMF section to <file>.
+        --tiff-file <file>      Write WMF section to <file>.
+        --inputfile <file>     The name of the input file.
+        --verbose              Verbose output.
+        --quiet                Only errors and warnings are printed.
+        --help                 Brief help message.
+        --man                  Full documentation.
+        --version              Print version identification.
+
+    The files for output must be different from the input file.
+
+DESCRIPTION
+
+  DOS EPS Binary File Format
+
+    A Encapsulated PostScript (EPS) file can also given in a special binary
+    format to support the inclusion of a thumbnail. The file format starts
+    with a binary header that contains the positions of the possible
+    sections:
+
+    * Postscript (PS)
+    * Windows Metafile Format (WMF)
+    * Tag Image File Format (TIFF)
+
+    The PS section must be present and either the WMF file or the TIFF file
+    should be given.
+
+OPTIONS
+
+    --eps-file=<*file*>
+        The PS section is written to <*file*>. The output file must be
+        different from the input file.
+
+    --wmf-file=<*file*>
+        The WMF section is written to <*file*> if present. The output file
+        must be different from the input file.
+
+    --tiff-file=<*file*>
+        The TIFF section is written to <*file*> if present. The output file
+        must be different from the input file.
+
+    --inputfile=<*file*>
+        The input file can also be given directly on the command line. If
+        the file does not exist, then the file with extension `.eps' is
+        tried.
+
+    --verbose
+        Verbose messages.
+
+    --quiet
+        No messages are printed except for errors and warnings.
+
+    --help
+        Display help screen.
+
+    --man
+        Prints manual page.
+
+    --version
+        Print version identification and exit.
+
+EXAMPLES
+
+    The following command extracts the PS section from file test.eps and
+    stores the result in file test-ps.eps:
+
+        dosepsbin --eps-file test-ps.eps test.eps
+
+AUTHOR
+
+    Heiko Oberdiek, email: heiko.oberdiek at googlemail.com
+
+COPYRIGHT AND LICENSE
+
+    Copyright 2011 by Heiko Oberdiek.
+
+    This library is free software; you may redistribute it and/or modify it
+    under the same terms as Perl itself (Perl Artistic License/GNU General
+    Public License, version 2).
+
+SEE ALSO
+
+    The DOS EPS binary file format is described in section "5.2 Windows
+    Metafile or TIFF":
+
+        Adobe Developer Support,
+        Encapsulated PostScript File Format Specification,
+        Version 3.0,
+        1992-05-01,
+        http://partners.adobe.com/public/developer/en/ps/5002.EPSF_Spec.pdf
+
+HISTORY
+
+    2011/11/10 v1.0
+
+      * First version.
+