From 16421eb2aea0392d27dc7ed55006cfffaed04d4c Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 12 Nov 2018 05:44:06 +0000 Subject: update a2ping.pl and .1 for fixes git-svn-id: svn://tug.org/texlive/trunk@49136 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/a2ping.1 | 164 +++++++++++++++-------------- Master/texmf-dist/scripts/a2ping/a2ping.pl | 15 ++- 2 files changed, 100 insertions(+), 79 deletions(-) (limited to 'Master') 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 [B<-->]B - B [B<-->]B - B [I] > [[I:] I] + \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 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 delegates the low-level work to -Ghostscript (GS), B and B. B 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 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 is missing from the command line: then the -extension of the output file determines the FileFormat (I). +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 is PS/EPS. Everything read is -first converted to PS or EPS, then processed by B, 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 from the B package is used. -Sampled input formats are PNG, JPEG, TIFF, PNM, BMP, GIF, LBM, XPM, PCX -and TGA. To read sampled input formats, B is used. B is -a raster image converter written in C++ by the author of B. -Extra output formats are PNG, XWD, BMP, TIFF, JPEG, GIF and XPM. To -write extra output formats, B 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 =I =I) (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 is Péter Szabó >. -B is inspired by and historically based on the B 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, and also B and B do not -share common code anymore. B is written by Sebastian Rahtz, -for Elsevier Science. B 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 contains contributions from several people, see the file -F 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! diff --git a/Master/texmf-dist/scripts/a2ping/a2ping.pl b/Master/texmf-dist/scripts/a2ping/a2ping.pl index 0da2e4344e2..2f1a3bda4f8 100755 --- a/Master/texmf-dist/scripts/a2ping/a2ping.pl +++ b/Master/texmf-dist/scripts/a2ping/a2ping.pl @@ -2277,6 +2277,8 @@ just::end __END__ Dat: `=item * foo' is wrong, puts big space between `*' and `foo' +=encoding latin1 + =begin man .ds pts-dev \*[.T] @@ -2293,7 +2295,7 @@ Dat: `=item * foo' is wrong, puts big space between `*' and `foo' .\} .ad n -=end +=end man =head1 NAME @@ -2377,8 +2379,12 @@ Show the man page Show progress and debug messages (default: no) +=back + =head2 Options for the Bounding box +=over 2 + =item B<--(no)hires> Use HiResBoundingBox in the input file, if present (default: yes) @@ -2399,9 +2405,12 @@ Method for determining the BoundingBox (default: guess) Allow page content below and left of the origin (default: no) +=back =head2 Options for graphics and fonts +=over 2 + =item B<--(no)compress> use compression (default: best) @@ -2422,9 +2431,12 @@ allow lossy image filters (EPS->PDF) (default: yes) min color for 1 in 8->1 bit conv (default: 128) +=back =head2 Options for debugging and changing internals +=over 2 + =item B<--(no)tmpunlink> Unlink temporary files (default: yes). Use B<--notmpunklink> if you @@ -2446,6 +2458,7 @@ Pass extra arguments to gs Pass extra arguments to external program (i.e pdftops) +=back =head1 TIPS AND TRICKS -- cgit v1.2.3