summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2018-11-12 05:44:06 +0000
committerNorbert Preining <preining@logic.at>2018-11-12 05:44:06 +0000
commit16421eb2aea0392d27dc7ed55006cfffaed04d4c (patch)
tree7be878e5cb86c2e9d8b9b12264347044bc2e2a2f /Master/texmf-dist/doc/man
parent19cec67e773a35a5e840199646cf194521cba099 (diff)
update a2ping.pl and .1 for fixes
git-svn-id: svn://tug.org/texlive/trunk@49136 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r--Master/texmf-dist/doc/man/man1/a2ping.1164
1 files changed, 86 insertions, 78 deletions
diff --git a/Master/texmf-dist/doc/man/man1/a2ping.1 b/Master/texmf-dist/doc/man/man1/a2ping.1
index 5ff108e436f..c471b40c32c 100644
--- a/Master/texmf-dist/doc/man/man1/a2ping.1
+++ b/Master/texmf-dist/doc/man/man1/a2ping.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
+.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -54,16 +54,20 @@
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
-.if !\nF .nr F 0
-.if \nF>0 \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{\
+. if \nF \{\
+. de IX
+. tm Index:\\$1\t\\n%\t"\\$2"
..
-. if !\nF==2 \{\
-. nr % 0
-. nr F 2
+. if !\nF==2 \{\
+. nr % 0
+. nr F 2
+. \}
. \}
.\}
+.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
@@ -129,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "A2PING 1"
-.TH A2PING 1 "2018-03-08" "a2ping" "Peter Szabo"
+.TH A2PING 1 "2018-11-12" "a2ping" "Peter Szabo"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -148,53 +152,63 @@
.\}
.ad n
.SH "NAME"
-a2ping.pl -- convert between PS, EPS and PDF and other page description
+a2ping.pl \-\- convert between PS, EPS and PDF and other page description
formats
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
-Z<> B<a2ping.pl> [B<-->]B<help>
- B<a2ping.pl> [B<-->]B<doc>
- B<a2ping.pl> [I<options>] <I<inputfile>> [[I<outformat>:] I<outputfile>]
+ \fBa2ping.pl\fR [\fB\-\-\fR]\fBhelp\fR
+ \fBa2ping.pl\fR [\fB\-\-\fR]\fBdoc\fR
+ \fBa2ping.pl\fR [\fIoptions\fR] <\fIinputfile\fR> [[\fIoutformat\fR:] \fIoutputfile\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
-B<a2ping> is a UNIX command line utility written in Perl that
-converts many raster image and vector graphics formats to EPS or PDF and
-other page description formats. Accepted input file formats are: PS
-(PostScript), EPS, PDF, PNG, JPEG, TIFF, PNM, BMP, GIF, LBM, XPM, PCX,
-TGA. Accepted output formats are: EPS, PCL5, PDF, PDF1, PBM, PGM, PPM,
-PS, markedEPS, markedPS, PNG, XWD, BMP, TIFF, JPEG, GIF, XPM.
-B<a2ping> delegates the low-level work to
-Ghostscript (GS), B<pdftops> and B<sam2p>. B<a2ping> fixes many glitches
-during the EPS to EPS conversion, so its output is often more compatible
+\&\fBa2ping\fR is a \s-1UNIX\s0 command line utility written in Perl that
+converts many raster image and vector graphics formats to \s-1EPS\s0 or \s-1PDF\s0 and
+other page description formats. Accepted input file formats are: \s-1PS\s0
+(PostScript), \s-1EPS, PDF, PNG, JPEG, TIFF, PNM, BMP, GIF, LBM, XPM, PCX,
+TGA.\s0 Accepted output formats are: \s-1EPS, PCL5, PDF, PDF1, PBM, PGM, PPM,
+PS,\s0 markedEPS, markedPS, \s-1PNG, XWD, BMP, TIFF, JPEG, GIF, XPM.\s0
+\&\fBa2ping\fR delegates the low-level work to
+Ghostscript (\s-1GS\s0), \fBpdftops\fR and \fBsam2p\fR. \fBa2ping\fR fixes many glitches
+during the \s-1EPS\s0 to \s-1EPS\s0 conversion, so its output is often more compatible
and better embeddable than its input.
-Without the C<--below> option, it is guarenteed to start at the 0,0
-coordinate. C<--below>, C<--hires> and C<-v> are recommended options.
+.PP
+Without the \f(CW\*(C`\-\-below\*(C'\fR option, it is guarenteed to start at the 0,0
+coordinate. \f(CW\*(C`\-\-below\*(C'\fR, \f(CW\*(C`\-\-hires\*(C'\fR and \f(CW\*(C`\-v\*(C'\fR are recommended options.
+.PP
The page size is set exactly corresponding to the BoundingBox.
This means that when Ghostscript renders it, the result needs no
-cropping, and the PDF MediaBox is correct.
+cropping, and the \s-1PDF\s0 MediaBox is correct.
+.PP
If the bounding box is not right, of course, you have problems. If you
feed crap in, you get crap. But you can supply the
-B<--bboxfrom=compute-gs> option to make GS recompute the bounding box.
-The name of the input file doesn't matter -- B<a2ping> detects the file
+\&\fB\-\-bboxfrom=compute\-gs\fR option to make \s-1GS\s0 recompute the bounding box.
+.PP
+The name of the input file doesn't matter \*(-- \fBa2ping\fR detects the file
format based on the first few bytes of the file. The name of the output
-file matters if I<outformat> is missing from the command line: then the
-extension of the output file determines the FileFormat (I<outformat>).
+file matters if \fIoutformat\fR is missing from the command line: then the
+extension of the output file determines the FileFormat (\fIoutformat\fR).
.SH "EXTERNAL PROGRAMS"
.IX Header "EXTERNAL PROGRAMS"
-The internal file format of B<a2ping.pl> is PS/EPS. Everything read is
-first converted to PS or EPS, then processed by B<a2ping.pl>, then
+The internal file format of \fBa2ping.pl\fR is \s-1PS/EPS.\s0 Everything read is
+first converted to \s-1PS\s0 or \s-1EPS,\s0 then processed by \fBa2ping.pl\fR, then
converted to the output format.
-To analyse the bounding box and other properties of non-EPS PS files
-(and EPS files with option B<--bboxfrom> other than B<=guess>), GS is
-used. Converting PS to EPS involves this analysis.
-To write PDF files, GS is used.
-To read PDF files, B<pdftops> from the B<xpdf> package is used.
-Sampled input formats are PNG, JPEG, TIFF, PNM, BMP, GIF, LBM, XPM, PCX
-and TGA. To read sampled input formats, B<sam2p> is used. B<sam2p> is
-a raster image converter written in C++ by the author of B<a2ping.pl>.
-Extra output formats are PNG, XWD, BMP, TIFF, JPEG, GIF and XPM. To
-write extra output formats, B<sam2p> and GS are used.
-PNM output formats are PGM, PGM and PPM. To write PNM output formats, GS
+.PP
+To analyse the bounding box and other properties of non-EPS \s-1PS\s0 files
+(and \s-1EPS\s0 files with option \fB\-\-bboxfrom\fR other than \fB=guess\fR), \s-1GS\s0 is
+used. Converting \s-1PS\s0 to \s-1EPS\s0 involves this analysis.
+.PP
+To write \s-1PDF\s0 files, \s-1GS\s0 is used.
+.PP
+To read \s-1PDF\s0 files, \fBpdftops\fR from the \fBxpdf\fR package is used.
+.PP
+Sampled input formats are \s-1PNG, JPEG, TIFF, PNM, BMP, GIF, LBM, XPM, PCX\s0
+and \s-1TGA.\s0 To read sampled input formats, \fBsam2p\fR is used. \fBsam2p\fR is
+a raster image converter written in \*(C+ by the author of \fBa2ping.pl\fR.
+.PP
+Extra output formats are \s-1PNG, XWD, BMP, TIFF, JPEG, GIF\s0 and \s-1XPM.\s0 To
+write extra output formats, \fBsam2p\fR and \s-1GS\s0 are used.
+.PP
+\&\s-1PNM\s0 output formats are \s-1PGM, PGM\s0 and \s-1PPM.\s0 To write \s-1PNM\s0 output formats, \s-1GS\s0
is used.
.SH "OPTIONS"
.IX Header "OPTIONS"
@@ -203,72 +217,64 @@ is used.
.IP "\fB\-h\fR, \fB\-\-help\fR" 2
.IX Item "-h, --help"
Show a summary of the usage
-.PD 0
.IP "\fB\-\-doc\fR" 2
.IX Item "--doc"
Show the man page
.IP "\fB\-v\fR, \fB\-\-(no)verbose\fR" 2
.IX Item "-v, --(no)verbose"
Show progress and debug messages (default: no)
-.PD
.SS "Options for the Bounding box"
.IX Subsection "Options for the Bounding box"
-.IP "\fB\-\-(no)hires\fR" 4
+.IP "\fB\-\-(no)hires\fR" 2
.IX Item "--(no)hires"
Use HiResBoundingBox in the input file, if present (default: yes)
-.PD 0
-.IP "\fB\-\-(no)exact\fR" 4
+.IP "\fB\-\-(no)exact\fR" 2
.IX Item "--(no)exact"
Use ExactBoundingBox in the input file, if present (default: no)
-.IP "\fB\-\-(no)keepoldmediabox\fR" 4
+.IP "\fB\-\-(no)keepoldmediabox\fR" 2
.IX Item "--(no)keepoldmediabox"
-keep only old, [0 0]-based MediaBox in PDF (default: no)
-.IP "\fB\-\-bboxfrom=\fR\fIadsc|compute\-gs|guess|pagesize\fR" 4
+keep only old, [0 0]\-based MediaBox in \s-1PDF\s0 (default: no)
+.IP "\fB\-\-bboxfrom=\fR\fIadsc|compute\-gs|guess|pagesize\fR" 2
.IX Item "--bboxfrom=adsc|compute-gs|guess|pagesize"
Method for determining the BoundingBox (default: guess)
-.IP "\fB\-\-(no)below\fR" 4
+.IP "\fB\-\-(no)below\fR" 2
.IX Item "--(no)below"
Allow page content below and left of the origin (default: no)
-.PD
.SS "Options for graphics and fonts"
.IX Subsection "Options for graphics and fonts"
-.IP "\fB\-\-(no)compress\fR" 4
+.IP "\fB\-\-(no)compress\fR" 2
.IX Item "--(no)compress"
use compression (default: best)
-.PD 0
-.IP "\fB\-\-(no)antialias\fR" 4
+.IP "\fB\-\-(no)antialias\fR" 2
.IX Item "--(no)antialias"
-render shades at outlines. Possible values: (=I<scale3yes> =I<no> =I<yes>) (default: scale3no)
-.IP "\fB\-\-(no)lossy\fR" 4
+render shades at outlines. Possible values: (=\fIscale3yes\fR =\fIno\fR =\fIyes\fR) (default: scale3no)
+.IP "\fB\-\-(no)lossy\fR" 2
.IX Item "--(no)lossy"
-allow lossy image filters (EPS->PDF) (default: yes)
-.IP "\fB\-\-papersize=\fR\fIunchanged|force\-unknown|600bpx5cm\fR" 4
+allow lossy image filters (\s-1EPS\-\s0>\s-1PDF\s0) (default: yes)
+.IP "\fB\-\-papersize=\fR\fIunchanged|force\-unknown|600bpx5cm\fR" 2
.IX Item "--papersize=unchanged|force-unknown|600bpx5cm"
(default: default) (bp)
-.IP "\fB\-\-threshold=\fR" 4
+.IP "\fB\-\-threshold=\fR" 2
.IX Item "--threshold="
-min color for 1 in 8->1 bit conv (default: 128)
-.PD
+min color for 1 in 8\->1 bit conv (default: 128)
.SS "Options for debugging and changing internals"
.IX Subsection "Options for debugging and changing internals"
-.IP "\fB\-\-(no)tmpunlink\fR" 4
+.IP "\fB\-\-(no)tmpunlink\fR" 2
.IX Item "--(no)tmpunlink"
-Unlink temporary files (default: yes). Use B<--notmpunklink> if you
+Unlink temporary files (default: yes). Use \fB\-\-notmpunklink\fR if you
want to inspect intermediate files.
-.PD 0
-.IP "\fB\-\-gs\-cmd=\fR\fIpath\fR" 4
+.IP "\fB\-\-gs\-cmd=\fR\fIpath\fR" 2
.IX Item "--gs-cmd=path"
path to Ghostscript program (default: gs or gswin32c)
-.IP "\fB\-\-gs\-ccmd=\fR\fIpath\fR" 4
+.IP "\fB\-\-gs\-ccmd=\fR\fIpath\fR" 2
.IX Item "--gs-ccmd=path"
path to Ghostscript for BoundingBox calculation (default: gs or gswin32c)
-.IP "\fB\-\-gsextra=\fR\fI\s-1GS_ARGS\s0\fR" 4
+.IP "\fB\-\-gsextra=\fR\fI\s-1GS_ARGS\s0\fR" 2
.IX Item "--gsextra=GS_ARGS"
Pass extra arguments to gs
-.IP "\fB\-\-extra=\fR" 4
+.IP "\fB\-\-extra=\fR" 2
.IX Item "--extra="
Pass extra arguments to external program (i.e pdftops)
-.PD
.SH "TIPS AND TRICKS"
.IX Header "TIPS AND TRICKS"
.IP "\(bu" 2
@@ -293,7 +299,7 @@ just run \f(CW\*(C`a2ping.pl foo.ps PDF: \- | a2ping.pl \- PS: foo.ps\*(C'\fR
.IP "\(bu" 2
If you have a \s-1PS\s0 coming from Win32 (often with extension \f(CW\*(C`.prn\*(C'\fR), run
it through \fBa2ping\fR. It will remove the resolution changes and the
-progress text printed to the terminal (which confuses \fIgv\fR\|(1) and makes
+progress text printed to the terminal (which confuses \fBgv\fR\|(1) and makes
some filters in the print queue emit incorrect output).
.IP "\(bu" 2
\&\fBa2ping\fR does antialiasing (\fB\-\-antialias=scale3no\fR) of glyphs and
@@ -336,12 +342,14 @@ Conversion from \s-1PDF\s0 to \s-1EPS:\s0 calls pdftops \-eps (of the xpdf packa
Conversion from \s-1PS\s0 to \s-1EPS:\s0 keeps 1st page only, removes setpagedevice etc.
.SH "AUTHORS"
.IX Header "AUTHORS"
-The author of B<a2ping> is Péter Szabó <F<pts@fazekas.hu>>.
-B<a2ping> is inspired by and historically based on the B<epstopdf> Perl
+The author of \fBa2ping\fR is Pe\*'ter Szabo\*' <\fIpts@fazekas.hu\fR>.
+.PP
+\&\fBa2ping\fR is inspired by and historically based on the \fBepstopdf\fR Perl
script modified by Thomas Esser, Sept. 1998, but his modifications have
-been removed from B<a2ping>, and also B<a2ping> and B<epstopdf> do not
-share common code anymore. B<epstopdf> is written by Sebastian Rahtz,
-for Elsevier Science. B<epstopdf> contained extra tricks from Hans Hagen's
+been removed from \fBa2ping\fR, and also \fBa2ping\fR and \fBepstopdf\fR do not
+share common code anymore. \fBepstopdf\fR is written by Sebastian Rahtz,
+for Elsevier Science. \fBepstopdf\fR contained extra tricks from Hans Hagen's
texutil.
-B<a2ping> contains contributions from several people, see the file
-F<HISTORY.txt> for details. Thank you all for contributing!
+.PP
+\&\fBa2ping\fR contains contributions from several people, see the file
+\&\fI\s-1HISTORY\s0.txt\fR for details. Thank you all for contributing!