summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/extractbb.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-09-05 00:14:55 +0000
committerKarl Berry <karl@freefriends.org>2009-09-05 00:14:55 +0000
commitf42adfd25798b5e894d60779508f5293e232c15e (patch)
tree00a1e18f378a4aa17dd54d6adb9c3d0fd9645b1e /Master/texmf/doc/man/man1/extractbb.1
parent1d5c20dec6c61aebc38aca15080ae3ce635e3d51 (diff)
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
Diffstat (limited to 'Master/texmf/doc/man/man1/extractbb.1')
-rw-r--r--Master/texmf/doc/man/man1/extractbb.183
1 files changed, 83 insertions, 0 deletions
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\&.