summaryrefslogtreecommitdiff
path: root/Build/source
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-04-28 23:23:09 +0000
committerKarl Berry <karl@freefriends.org>2011-04-28 23:23:09 +0000
commite0b6081ab0d1e54e5b121b8f384619605f0586b2 (patch)
tree2baf30bd33e92695eb7983d0a3b9718e5997f07a /Build/source
parent89ceb55bc96c0d36600b617ba97186294acfaa06 (diff)
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
Diffstat (limited to 'Build/source')
-rw-r--r--Build/source/texk/dvipdfmx/dvipdfmx-20110309/man/extractbb.15
-rw-r--r--Build/source/texk/dvipdfmx/man/dvipdfm.153
2 files changed, 47 insertions, 11 deletions
diff --git a/Build/source/texk/dvipdfmx/dvipdfmx-20110309/man/extractbb.1 b/Build/source/texk/dvipdfmx/dvipdfmx-20110309/man/extractbb.1
index 491dff5d8b1..d6d98af5d8c 100644
--- a/Build/source/texk/dvipdfmx/dvipdfmx-20110309/man/extractbb.1
+++ b/Build/source/texk/dvipdfmx/dvipdfmx-20110309/man/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/Build/source/texk/dvipdfmx/man/dvipdfm.1 b/Build/source/texk/dvipdfmx/man/dvipdfm.1
index ba892a7f82d..eb12d084068 100644
--- a/Build/source/texk/dvipdfmx/man/dvipdfm.1
+++ b/Build/source/texk/dvipdfmx/man/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.