Update to v. 0.4.1: documentation update

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

2 files changed, 63 insertions, 10 deletions

diff --git a/Master/texmf-dist/scripts/epspdf/epspdf.help b/Master/texmf-dist/scripts/epspdf/epspdf.help
index f7d37ff3c2c..2ad5ab13ddc 100644
--- a/Master/texmf-dist/scripts/epspdf/epspdf.help
+++ b/Master/texmf-dist/scripts/epspdf/epspdf.help
@@ -1,7 +1,7 @@
 Epspdf and epsdftk
 ******************
 
-This manual is for epspdf, version 0.4.0.
+This manual is for epspdf, version 0.4.1.
 
 Copyright (C) 2006, 2007, 2008, 2009 Siep Kroonenberg.
 
@@ -158,9 +158,9 @@ Basic usage:
 
 The summary below is the output of a command `epspdf --help' for help.
      $ 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
@@ -291,17 +291,70 @@ printer driver in the background. For faithful conversion, pick
 wmf2eps; for subsequent editing, choose TpX. Both programs are
 available from `http://www.tug.org/ctan.html'.
 
-4 Troubleshooting
+4 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:
+
+4.1 Linux
+=========
+
+_ImageMagick/convert_
+     `convert' from the ImageMagick package is a command-line utility:
+     `convert image.png image.eps'
+
+_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.
+
+4.2 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.
+
+4.3 Windows
+===========
+
+Windows is not a particularly friendly environment for PostScript and
+pdf. A couple of command-line utilities try to fill the gap, _e.g._
+     sam2p image.png image.eps
+or
+     bmeps -c image.png image.eps
+sam2p is distributed with TeX Live, bmeps both with TeX Live and with
+MikTeX. Without the `-c' option, bmeps produces a grayscale image. It
+produces larger files than sam2p.
+
+4.3.1 GUI use of sam2p and bmeps
+--------------------------------
+
+Create a batchfile `bitmap2eps.bat' with contents
+sam2p "%~1" "%~dpn1.eps"
+ (TeX Live) or
+bmeps -c "%~1" "%~dpn1.eps"
+ (MikTeX) and place it _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 `.eps'.
+
+You can also right-click on a bitmap, choose _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.
+
+5 Troubleshooting
 *****************
 
-4.1 Grayscaling fails
+5.1 Grayscaling fails
 =====================
 
 See above, under *note Grayscaling: gray. Epspdf is limited by what can
 be done by the backend tools, i.e. Ghostscript and pdftops. In
 particular, epspdf cannot grayscale bitmapped data.
 
-4.2 Part of the graphic gets cut off
+5.2 Part of the graphic gets cut off
 ====================================
 
 Things to try:
@@ -317,7 +370,7 @@ Things to try:
      high-resolutuion boundingbox. Command-line option: "-n" or
      "-no-hires".
 
-4.3 Fonts look ugly
+5.3 Fonts look ugly
 ===================
 
 If Ghostscript has to do the conversion from pdf to ps then text will
@@ -325,7 +378,7 @@ not remain text, but will be replaced by drawn shapes or bitmaps. Try
 to get hold of the xpdf suite, which includes pdftops, especially if
 your files contain serious amount of text.
 
-4.4 Resources for troubleshooting
+5.4 Resources for troubleshooting
 =================================
 
 Logfile. Epspdf and epspdftk maintain a log file epspdf.log in your
@@ -349,7 +402,7 @@ important files are Ps2pdf.htm and Use.htm. For pdftops, type `pdftops
 -h'. For Unix, there is also a man page, and for Windows there is a
 file pdftops.txt in the distribution zip.
 
-5 Changes in version 0.4
+6 Changes in version 0.4
 ************************
 
 Hi-res boundingboxes are now supported. By default, conversion from eps
diff --git a/Master/texmf-dist/scripts/epspdf/epspdfrc.rb b/Master/texmf-dist/scripts/epspdf/epspdfrc.rb
index acdbd9ac5e4..9a4ae5998d5 100755
--- a/Master/texmf-dist/scripts/epspdf/epspdfrc.rb
+++ b/Master/texmf-dist/scripts/epspdf/epspdfrc.rb
@@ -1,4 +1,4 @@
-EPVERSION = '0.4.0'
+EPVERSION = '0.4.1'
 COPYRIGHT = '2006, 2008, 2009'
 
 # epspdf conversion utility, configuration module