updated extractbb (aka ebb, for us) man page from Matthias Franz, mail to karl 30 Aug 2009 21:55:23

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

4 files changed, 84 insertions, 34 deletions

diff --git a/Master/texmf/doc/man/man1/ebb.1 b/Master/texmf/doc/man/man1/ebb.1
index 1a44ed97e20..76ef525ec91 100644
--- a/Master/texmf/doc/man/man1/ebb.1
+++ b/Master/texmf/doc/man/man1/ebb.1
@@ -1,34 +1 @@
-.TH "ebb" "1" "May 2004" "teTeX" "teTeX" 
-.PP 
-.SH "NAME" 
-ebb \- extract a bounding box from JPEG, PNG, and PDF files
-.PP 
-.SH "SYNOPSIS" 
-.PP 
-\fBebb\fP  [ \fI -v\fP | \fI-b\fP  ] \fI graphic_file\fP
-.PP 
-.SH "DESCRIPTION" 
-.PP 
-\fBebb\fP extracts the bounding box from JPEG, PNG, and PDF files
-(with lower- or uppercase extensions) and writes it into a file with
-the extension \fB.bb\fP, together with some header information. These
-files can then be used by \fBdvipdfm\fP or other programs.
-.PP
-.SH "OPTIONS" 
-.HP
-\fB\-v\fR : be verbose
-.HP
-\fB\-b\fR : Write .bb file in binary mode (has no effect on Linux and
-other systems conforming to POSIX).
-.HP
-.PP 
-.SH "AUTHOR" 
-.PP 
-\fBebb\fP was written by Mark A. Wicks.
-.PP 
-This manual page was written by Frank Küster <frank@kuesterei\&.ch>,
-for the Debian GNU/Linux system\&.  It may be used and modified by
-others without contacting the author\&.  Any mistakes or omissions in
-the manual page are my fault; inquiries about or corrections to this
-manual page should be directed to me (and not to the primary
-author)\&.
+.so man1/extractbb.1
diff --git a/Master/texmf/doc/man/man1/ebb.pdf b/Master/texmf/doc/man/man1/ebb.pdf
index 55cf3ea61aa..118b5e2cb4c 100644
--- a/Master/texmf/doc/man/man1/ebb.pdf
+++ b/Master/texmf/doc/man/man1/ebb.pdf
diff --git a/Master/texmf/doc/man/man1/extractbb.1 b/Master/texmf/doc/man/man1/extractbb.1
new file mode 100644
index 00000000000..0562fdf17b2
--- /dev/null
+++ b/Master/texmf/doc/man/man1/extractbb.1
@@ -0,0 +1,83 @@
+.TH "EXTRACTBB" "1" "30 August 2009" "20090708" "DVIPDFMx"
+.PP 
+.SH "NAME" 
+extractbb, ebb \- extract bounding box information from graphics files
+.PP 
+.SH "SYNOPSIS" 
+.PP
+.BR extractbb " [ " -v " | " -q " ] [ " -O " ] [ " -m " | " -x " ] "
+.I file ...
+.PP 
+.SH "DESCRIPTION" 
+.PP 
+For each
+.SM JPEG\c
+,
+.SM PNG\c
+, or
+.SM PDF
+file given on the command line,
+.B extractbb
+extracts the bounding box information and writes it into a file with extension
+.BR .xbb ,
+together with some header information. These files can then be used by
+.B dvipdfmx
+or other programs. For
+.SM PDF
+files, the number of pages and the
+.SM PDF
+version number are reported as well.
+The input filename extension may be in upper or lower case.
+.PP
+If called as
+.BR ebb ,
+the output is written in the ``bb'' format (and with extension
+.BR .bb )
+as used by
+.BR dvipdfm .
+.B Xbb
+may be defined as a synomym for
+.B extractbb
+on your system.
+.PP
+.SH "OPTIONS" 
+.PD 0
+.TP 10
+.B -v
+Be verbose.
+.TP
+.B -q
+Be quiet.
+.TP
+.B -O
+Write output to standard output.
+.TP
+.B -m
+Write output in dvipdfm's ``bb'' format.
+.TP
+.B -x
+Write output in dvipdfmx's ``xbb'' format (default).
+.PD
+.PP
+.SH "BUGS"
+.PP
+There is currently no way to specify which bounding box is taken
+for
+.SM PDF
+files. It will always be the first one from the following
+list: ArtBox, TrimBox, BleedBox, MediaBox. (Often only MediaBox
+is defined.) Moreover, the reported bounding box always refers
+to the first page in a
+.SM PDF
+file.
+.PP
+.SH "AUTHOR" 
+.PP 
+\fBextractbb\fP was written by the DVIPDFMx project team
+<dvipdfmx@ktug.or.kr>, based on the program \fBebb\fP by Mark A. Wicks.
+.PP 
+This manual page was also written by the DVIPDFMx project team,
+based on a manual page Frank K\[:u]ster <frank@kuesterei\&.ch>
+wrote for the Debian GNU/Linux system\&. 
+It may be used, modified, and/or redistributed by others without
+contacting the authors\&.
diff --git a/Master/texmf/doc/man/man1/extractbb.pdf b/Master/texmf/doc/man/man1/extractbb.pdf
new file mode 100644
index 00000000000..c25b212e9a0
--- /dev/null
+++ b/Master/texmf/doc/man/man1/extractbb.pdf