]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/ps2pdf
acme(1): remove references to awd
[plan9front.git] / sys / man / 1 / ps2pdf
1 .TH PS2PDF 1
2 .SH NAME
3 ps2pdf, pdf2ps \- convert between PostScript and PDF
4 .SH SYNOPSIS
5 .B ps2pdf
6 [
7 .I gs-options
8 ]
9 [
10 .I input-file
11 [
12 .I output-file
13 ]
14 ]
15 .PP
16 .B pdf2ps
17 [
18 .I gs-options
19 ]
20 [
21 .I input-file
22 [
23 .I output-file
24 ]
25 ]
26 .SH DESCRIPTION
27 .I Ps2pdf
28 and
29 .I pdf2ps
30 convert from PostScript to PDF and back by invoking
31 .IR gs (1).
32 If
33 .I output-file
34 is not specified, they write to standard output.
35 If neither
36 .I input-file
37 nor
38 .I output-file
39 is not specified, they read from standard input and write to standard output.
40 .PP
41 The
42 .I gs-options
43 are passed to Ghostscript unaltered.
44 The most useful option to
45 .I ps2pdf
46 is
47 .BR -dCompatibilityLevel=\fIlevel ,
48 which sets the version of PDF to be written.
49 The default is
50 .BR 1.2 ;
51 .B 1.3
52 and
53 .B 1.4
54 are also possible.
55 Similarly, the most useful option to
56 .I pdf2ps
57 is
58 .BR -dLanguageLevel=\fIlevel ,
59 which sets the version of PostScript to be written.
60 The default is
61 .BR 2 ;
62 .B 1
63 and
64 .B 3
65 are also possible.
66 .PP
67 .I Ps2pdf
68 produces output competitive with
69 Adobe Distiller in most cases, and it
70 accepts all the embedded PDF-generation hints that Adobe Distiller does.
71 .PP
72 .I Pdf2ps
73 produces a PostScript file containing one large bitmap
74 per page.  For a more direct and smaller translation,
75 use Adobe Acrobat's
76 .B -toPostScript
77 command-line option.
78 .SH SOURCE
79 .B /rc/bin/ps2pdf
80 .br
81 .B /rc/bin/pdf2ps
82 .SH SEE ALSO
83 .IR gs (1)
84 .SH BUGS
85 .IR Gs 's
86 .I pdfwrite
87 sometimes emits bad PDF at the default level 1.2.
88 Adding
89 .BR '-dCompatibilityLevel=1.4'
90 should cure it.