Update to v. 0.4.1: documentation update

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

4 files changed, 196 insertions, 102 deletions

diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.install b/Master/texmf-dist/doc/support/epspdf/epspdf.install
index 8aa4fa90f07..d397f96f630 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.install
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.install
@@ -205,14 +205,12 @@ Installation
 
   Mac OS X
 
-   Install as for Unix/Linux. Here, too, all files should be in the same
-   directory.
+   You can install as for Unix/Linux. Here, too, all files should be in the
+   same directory.
 
-   You can try to start epspdftk.rb from the dock or by doubleclicking. If
-   that doesn't work out, give the [25]epspdf.app applet a try. After
-   unpacking, move the file epspdf.app to the same directory as the .rb
-   files. The zipfile also includes this file in text format
-   (epspdf.applescript).
+   There is also a compressed disk image epspdf.x.x.x.dmg.gz which wraps
+   epspdftk into a Max OS X app. Double-click once to expand, a second time
+   to mount, then drag epspdftk.app to the Applications folder.
 
    Epspdf mostly duplicates functionality of Preview. But having an alternate
    conversion engine means that you can have another shot at problem files.
@@ -232,7 +230,7 @@ Preview programs
    Supported PostScript viewers include evince, gv, gsview and okular. These
    are also listed as pdf viewers. Additional pdf viewers are xpdf, gpdf,
    epdfview and acroread/Adobe Reader. You can also specify a previewer
-   manually in the configuration screen; see the [26]user manual..
+   manually in the configuration screen; see the [25]user manual..
 
   Mac OS X
 
@@ -241,34 +239,42 @@ Preview programs
 
 Files
 
-     * [27]epspdf.0.4.0.tgz preferred for Unix and Mac OS X
-     * [28]epspdf.0.4.0.zip preferred for Windows
-     * [29]epspdf.0.4.0.exe Windows setup program, including Ruby/Tk subset
-     * [30]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb
+     * [26]epspdf.0.4.1.tgz preferred for Unix and Mac OS X
+     * [27]epspdf.0.4.1.zip preferred for Windows
+     * [28]epspdf.0.4.1.exe Windows setup program, including Ruby/Tk subset
+     * [29]epspdftk.0.4.1.dmg.gz compressed disk image with epspdftk wrapped
+       into a Mac OS X app
 
   Older releases
 
-     * [31]epspdf.0.3.0.tgz for Unix and Mac OS X
-     * [32]epspdf.0.3.0.zip for Windows
-     * [33]epspdf.0.3.0.exe Windows setup program
-     * [34]epspdf.0.2.12.tgz for Unix and Mac OS X
-     * [35]epspdf.0.2.12.zip for Windows
-     * [36]epspdf.0.2.12.exe Windows setup program
-     * [37]epspdf.0.2.11.tgz for Unix and Mac OS X
-     * [38]epspdf.0.2.11.zip for Windows
-     * [39]epspdf.0.2.11.exe Windows setup program
-     * [40]epspdf.0.2.01.tgz for Unix and Mac OS X
-     * [41]epspdf.0.2.01.zip for Windows
-     * [42]epspdf.0.2.exe, Windows setup program
+     * [30]epspdf.0.3.0.tgz for Unix and Mac OS X
+     * [31]epspdf.0.3.0.zip for Windows
+     * [32]epspdf.0.3.0.exe Windows setup program
+     * [33]epspdf.0.2.12.tgz for Unix and Mac OS X
+     * [34]epspdf.0.2.12.zip for Windows
+     * [35]epspdf.0.2.12.exe Windows setup program
+     * [36]epspdf.0.2.11.tgz for Unix and Mac OS X
+     * [37]epspdf.0.2.11.zip for Windows
+     * [38]epspdf.0.2.11.exe Windows setup program
+     * [39]epspdf.0.2.01.tgz for Unix and Mac OS X
+     * [40]epspdf.0.2.01.zip for Windows
+     * [41]epspdf.0.2.exe, Windows setup program
+     * [42]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb
 
 Releases
 
+   0.4.1
+           Current version. Documentation: added section on bitmaps. Windows
+           setup program: added missing Tcl/Tk licenses. Mac:
+           double-clickable epspdftk.app with included epspdftk replaces
+           double-clickable epspdf.app add-on.
+
    0.4.0
-           Current version. Optionally uses hires boundingbox. Faster startup
-           due to simpler testing of prerequisites. Grayscaling: support for
-           HSB color model, although I yet have to encounter a PostScript
-           file using this. Manual converted to texinfo format. Windows: new
-           View with... button; support for MikTeX's built-in Ghostscript;
+           Optionally uses hires boundingbox. Faster startup due to simpler
+           testing of prerequisites. Grayscaling: support for HSB color
+           model, although I yet have to encounter a PostScript file using
+           this. Manual converted to texinfo format. Windows: new View
+           with... button; support for MikTeX's built-in Ghostscript;
            streamlined Ruby subset, with Tcl/Tk compiled from source.
 
    0.3.0
@@ -310,7 +316,7 @@ Releases
 
    --------------------------------------------------------------------------
 
-   Last revised: February 29, 2009
+   Last revised: March 12, 2009
 
 References
 
@@ -336,24 +342,24 @@ References
   19. http://rubyforge.org/frs/?group_id=167
   20. http://www.ruby-lang.org/en/downloads/
   21. http://activestate.com/Products/ActiveTcl/
-  22. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
-  23. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
-  24. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
-  25. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
-  26. http://tex.aanhet.net/epspdf/epspdf.pdf
-  27. http://tex.aanhet.net/epspdf/epspdf.0.4.0.tgz
-  28. http://tex.aanhet.net/epspdf/epspdf.0.4.0.zip
-  29. http://tex.aanhet.net/epspdf/epspdf.0.4.0.exe
-  30. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
-  31. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
-  32. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
-  33. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
-  34. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
-  35. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
-  36. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
-  37. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz
-  38. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip
-  39. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe
-  40. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
-  41. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
-  42. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
+  22. http://tex.aanhet.net/epspdf/epspdf.0.4.1.exe
+  23. http://tex.aanhet.net/epspdf/epspdf.0.4.1.zip
+  24. http://tex.aanhet.net/epspdf/epspdf.0.4.1.tgz
+  25. http://tex.aanhet.net/epspdf/epspdf.pdf
+  26. http://tex.aanhet.net/epspdf/epspdf.0.4.1.tgz
+  27. http://tex.aanhet.net/epspdf/epspdf.0.4.1.zip
+  28. http://tex.aanhet.net/epspdf/epspdf.0.4.1.exe
+  29. http://tex.aanhet.net/epspdf/epspdftk.0.4.1.dmg.gz
+  30. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
+  31. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
+  32. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
+  33. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
+  34. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
+  35. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
+  36. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz
+  37. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip
+  38. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe
+  39. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
+  40. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
+  41. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
+  42. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
index 9ac30cf1cf0..69485d0a314 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.texi b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
index 284b106bdd7..6bbb50f9456 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.texi
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
@@ -21,7 +21,7 @@
 @raggedbottom
 @end iftex
 
-@set version 0.4.0
+@set version 0.4.1
 @set homepage http://tex.aanhet.net/epspdf/
 
 @setchapternewpage off
@@ -63,6 +63,7 @@ notice are preserved.
 * Usage::
 * Command-line usage::
 * Notes on PostScript and pdf::
+* Bitmapped graphics for @LaTeX{} and pdflatex::
 * Troubleshooting::
 * Changes in version 0.4::
 
@@ -90,6 +91,16 @@ Notes on PostScript and pdf
 * Orientation::
 * Exporting PostScript from Windows programs::
 
+Bitmapped graphics for @LaTeX{} and pdflatex
+
+* Linux::
+* Mac OS X::
+* Windows::
+
+Windows
+
+* GUI use of sam2p and bmeps::
+
 Troubleshooting
 
 * Grayscaling fails::
@@ -273,9 +284,9 @@ The summary below is the output of a command @kbd{epspdf --help}
 for help.
 @example
 $ epspdf --help
-Epspdf version 0.4.0
+Epspdf version 0.4.1
 Copyright (C) 2006, 2008, 2009 Siep Kroonenberg
-Epspdf 0.4.0
+Epspdf 0.4.1
 Convert between [e]ps and pdf formats
 Usage: epspdf.rb [options] infile [outfile]
 Default for outfile is file.pdf if infile is file.eps or file.ps
@@ -419,6 +430,78 @@ uses a printer driver in the background. For faithful conversion,
 pick wmf2eps; for subsequent editing, choose TpX. Both programs are
 available from @url{http://www.tug.org/ctan.html}.
 
+@node Bitmapped graphics for @LaTeX{} and pdflatex
+@chapter Bitmapped graphics for @LaTeX{} and pdflatex
+
+pdflatex can use graphics in .png format (best for screenshots) and .jpg
+format (best for photographs) directly. However, for @LaTeX{} you are
+stuck with .eps format. Tips for converting to .eps:
+
+@menu
+* Linux::
+* Mac OS X::
+* Windows::
+@end menu
+
+@node Linux
+@section Linux
+
+@table @emph
+@item ImageMagick/convert
+@command{convert} from the ImageMagick package is a command-line
+utility: @samp{convert image.png image.eps}
+@item The GIMP
+This is the premier open source image editing program. It is often
+pre-installed on Linux, and is also available for other platforms. The
+GIMP can save in eps format.
+@end table
+
+@node Mac OS X
+@section Mac OS X
+
+Mac OS X's built-in Preview application can read most bitmapped formats
+and save them as .pdf, which epspdf can convert to .eps.
+
+@node Windows
+@section Windows
+
+Windows is not a particularly friendly environment for PostScript and
+pdf. A couple of command-line utilities try to fill the gap, @emph{e.g.}
+@example
+sam2p image.png image.eps
+@end example
+or
+@example
+bmeps -c image.png image.eps
+@end example
+sam2p is distributed with TeX Live, bmeps both with TeX Live and with
+MikTeX. Without the @code{-c} option, bmeps produces a grayscale
+image. It produces larger files than sam2p.
+
+@menu
+* GUI use of sam2p and bmeps::
+@end menu
+
+@node GUI use of sam2p and bmeps
+@subsection GUI use of sam2p and bmeps
+
+Create a batchfile @file{bitmap2eps.bat} with contents
+@verbatim
+sam2p "%~1" "%~dpn1.eps"
+@end verbatim
+(TeX Live) or
+@verbatim
+bmeps -c "%~1" "%~dpn1.eps"
+@end verbatim
+(MikTeX) and place it @emph{e.g.} on your desktop. Now if you drop a
+bitmapped graphic on this batchfile then you will get an eps file with
+the same name as the original, but with extension @code{.eps}.
+
+You can also right-click on a bitmap, choose @emph{Open With...} and
+browse to this file bitmap2eps.bat, resulting in conversion to .eps. The
+next time you do this with a file of the same type, bitmap2eps.bat will
+already be in the list of possible programs for opening the file.
+
 @node Troubleshooting
 @chapter Troubleshooting
 
diff --git a/Master/texmf-dist/doc/support/epspdf/index.html b/Master/texmf-dist/doc/support/epspdf/index.html
index f1a02ef4db2..4480eb82696 100644
--- a/Master/texmf-dist/doc/support/epspdf/index.html
+++ b/Master/texmf-dist/doc/support/epspdf/index.html
@@ -229,14 +229,14 @@ installation. See the table below:</p>
 
 <h3>Windows setup program</h3>
 
-<p>Download the <a href="epspdf.0.3.0.exe">epspdftk setup
+<p>Download the <a href="epspdf.0.4.1.exe">epspdftk setup
 program.</a> You can run it in the usual way, by double-clicking. The
 setup program will create entries in your start menu for epspdftk
 and for the user manual.</p>
 
 <h3>Windows zipfile</h3>
 
-<p>Download the <a href="epspdf.0.3.0.zip">epspdf zip file</a>,
+<p>Download the <a href="epspdf.0.4.1.zip">epspdf zip file</a>,
 unpack it somewhere and create a shortcut for epspdftk.rbw. If you
 plan to use the command-line version, put a batchfile in a directory
 on your path with the line</p>
@@ -255,7 +255,7 @@ Windows Vista.</p>
 
 <h3>Unix/Linux</h3>
 
-<p>Download the <a href="epspdf.0.3.0.tgz">tar.gz archive</a> and
+<p>Download the <a href="epspdf.0.4.1.tgz">tar.gz archive</a> and
 unpack it in some directory. All files should be in the same
 directory; that is how they find each other. If you plan to use
 epspdf.rb from the command-line, then create a shell script
@@ -274,15 +274,13 @@ browser.</p>
 
 <h3>Mac OS X</h3>
 
-<p>Install as for Unix/Linux. Here, too, all files should be in the
-same directory.</p>
+<p>You can install as for Unix/Linux. Here, too, all files should be
+in the same directory.</p>
 
-<p>You can try to start epspdftk.rb from the dock or by
-doubleclicking. If that doesn't work out, give the <a
-href="epspdf_app.0.2.01.zip">epspdf.app</a> applet a try. After
-unpacking, move the file <tt>epspdf.app</tt> to the same directory
-as the .rb files. The zipfile also includes this file in text format
-(<tt>epspdf.applescript</tt>).</p>
+<p>There is also a compressed disk image epspdf.x.x.x.dmg.gz which
+wraps epspdftk into a Max OS X <q>app</q>. Double-click once to
+expand, a second time to mount, then drag epspdftk.app to the
+Applications folder.</p>
 
 <p>Epspdf mostly duplicates functionality of Preview. But having an
 alternate conversion engine means that you can have another shot at
@@ -314,17 +312,17 @@ usually Preview or Adobe Reader.</p>
 <h2><a name="files"/>Files</h2>
 
 <ul>
-<li><a href="epspdf.0.4.0.tgz">epspdf.0.4.0.tgz</a> preferred for Unix
+<li><a href="epspdf.0.4.1.tgz">epspdf.0.4.1.tgz</a> preferred for Unix
 and Mac OS X</li>
 
-<li><a href="epspdf.0.4.0.zip">epspdf.0.4.0.zip</a> preferred for
+<li><a href="epspdf.0.4.1.zip">epspdf.0.4.1.zip</a> preferred for
 Windows</li>
 
-<li><a href="epspdf.0.4.0.exe">epspdf.0.4.0.exe</a> Windows setup
+<li><a href="epspdf.0.4.1.exe">epspdf.0.4.1.exe</a> Windows setup
   program, including Ruby/Tk subset</li>
 
-<li><a href="epspdf_app.0.2.01.zip">epspdf_app.0.2.01.zip</a> Mac OS X
-applet for starting epspdftk.rb</li>
+<li><a href="epspdftk.0.4.1.dmg.gz">epspdftk.0.4.1.dmg.gz</a>
+  compressed disk image with epspdftk wrapped into a Mac OS X <q>app</q></li>
 </ul>
 
 <h3>Older releases</h3>
@@ -353,54 +351,61 @@ Windows</li>
  Windows</li>
 <li><a href="epspdf.0.2.exe">epspdf.0.2.exe</a>, Windows setup
  program</li>
+
+<li><a href="epspdf_app.0.2.01.zip">epspdf_app.0.2.01.zip</a> Mac OS X
+applet for starting epspdftk.rb</li>
 </ul>
 
 <h2><a name="releases"/>Releases</h2>
 
-<dl> <dt>0.4.0</dt><dd>Current version. Optionally uses hires
-  boundingbox. Faster startup due to simpler testing of
-  prerequisites. Grayscaling: support for HSB color model, although
-  I yet have to encounter a PostScript file using this. Manual
-  converted to texinfo format. Windows: new <q>View with...</q>
-  button; support for MikTeX's built-in Ghostscript; streamlined
-  Ruby subset, with Tcl/Tk compiled from source.</dd>
+<dl><dt>0.4.1</dt><dd>Current version. Documentation: added section
+  on bitmaps. Windows setup program: added missing Tcl/Tk
+  licenses. Mac: double-clickable epspdftk.app with included
+  epspdftk replaces double-clickable epspdf.app add-on.</dd>
+
+<dt>0.4.0</dt><dd>Optionally uses hires boundingbox. Faster startup
+  due to simpler testing of prerequisites. Grayscaling: support for
+  HSB color model, although I yet have to encounter a PostScript
+  file using this. Manual converted to texinfo format. Windows: new
+  <q>View with...</q> button; support for MikTeX's built-in
+  Ghostscript; streamlined Ruby subset, with Tcl/Tk compiled from
+  source.</dd>
 
 <dt>0.3.0</dt><dd>Under Windows, now recognizes whether it is
-embedded in TeX Live 2008 and then can use ghostscript/pdftops from
-TeX Live. Also added TeX Live wrapper scripts. Uninstaller for
-Windows setup program. Bug fixes: now accepts non-numerical version
-strings for pdftops. No longer checks for viewers under Mac OS
-X.</dd>
-
-<dt>0.2.12</dt><dd>Bug fixes: log rotation now
-works. Under Windows, sometimes boundingboxes couldn't be
-calculated. This was caused by double quotes within backquotes. This
-is now avoided by using short filenames within backquotes. Minor
-changes in user guide.</dd>
+  embedded in TeX Live 2008 and then can use ghostscript/pdftops
+  from TeX Live. Also added TeX Live wrapper scripts. Uninstaller
+  for Windows setup program. Bug fixes: now accepts non-numerical
+  version strings for pdftops. No longer checks for viewers under
+  Mac OS X.</dd>
+
+<dt>0.2.12</dt><dd>Bug fixes: log rotation now works. Under Windows,
+  sometimes boundingboxes couldn't be calculated. This was caused by
+  double quotes within backquotes. This is now avoided by using
+  short filenames within backquotes. Minor changes in user
+  guide.</dd>
 
 <dt>0.2.11</dt><dd> Minor fixes. Changes in documentation.</dd>
 
 <dt>0.2.10</dt><dd>A computed boundingbox is now expanded by one
-point in all directions. This should prevent too-tight
-cropping. There is no interface for changing this amount; it can
-only be changed by hand-editing the bb_spread
-option in the .epspdfrc file or in the HKCU\software\epspdf registry
-key.</dd> <dd>The File Open dialog remembers the last directory
-visited (between calls, not between program
-sessions).</dd><dd>Changes in documentation.</dd>
+  point in all directions. This should prevent too-tight
+  cropping. There is no interface for changing this amount; it can
+  only be changed by hand-editing the bb_spread option in the
+  .epspdfrc file or in the HKCU\software\epspdf registry key.</dd>
+  <dd>The File Open dialog remembers the last directory visited
+  (between calls, not between program sessions).</dd><dd>Changes in
+  documentation.</dd>
 
 <dt>0.2.01</dt><dd>Fixes to the Applescript applet epspdf.app for
-starting up epspdftk under Mac OS X. It picks up the terminal search
-path and no longer requires correct settings in
-$HOME/.MacOSX/environment.plist. Epspdf.app is now
-packaged separately, under Mac OS
-X, and now has an intact resource fork. It has been removed from the
-other archives.</dd>
+  starting up epspdftk under Mac OS X. It picks up the terminal
+  search path and no longer requires correct settings in
+  $HOME/.MacOSX/environment.plist. Epspdf.app is now packaged
+  separately, under Mac OS X, and now has an intact resource
+  fork. It has been removed from the other archives.</dd>
 
 <dt>0.2</dt><dd>Original release</dd>
 </dl>
 
 <hr/>
 
-<p class="fineprint">Last revised: February 29, 2009</p>
+<p class="fineprint">Last revised: March 12, 2009</p>
 </body></html>