explicitly discuss need to run ebb for dvipdfm bounding boxes, and extractbb for dvipdfmx

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

5 files changed, 47 insertions, 11 deletions

diff --git a/Master/texmf/doc/man/man1/dvipdfm.1 b/Master/texmf/doc/man/man1/dvipdfm.1
index ba892a7f82d..eb12d084068 100644
--- a/Master/texmf/doc/man/man1/dvipdfm.1
+++ b/Master/texmf/doc/man/man1/dvipdfm.1
@@ -10,9 +10,9 @@
 .sp
 .fi
 ..
-.TH dvipdfm 1 5/28/2001
+.TH "DVIPDFM" "1" "28 April 2011" "20110311" "DVIPDFMx"
 .SH NAME
-dvipdfm \- Produce PDF files directly from DVI files
+dvipdfm \- produce PDF files directly from DVI files
 
 .SH SYNOPSIS
 .B dvipdfm
@@ -21,6 +21,19 @@ dvipdfm \- Produce PDF files directly from DVI files
 .RB [ .dvi ]
 
 .SH DESCRIPTION
+In TeX Live,
+.B dvipdfm
+is another incarnation of
+.B dvipdfmx
+rather than a separate program.  Compatibility is attempted as best as
+possible.  (The change was made due to duplicated security and
+configuration issues arising repeatedly.)  Please report problems with
+this
+.B dvipdfm
+to the
+.B dvipdfmx
+maintainers at dvipdfmx (at) ktug.or.kr.
+
 The program
 .B dvipdfm
 generates a
@@ -65,10 +78,9 @@ Dvipdfm understands its own specific
 .B \especial
 commands to allow access to PDF features
 such as annotations and bookmarks.
-For more details, consult the 
-.I "Dvipdfm User's Manual,"
-which is distributed with
-.B dvipdfm.
+
+For issues related to bounding boxes (and hence image sizes), please see
+.BR extractbb (1).
 
 .SH OPTIONS
 
@@ -148,7 +160,7 @@ Select the papersize by name (e.g.,
 Set resolution of bitmapped fonts to
 .B size
 dots per inch.  Bitmapped fonts are generated
-by the Kpathsea library, which uses MetaFont.  Bitmapped
+by the Kpathsea library, which uses Metafont.  Bitmapped
 fonts are included as type 3 fonts in the PDF output file.
 
 .TP 5
@@ -257,6 +269,25 @@ Set the compression level to
 Compressions levels range from 0 (no compression) to
 9 (maximum compression) and correspond to the values understood by zlib.
 
+.SH "IMAGE BOUNDING BOXES"
+
+When including images with
+.BR dvipdfm ,
+their bounding boxes should be generated by running
+.BR ebb ,
+or extractbb -m.
+The result will be in an
+.B .bb
+file.
+
+When including images with 
+.BR dvipdfmx ,
+their bounding boxes should be generated by running
+.BR extractbb .
+The result will be in an
+.B .xbb
+file; the xbb information is the same as for the PDF format.
+
 .SH ENVIRONMENT
 
 .B Dvipdfm 
@@ -313,11 +344,15 @@ The location of this file may be found by typing
 
 
 .SH "SEE ALSO"
+.BR dvipdft "(1), "
 .BR tex "(1), " dvips "(1), " groff "(1), " grodvi "(1), " pic "(1), "
+.BR extractbb "(1), "
 and the
 .I "Kpathsea library"
 info documentation.
 
 .SH AUTHOR
-Mark A. Wicks <mwicks@kettering.edu>
-
+Mark A. Wicks.  But for the version in TeX Live, all bugs and other
+reports should go to the
+.B dvipdfmx
+maintainers at dvipdfmx (at) ktug.or.kr.
diff --git a/Master/texmf/doc/man/man1/dvipdfm.man1.pdf b/Master/texmf/doc/man/man1/dvipdfm.man1.pdf
index 33b0ecddbab..a089526d6e9 100644
--- a/Master/texmf/doc/man/man1/dvipdfm.man1.pdf
+++ b/Master/texmf/doc/man/man1/dvipdfm.man1.pdf
diff --git a/Master/texmf/doc/man/man1/ebb.man1.pdf b/Master/texmf/doc/man/man1/ebb.man1.pdf
index ec19a42446e..9e7a8b9a346 100644
--- a/Master/texmf/doc/man/man1/ebb.man1.pdf
+++ b/Master/texmf/doc/man/man1/ebb.man1.pdf
diff --git a/Master/texmf/doc/man/man1/extractbb.1 b/Master/texmf/doc/man/man1/extractbb.1
index 491dff5d8b1..d6d98af5d8c 100644
--- a/Master/texmf/doc/man/man1/extractbb.1
+++ b/Master/texmf/doc/man/man1/extractbb.1
@@ -1,4 +1,4 @@
-.TH "EXTRACTBB" "1" "30 August 2009" "20090708" "DVIPDFMx"
+.TH "EXTRACTBB" "1" "28 April 2011" "20110311" "DVIPDFMx"
 .PP 
 .SH "NAME" 
 extractbb, ebb \- extract bounding box information from graphics files
@@ -59,7 +59,8 @@ Write output to standard output.
 Write output in dvipdfm's ``bb'' format.
 .TP
 .B -x
-Write output in dvipdfmx's ``xbb'' format (default).
+Write output in dvipdfmx's ``xbb'' format (default), which is the same
+as that used by the PDF format.
 .PD
 .PP
 .SH "BUGS"
diff --git a/Master/texmf/doc/man/man1/extractbb.man1.pdf b/Master/texmf/doc/man/man1/extractbb.man1.pdf
index b90de0bc47e..49edf3de5fd 100644
--- a/Master/texmf/doc/man/man1/extractbb.man1.pdf
+++ b/Master/texmf/doc/man/man1/extractbb.man1.pdf