From e0b6081ab0d1e54e5b121b8f384619605f0586b2 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 28 Apr 2011 23:23:09 +0000 Subject: 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 --- .../dvipdfmx/dvipdfmx-20110309/man/extractbb.1 | 5 +- Build/source/texk/dvipdfmx/man/dvipdfm.1 | 53 ++++++++++++++++++---- 2 files changed, 47 insertions(+), 11 deletions(-) (limited to 'Build/source') 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 - +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. -- cgit v1.2.3