[gs-cvs] rev 8813 - trunk/gs/man

[giles at ghostscript.com]

Author: giles
Date: 2008-06-30 16:56:04 -0700 (Mon, 30 Jun 2008)
New Revision: 8813

Modified:
   trunk/gs/man/ps2pdf.1
Log:
Document the output filename behavior of ps2pdf in the manpage.
Bug 689920.


Modified: trunk/gs/man/ps2pdf.1
===================================================================
--- trunk/gs/man/ps2pdf.1	2008-06-30 23:16:45 UTC (rev 8812)
+++ trunk/gs/man/ps2pdf.1	2008-06-30 23:56:04 UTC (rev 8813)
@@ -19,6 +19,11 @@
 user interface) of Adobe's Acrobat(TM) Distiller(TM) product: they
 convert PostScript files to Portable Document Format (PDF) files. 
 .PP
+If the output filename is not specified, the output is placed is a file 
+of the same name with a '.pdf' extension. Either the input filename or
+the output filename can be '-' to request reading from stdin or writing
+to stdout, respectively, when used as a filter.
+.PP
 The three scripts differ as follows:
 .IP -
 .B ps2pdf12
@@ -28,8 +33,8 @@
 will always produce PDF 1.3 output (Acrobat 4-and-later compatible).
 .IP -
 .B ps2pdf
-per se currently produces PDF 1.2 output (Acrobat 3-and-later
-compatible). However, this may change in the future. If you care about
+per se currently produces PDF 1.4 output.
+However, this may change in the future. If you care about
 the compatibility level of the output, use
 .B ps2pdf12
 or
@@ -40,7 +45,30 @@
 .PP
 There are some limitations in
 .BR ps2pdf 's
-conversion. See the HTML documentation for more information.
+conversion. See the HTML documentation for more information. A large 
+number of Adobe Distiller(TM) parameters which can be used to control
+the conversion are also documented there, including instructions for 
+generating PDF/X and PDF/A documents.
+.SH EXAMPLES
+.LP
+Converting a figure.ps to figure.pdf:
+.IP
+.B ps2pdf
+.I figure.ps
+.LP
+A conversion with more specifics:
+.IP
+.B ps2pdf
+-dPDFSETTINGS=/prepress 
+.I figure.ps proof.pdf
+.LP
+Converting as part of a pipe:
+.IP
+.B make_report.pl 
+-t ps |
+.B ps2pdf
+-dCompatibility=1.3 - - |
+.B lpr
 .SH SEE ALSO
 gs(1), ps2pdfwr(1),
 .br