annotate runtime/doc/print.txt @ 16380:5ad204d8a2f2

Update runtime files commit https://github.com/vim/vim/commit/911ead126903aeb9564bad89e46a147ed4959896 Author: Bram Moolenaar <Bram@vim.org> Date: Sun Apr 21 00:03:35 2019 +0200 Update runtime files
author Bram Moolenaar <Bram@vim.org>
date Sun, 21 Apr 2019 00:15:06 +0200
parents 314694a2e74a
children 0e473e9e70c2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
13963
1174611ad715 Vim 8.1 release
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
1 *print.txt* For Vim version 8.1. Last change: 2010 Jul 20
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
2
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
3
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
4 VIM REFERENCE MANUAL by Bram Moolenaar
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
5
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
6
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
7 Printing *printing*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
8
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
9 1. Introduction |print-intro|
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
10 2. Print options |print-options|
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
11 3. PostScript Printing |postscript-printing|
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
12 4. PostScript Printing Encoding |postscript-print-encoding|
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
13 5. PostScript CJK Printing |postscript-cjk-printing|
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
14 6. PostScript Printing Troubleshooting |postscript-print-trouble|
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
15 7. PostScript Utilities |postscript-print-util|
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
16 8. Formfeed Characters |printing-formfeed|
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
17
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
18 {Vi has None of this}
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
19 {only available when compiled with the |+printer| feature}
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
20
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
21 ==============================================================================
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
22 1. Introduction *print-intro*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
23
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
24 On MS-Windows Vim can print your text on any installed printer. On other
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
25 systems a PostScript file is produced. This can be directly sent to a
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
26 PostScript printer. For other printers a program like ghostscript needs to be
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
27 used.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
28
1619
b9740fb41986 updated for version 7.2a
vimboss
parents: 1239
diff changeset
29 Note: If you have problems printing with |:hardcopy|, an alternative is to use
b9740fb41986 updated for version 7.2a
vimboss
parents: 1239
diff changeset
30 |:TOhtml| and print the resulting html file from a browser.
b9740fb41986 updated for version 7.2a
vimboss
parents: 1239
diff changeset
31
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
32 *:ha* *:hardcopy* *E237* *E238* *E324*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
33 :[range]ha[rdcopy][!] [arguments]
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
34 Send [range] lines (default whole file) to the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
35 printer.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
36
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
37 On MS-Windows a dialog is displayed to allow selection
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 15
diff changeset
38 of printer, paper size etc. To skip the dialog, use
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
39 the [!]. In this case the printer defined by
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
40 'printdevice' is used, or, if 'printdevice' is empty,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
41 the system default printer.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
42
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
43 For systems other than MS-Windows, PostScript is
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
44 written in a temp file and 'printexpr' is used to
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
45 actually print it. Then [arguments] can be used by
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
46 'printexpr' through |v:cmdarg|. Otherwise [arguments]
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
47 is ignored. 'printoptions' can be used to specify
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
48 paper size, duplex, etc.
14519
5c5908e81e93 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
49 Note: If you want PDF, there are tools such as
5c5908e81e93 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
50 "ps2pdf" that can convert the PostScript to PDF.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
51
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
52 :[range]ha[rdcopy][!] >{filename}
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
53 As above, but write the resulting PostScript in file
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
54 {filename}.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
55 Things like "%" are expanded |cmdline-special|
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
56 Careful: An existing file is silently overwritten.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
57 {only available when compiled with the |+postscript|
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
58 feature}
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
59 On MS-Windows use the "print to file" feature of the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
60 printer driver.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
61
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
62 Progress is displayed during printing as a page number and a percentage. To
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
63 abort printing use the interrupt key (CTRL-C or, on MS-systems, CTRL-Break).
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
64
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
65 Printer output is controlled by the 'printfont' and 'printoptions' options.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
66 'printheader' specifies the format of a page header.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
67
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
68 The printed file is always limited to the selected margins, irrespective of
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
69 the current window's 'wrap' or 'linebreak' settings. The "wrap" item in
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
70 'printoptions' can be used to switch wrapping off.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
71 The current highlighting colors are used in the printout, with the following
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
72 considerations:
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 15
diff changeset
73 1) The normal background is always rendered as white (i.e. blank paper).
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
74 2) White text or the default foreground is rendered as black, so that it shows
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
75 up!
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
76 3) If 'background' is "dark", then the colours are darkened to compensate for
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
77 the fact that otherwise they would be too bright to show up clearly on
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
78 white paper.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
79
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
80 ==============================================================================
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
81 2. Print options *print-options*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
82
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
83 Here are the details for the options that change the way printing is done.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
84 For generic info about setting options see |options.txt|.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
85
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
86 *pdev-option*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
87 'printdevice' 'pdev' string (default empty)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
88 global
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
89 This defines the name of the printer to be used when the |:hardcopy| command
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
90 is issued with a bang (!) to skip the printer selection dialog. On Win32, it
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
91 should be the printer name exactly as it appears in the standard printer
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
92 dialog.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
93 If the option is empty, then vim will use the system default printer for
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
94 ":hardcopy!"
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
95
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
96 *penc-option* *E620*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
97 'printencoding' 'penc' String (default empty, except for:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
98 Windows, OS/2: cp1252,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
99 Macintosh: mac-roman,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
100 VMS: dec-mcs,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
101 HPUX: hp-roman8,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
102 EBCDIC: ebcdic-uk)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
103 global
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
104 Sets the character encoding used when printing. This option tells Vim which
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
105 print character encoding file from the "print" directory in 'runtimepath' to
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
106 use.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
107
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
108 This option will accept any value from |encoding-names|. Any recognized names
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
109 are converted to Vim standard names - see 'encoding' for more details. Names
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
110 not recognized by Vim will just be converted to lower case and underscores
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
111 replaced with '-' signs.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
112
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
113 If 'printencoding' is empty or Vim cannot find the file then it will use
15878
314694a2e74a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
114 'encoding' (if it is set an 8-bit encoding) to find the print character
314694a2e74a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
115 encoding file. If Vim is unable to find a character encoding file then it
314694a2e74a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
116 will use the "latin1" print character encoding file.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
117
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
118 When 'encoding' is set to a multi-byte encoding, Vim will try to convert
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
119 characters to the printing encoding for printing (if 'printencoding' is empty
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
120 then the conversion will be to latin1). Conversion to a printing encoding
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
121 other than latin1 will require Vim to be compiled with the |+iconv| feature.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
122 If no conversion is possible then printing will fail. Any characters that
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
123 cannot be converted will be replaced with upside down question marks.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
124
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
125 Four print character encoding files are provided to support default Mac, VMS,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
126 HPUX, and EBCDIC character encodings and are used by default on these
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
127 platforms. Code page 1252 print character encoding is used by default on
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
128 Windows and OS/2 platforms.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
129
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
130 *pexpr-option*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
131 'printexpr' 'pexpr' String (default: see below)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
132 global
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
133 Expression that is evaluated to print the PostScript produced with
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
134 |:hardcopy|.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
135 The file name to be printed is in |v:fname_in|.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
136 The arguments to the ":hardcopy" command are in |v:cmdarg|.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
137 The expression must take care of deleting the file after printing it.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
138 When there is an error, the expression must return a non-zero number.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
139 If there is no error, return zero or an empty string.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
140 The default for non MS-Windows or VMS systems is to simply use "lpr" to print
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
141 the file: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
142
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
143 system('lpr' . (&printdevice == '' ? '' : ' -P' . &printdevice)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
144 . ' ' . v:fname_in) . delete(v:fname_in) + v:shell_error
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
145
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
146 On MS-Dos, MS-Windows and OS/2 machines the default is to copy the file to the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
147 currently specified printdevice: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
148
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
149 system('copy' . ' ' . v:fname_in . (&printdevice == ''
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
150 ? ' LPT1:' : (' \"' . &printdevice . '\"')))
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
151 . delete(v:fname_in)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
152
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
153 On VMS machines the default is to send the file to either the default or
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
154 currently specified printdevice: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
155
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
156 system('print' . (&printdevice == '' ? '' : ' /queue=' .
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
157 &printdevice) . ' ' . v:fname_in) . delete(v:fname_in)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
158
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
159 If you change this option, using a function is an easy way to avoid having to
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
160 escape all the spaces. Example: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
161
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
162 :set printexpr=PrintFile(v:fname_in)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
163 :function PrintFile(fname)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
164 : call system("ghostview " . a:fname)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
165 : call delete(a:fname)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
166 : return v:shell_error
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
167 :endfunc
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
168
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
169 Be aware that some print programs return control before they have read the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
170 file. If you delete the file too soon it will not be printed. These programs
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
171 usually offer an option to have them remove the file when printing is done.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
172 *E365*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
173 If evaluating the expression fails or it results in a non-zero number, you get
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
174 an error message. In that case Vim will delete the file. In the default
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
175 value for non-MS-Windows a trick is used: Adding "v:shell_error" will result
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
176 in a non-zero number when the system() call fails.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
177
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
178 This option cannot be set from a |modeline| or in the |sandbox|, for security
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
179 reasons.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
180
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
181 *pfn-option* *E613*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
182 'printfont' 'pfn' string (default "courier")
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
183 global
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
184 This is the name of the font that will be used for the |:hardcopy| command's
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
185 output. It has the same format as the 'guifont' option, except that only one
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
186 font may be named, and the special "guifont=*" syntax is not available.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
187
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
188 In the Win32 GUI version this specifies a font name with its extra attributes,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
189 as with the 'guifont' option.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
190
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
191 For other systems, only ":h11" is recognized, where "11" is the point size of
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
192 the font. When omitted, the point size is 10.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
193
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
194 *pheader-option*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
195 'printheader' 'pheader' string (default "%<%f%h%m%=Page %N")
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
196 global
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
197 This defines the format of the header produced in |:hardcopy| output. The
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
198 option is defined in the same way as the 'statusline' option. If Vim has not
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
199 been compiled with the |+statusline| feature, this option has no effect and a
1619
b9740fb41986 updated for version 7.2a
vimboss
parents: 1239
diff changeset
200 simple default header is used, which shows the page number. The same simple
b9740fb41986 updated for version 7.2a
vimboss
parents: 1239
diff changeset
201 header is used when this option is empty.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
202
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
203 *pmbcs-option*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
204 'printmbcharset' 'pmbcs' string (default "")
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
205 global
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
206 Sets the CJK character set to be used when generating CJK output from
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
207 |:hardcopy|. The following predefined values are currently recognised by Vim:
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
208
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
209 Value Description ~
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
210 Chinese GB_2312-80
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
211 (Simplified) GBT_12345-90
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
212 MAC Apple Mac Simplified Chinese
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
213 GBT-90_MAC GB/T 12345-90 Apple Mac Simplified
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
214 Chinese
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
215 GBK GBK (GB 13000.1-93)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
216 ISO10646 ISO 10646-1:1993
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
217
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
218 Chinese CNS_1993 CNS 11643-1993, Planes 1 & 2
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
219 (Traditional) BIG5
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
220 ETEN Big5 with ETen extensions
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
221 ISO10646 ISO 10646-1:1993
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
222
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
223 Japanese JIS_C_1978
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
224 JIS_X_1983
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
225 JIS_X_1990
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
226 MSWINDOWS Win3.1/95J (JIS X 1997 + NEC +
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
227 IBM extensions)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
228 KANJITALK6 Apple Mac KanjiTalk V6.x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
229 KANJITALK7 Apple Mac KanjiTalk V7.x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
230
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
231 Korean KS_X_1992
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
232 MAC Apple Macintosh Korean
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
233 MSWINDOWS KS X 1992 with MS extensions
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
234 ISO10646 ISO 10646-1:1993
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
235
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
236 Only certain combinations of the above values and 'printencoding' are
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
237 possible. The following tables show the valid combinations:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
238
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
239 euc-cn gbk ucs-2 utf-8 ~
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
240 Chinese GB_2312-80 x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
241 (Simplified) GBT_12345-90 x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
242 MAC x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
243 GBT-90_MAC x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
244 GBK x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
245 ISO10646 x x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
246
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
247 euc-tw big5 ucs-2 utf-8 ~
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
248 Chinese CNS_1993 x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
249 (Traditional) BIG5 x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
250 ETEN x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
251 ISO10646 x x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
252
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
253 euc-jp sjis ucs-2 utf-8 ~
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
254 Japanese JIS_C_1978 x x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
255 JIS_X_1983 x x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
256 JIS_X_1990 x x x
16380
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 15878
diff changeset
257 MSWINDOWS x
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 15878
diff changeset
258 KANJITALK6 x
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 15878
diff changeset
259 KANJITALK7 x
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
260
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
261 euc-kr cp949 ucs-2 utf-8 ~
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
262 Korean KS_X_1992 x
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
263 MAC x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
264 MSWINDOWS x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
265 ISO10646 x x
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
266
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
267 To set up the correct encoding and character set for printing some
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
268 Japanese text you would do the following; >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
269 :set printencoding=euc-jp
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
270 :set printmbcharset=JIS_X_1983
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
271
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
272 If 'printmbcharset' is not one of the above values then it is assumed to
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
273 specify a custom multi-byte character set and no check will be made that it is
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
274 compatible with the value for 'printencoding'. Vim will look for a file
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
275 defining the character set in the "print" directory in 'runtimepath'.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
276
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
277 *pmbfn-option*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
278 'printmbfont' 'pmbfn' string (default "")
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
279 global
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
280 This is a comma-separated list of fields for font names to be used when
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
281 generating CJK output from |:hardcopy|. Each font name has to be preceded
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
282 with a letter indicating the style the font is to be used for as follows:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
283
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
284 r:{font-name} font to use for normal characters
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
285 b:{font-name} font to use for bold characters
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
286 i:{font-name} font to use for italic characters
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
287 o:{font-name} font to use for bold-italic characters
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
288
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
289 A field with the r: prefix must be specified when doing CJK printing. The
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
290 other fontname specifiers are optional. If a specifier is missing then
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
291 another font will be used as follows:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
292
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
293 if b: is missing, then use r:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
294 if i: is missing, then use r:
839
1f3b1021f002 updated for version 7.0e05
vimboss
parents: 834
diff changeset
295 if o: is missing, then use b:
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
296
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
297 Some CJK fonts do not contain characters for codes in the ASCII code range.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
298 Also, some characters in the CJK ASCII code ranges differ in a few code points
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
299 from traditional ASCII characters. There are two additional fields to control
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
300 printing of characters in the ASCII code range.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
301
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
302 c:yes Use Courier font for characters in the ASCII
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
303 c:no (default) code range.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
304
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
305 a:yes Use ASCII character set for codes in the ASCII
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
306 a:no (default) code range.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
307
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
308 The following is an example of specifying two multi-byte fonts, one for normal
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
309 and italic printing and one for bold and bold-italic printing, and using
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
310 Courier to print codes in the ASCII code range but using the national
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
311 character set: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
312 :set printmbfont=r:WadaMin-Regular,b:WadaMin-Bold,c:yes
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
313 <
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
314 *popt-option*
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
315 'printoptions' 'popt' string (default "")
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
316 global
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
317 This is a comma-separated list of items that control the format of the output
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
318 of |:hardcopy|:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
319
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
320 left:{spec} left margin (default: 10pc)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
321 right:{spec} right margin (default: 5pc)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
322 top:{spec} top margin (default: 5pc)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
323 bottom:{spec} bottom margin (default: 5pc)
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
324 {spec} is a number followed by "in" for inches, "pt"
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
325 for points (1 point is 1/72 of an inch), "mm" for
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
326 millimeters or "pc" for a percentage of the media
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
327 size.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
328 Weird example:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
329 left:2in,top:30pt,right:16mm,bottom:3pc
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
330 If the unit is not recognized there is no error and
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
331 the default value is used.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
332
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
333 header:{nr} Number of lines to reserve for the header.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
334 Only the first line is actually filled, thus when {nr}
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
335 is 2 there is one empty line. The header is formatted
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
336 according to 'printheader'.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
337 header:0 Do not print a header.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
338 header:2 (default) Use two lines for the header
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
339
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
340 syntax:n Do not use syntax highlighting. This is faster and
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
341 thus useful when printing large files.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
342 syntax:y Do syntax highlighting.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
343 syntax:a (default) Use syntax highlighting if the printer appears to be
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
344 able to print color or grey.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
345
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
346 number:y Include line numbers in the printed output.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
347 number:n (default) No line numbers.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
348
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
349 wrap:y (default) Wrap long lines.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
350 wrap:n Truncate long lines.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
351
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
352 duplex:off Print on one side.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
353 duplex:long (default) Print on both sides (when possible), bind on long
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
354 side.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
355 duplex:short Print on both sides (when possible), bind on short
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
356 side.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
357
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
358 collate:y (default) Collating: 1 2 3, 1 2 3, 1 2 3
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
359 collate:n No collating: 1 1 1, 2 2 2, 3 3 3
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
360
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
361 jobsplit:n (default) Do all copies in one print job
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
362 jobsplit:y Do each copy as a separate print job. Useful when
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
363 doing N-up postprocessing.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
364
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
365 portrait:y (default) Orientation is portrait.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
366 portrait:n Orientation is landscape.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
367 *a4* *letter*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
368 paper:A4 (default) Paper size: A4
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
369 paper:{name} Paper size from this table:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
370 {name} size in cm size in inch ~
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
371 10x14 25.4 x 35.57 10 x 14
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
372 A3 29.7 x 42 11.69 x 16.54
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
373 A4 21 x 29.7 8.27 x 11.69
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
374 A5 14.8 x 21 5.83 x 8.27
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
375 B4 25 x 35.3 10.12 x 14.33
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
376 B5 17.6 x 25 7.17 x 10.12
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
377 executive 18.42 x 26.67 7.25 x 10.5
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
378 folio 21 x 33 8.27 x 13
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
379 ledger 43.13 x 27.96 17 x 11
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
380 legal 21.59 x 35.57 8.5 x 14
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
381 letter 21.59 x 27.96 8.5 x 11
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
382 quarto 21.59 x 27.5 8.5 x 10.83
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
383 statement 13.97 x 21.59 5.5 x 8.5
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
384 tabloid 27.96 x 43.13 11 x 17
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
385
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
386 formfeed:n (default) Treat form feed characters (0x0c) as a normal print
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
387 character.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
388 formfeed:y When a form feed character is encountered, continue
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
389 printing of the current line at the beginning of the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
390 first line on a new page.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
391
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
392 The item indicated with (default) is used when the item is not present. The
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
393 values are not always used, especially when using a dialog to select the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
394 printer and options.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
395 Example: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
396 :set printoptions=paper:letter,duplex:off
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
397
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
398 ==============================================================================
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
399 3. PostScript Printing *postscript-printing*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
400 *E455* *E456* *E457* *E624*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
401 Provided you have enough disk space there should be no problems generating a
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
402 PostScript file. You need to have the runtime files correctly installed (if
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
403 you can find the help files, they probably are).
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
404
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
405 There are currently a number of limitations with PostScript printing:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
406
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
407 - 'printfont' - The font name is ignored (the Courier family is always used -
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
408 it should be available on all PostScript printers) but the font size is
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
409 used.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
410
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
411 - 'printoptions' - The duplex setting is used when generating PostScript
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
412 output, but it is up to the printer to take notice of the setting. If the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
413 printer does not support duplex printing then it should be silently ignored.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
414 Some printers, however, don't print at all.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
415
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
416 - 8-bit support - While a number of 8-bit print character encodings are
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
417 supported it is possible that some characters will not print. Whether a
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
418 character will print depends on the font in the printer knowing the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
419 character. Missing characters will be replaced with an upside down question
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
420 mark, or a space if that character is also not known by the font. It may be
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
421 possible to get all the characters in an encoding to print by installing a
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
422 new version of the Courier font family.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
423
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
424 - Multi-byte support - Currently Vim will try to convert multi-byte characters
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
425 to the 8-bit encoding specified by 'printencoding' (or latin1 if it is
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
426 empty). Any characters that are not successfully converted are shown as
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
427 unknown characters. Printing will fail if Vim cannot convert the multi-byte
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
428 to the 8-bit encoding.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
429
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
430 ==============================================================================
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
431 4. Custom 8-bit Print Character Encodings *postscript-print-encoding*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
432 *E618* *E619*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
433 To use your own print character encoding when printing 8-bit character data
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
434 you need to define your own PostScript font encoding vector. Details on how
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
435 to define a font encoding vector is beyond the scope of this help file, but
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
436 you can find details in the PostScript Language Reference Manual, 3rd Edition,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
437 published by Addison-Wesley and available in PDF form at
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
438 http://www.adobe.com/. The following describes what you need to do for Vim to
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
439 locate and use your print character encoding.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
440
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
441 i. Decide on a unique name for your encoding vector, one that does not clash
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
442 with any of the recognized or standard encoding names that Vim uses (see
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
443 |encoding-names| for a list), and that no one else is likely to use.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
444 ii. Copy $VIMRUNTIME/print/latin1.ps to the print subdirectory in your
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
445 'runtimepath' and rename it with your unique name.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
446 iii. Edit your renamed copy of latin1.ps, replacing all occurrences of latin1
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
447 with your unique name (don't forget the line starting %%Title:), and
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
448 modify the array of glyph names to define your new encoding vector. The
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
449 array must have exactly 256 entries or you will not be able to print!
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
450 iv. Within Vim, set 'printencoding' to your unique encoding name and then
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
451 print your file. Vim will now use your custom print character encoding.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
452
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
453 Vim will report an error with the resource file if you change the order or
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
454 content of the first 3 lines, other than the name of the encoding on the line
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
455 starting %%Title: or the version number on the line starting %%Version:.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
456
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
457 [Technical explanation for those that know PostScript - Vim looks for a file
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
458 with the same name as the encoding it will use when printing. The file
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
459 defines a new PostScript Encoding resource called /VIM-name, where name is the
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
460 print character encoding Vim will use.]
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
461
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
462 ==============================================================================
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
463 5. PostScript CJK Printing *postscript-cjk-printing*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
464 *E673* *E674* *E675*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
465
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
466 Vim supports printing of Chinese, Japanese, and Korean files. Setting up Vim
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
467 to correctly print CJK files requires setting up a few more options.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
468
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
469 Each of these countries has many standard character sets and encodings which
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
470 require that both be specified when printing. In addition, CJK fonts normally
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
471 do not have the concept of italic glyphs and use different weight or stroke
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
472 style to achieve emphasis when printing. This in turn requires a different
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
473 approach to specifying fonts to use when printing.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
474
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
475 The encoding and character set are specified with the 'printencoding' and
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
476 'printmbcharset' options. If 'printencoding' is not specified then 'encoding'
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
477 is used as normal. If 'printencoding' is specified then characters will be
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
478 translated to this encoding for printing. You should ensure that the encoding
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
479 is compatible with the character set needed for the file contents or some
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
480 characters may not appear when printed.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
481
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
482 The fonts to use for CJK printing are specified with 'printmbfont'. This
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
483 option allows you to specify different fonts to use when printing characters
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
484 which are syntax highlighted with the font styles normal, italic, bold and
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
485 bold-italic.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
486
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
487 No CJK fonts are supplied with Vim. There are some free Korean, Japanese, and
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
488 Traditional Chinese fonts available at:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
489
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
490 http://examples.oreilly.com/cjkvinfo/adobe/samples/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
491
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
492 You can find descriptions of the various fonts in the read me file at
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
493
2236
dc2e5ec0500d Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
494 http://examples.oreilly.de/english_examples/cjkvinfo/adobe/00README
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
495
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
496 Please read your printer documentation on how to install new fonts.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
497
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
498 CJK fonts can be large containing several thousand glyphs, and it is not
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
499 uncommon to find that they only contain a subset of a national standard. It
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
500 is not unusual to find the fonts to not include characters for codes in the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
501 ASCII code range. If you find half-width Roman characters are not appearing
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
502 in your printout then you should configure Vim to use the Courier font the
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
503 half-width ASCII characters with 'printmbfont'. If your font does not include
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
504 other characters then you will need to find another font that does.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
505
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
506 Another issue with ASCII characters, is that the various national character
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
507 sets specify a couple of different glyphs in the ASCII code range. If you
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
508 print ASCII text using the national character set you may see some unexpected
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
509 characters. If you want true ASCII code printing then you need to configure
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
510 Vim to output ASCII characters for the ASCII code range with 'printmbfont'.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
511
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
512 It is possible to define your own multi-byte character set although this
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
513 should not be attempted lightly. A discussion on the process if beyond the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
514 scope of these help files. You can find details on CMap (character map) files
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
515 in the document 'Adobe CMap and CIDFont Files Specification, Version 1.0',
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
516 available from http://www.adobe.com as a PDF file.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
517
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
518 ==============================================================================
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
519 6. PostScript Printing Troubleshooting *postscript-print-trouble*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
520 *E621*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
521 Usually the only sign of a problem when printing with PostScript is that your
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
522 printout does not appear. If you are lucky you may get a printed page that
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
523 tells you the PostScript operator that generated the error that prevented the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
524 print job completing.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
525
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
526 There are a number of possible causes as to why the printing may have failed:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
527
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
528 - Wrong version of the prolog resource file. The prolog resource file
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
529 contains some PostScript that Vim needs to be able to print. Each version
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
530 of Vim needs one particular version. Make sure you have correctly installed
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
531 the runtime files, and don't have any old versions of a file called prolog
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
532 in the print directory in your 'runtimepath' directory.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
533
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
534 - Paper size. Some PostScript printers will abort printing a file if they do
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
535 not support the requested paper size. By default Vim uses A4 paper. Find
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
536 out what size paper your printer normally uses and set the appropriate paper
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
537 size with 'printoptions'. If you cannot find the name of the paper used,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
538 measure a sheet and compare it with the table of supported paper sizes listed
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
539 for 'printoptions', using the paper that is closest in both width AND height.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
540 Note: The dimensions of actual paper may vary slightly from the ones listed.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
541 If there is no paper listed close enough, then you may want to try psresize
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
542 from PSUtils, discussed below.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
543
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
544 - Two-sided printing (duplex). Normally a PostScript printer that does not
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
545 support two-sided printing will ignore any request to do it. However, some
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
546 printers may abort the job altogether. Try printing with duplex turned off.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
547 Note: Duplex prints can be achieved manually using PS utils - see below.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
548
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
549 - Collated printing. As with Duplex printing, most PostScript printers that
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
550 do not support collating printouts will ignore a request to do so. Some may
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
551 not. Try printing with collation turned off.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
552
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
553 - Syntax highlighting. Some print management code may prevent the generated
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
554 PostScript file from being printed on a black and white printer when syntax
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
555 highlighting is turned on, even if solid black is the only color used. Try
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
556 printing with syntax highlighting turned off.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
557
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
558 A safe printoptions setting to try is: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
559
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
560 :set printoptions=paper:A4,duplex:off,collate:n,syntax:n
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
561
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
562 Replace "A4" with the paper size that best matches your printer paper.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
563
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
564 ==============================================================================
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
565 7. PostScript Utilities *postscript-print-util*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
566
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
567 7.1 Ghostscript
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
568
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
569 Ghostscript is a PostScript and PDF interpreter that can be used to display
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
570 and print on non-PostScript printers PostScript and PDF files. It can also
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
571 generate PDF files from PostScript.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
572
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
573 Ghostscript will run on a wide variety of platforms.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
574
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
575 There are three available versions:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
576
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
577 - AFPL Ghostscript (formerly Aladdin Ghostscript) which is free for
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
578 non-commercial use. It can be obtained from:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
579
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
580 http://www.cs.wisc.edu/~ghost/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
581
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
582 - GNU Ghostscript which is available under the GNU General Public License. It
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
583 can be obtained from:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
584
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
585 ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/gnu/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
586
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
587 - A commercial version for inclusion in commercial products.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
588
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
589 Additional information on Ghostscript can also be found at:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
590
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
591 http://www.ghostscript.com/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
592
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
593 Support for a number of non PostScript printers is provided in the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
594 distribution as standard, but if you cannot find support for your printer
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
595 check the Ghostscript site for other printers not included by default.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
596
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
597
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
598 7.2 Ghostscript Previewers.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
599
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
600 The interface to Ghostscript is very primitive so a number of graphical front
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
601 ends have been created. These allow easier PostScript file selection,
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
602 previewing at different zoom levels, and printing. Check supplied
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
603 documentation for full details.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
604
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
605 X11
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
606
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
607 - Ghostview. Obtainable from:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
608
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
609 http://www.cs.wisc.edu/~ghost/gv/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
610
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
611 - gv. Derived from Ghostview. Obtainable from:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
612
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
613 http://wwwthep.physik.uni-mainz.de/~plass/gv/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
614
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
615 Copies (possibly not the most recent) can be found at:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
616
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
617 http://www.cs.wisc.edu/~ghost/gv/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
618
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
619 OpenVMS
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
620
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
621 - Is apparently supported in the main code now (untested). See:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
622
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
623 http://wwwthep.physik.uni-mainz.de/~plass/gv/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
624
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
625 Windows and OS/2
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
626
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
627 - GSview. Obtainable from:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
628
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
629 http://www.cs.wisc.edu/~ghost/gsview/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
630
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
631 DOS
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
632
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
633 - ps_view. Obtainable from:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
634
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
635 ftp://ftp.pg.gda.pl/pub/TeX/support/ps_view/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
636 ftp://ftp.dante.de/tex-archive/support/ps_view/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
637
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
638 Linux
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
639
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
640 - GSview. Linux version of the popular Windows and OS/2 previewer.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
641 Obtainable from:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
642
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
643 http://www.cs.wisc.edu/~ghost/gsview/
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
644
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
645 - BMV. Different from Ghostview and gv in that it doesn't use X but svgalib.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
646 Obtainable from:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
647
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
648 ftp://sunsite.unc.edu/pub/Linux/apps/graphics/viewers/svga/bmv-1.2.tgz
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
649
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
650
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
651 7.3 PSUtils
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
652
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
653 PSUtils is a collection of utility programs for manipulating PostScript
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
654 documents. Binary distributions are available for many platforms, as well as
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
655 the full source. PSUtils can be found at:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
656
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
657 http://knackered.org/angus/psutils
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
658
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
659 The utilities of interest include:
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
660
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
661 - psnup. Convert PS files for N-up printing.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
662 - psselect. Select page range and order of printing.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
663 - psresize. Change the page size.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
664 - psbook. Reorder and lay out pages ready for making a book.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
665
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
666 The output of one program can be used as the input to the next, allowing for
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
667 complex print document creation.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
668
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
669
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
670 N-UP PRINTING
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
671
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
672 The psnup utility takes an existing PostScript file generated from Vim and
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
673 convert it to an n-up version. The simplest way to create a 2-up printout is
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
674 to first create a PostScript file with: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
675
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
676 :hardcopy > test.ps
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
677
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
678 Then on your command line execute: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
679
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
680 psnup -n 2 test.ps final.ps
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
681
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
682 Note: You may get warnings from some Ghostscript previewers for files produced
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
683 by psnup - these may safely be ignored.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
684
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
685 Finally print the file final.ps to your PostScript printer with your
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
686 platform's print command. (You will need to delete the two PostScript files
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
687 afterwards yourself.) 'printexpr' could be modified to perform this extra
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
688 step before printing.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
689
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
690
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
691 ALTERNATE DUPLEX PRINTING
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
692
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
693 It is possible to achieve a poor man's version of duplex printing using the PS
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
694 utility psselect. This utility has options -e and -o for printing just the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
695 even or odd pages of a PS file respectively.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
696
6530
435956324539 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
697 First generate a PS file with the 'hardcopy' command, then generate new
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
698 files with all the odd and even numbered pages with: >
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
699
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
700 psselect -o test.ps odd.ps
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
701 psselect -e test.ps even.ps
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
702
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
703 Next print odd.ps with your platform's normal print command. Then take the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
704 print output, turn it over and place it back in the paper feeder. Now print
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
705 even.ps with your platform's print command. All the even pages should now
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
706 appear on the back of the odd pages.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
707
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
708 There are a couple of points to bear in mind:
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
709
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
710 1. Position of the first page. If the first page is on top of the printout
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
711 when printing the odd pages then you need to reverse the order that the odd
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
712 pages are printed. This can be done with the -r option to psselect. This
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
713 will ensure page 2 is printed on the back of page 1.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
714 Note: it is better to reverse the odd numbered pages rather than the even
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
715 numbered in case there are an odd number of pages in the original PS file.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
716
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
717 2. Paper flipping. When turning over the paper with the odd pages printed on
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
718 them you may have to either flip them horizontally (along the long edge) or
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
719 vertically (along the short edge), as well as possibly rotating them 180
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
720 degrees. All this depends on the printer - it will be more obvious for
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
721 desktop ink jets than for small office laser printers where the paper path
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
722 is hidden from view.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
723
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
724
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
725 ==============================================================================
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
726 8. Formfeed Characters *printing-formfeed*
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
727
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
728 By default Vim does not do any special processing of |formfeed| control
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
729 characters. Setting the 'printoptions' formfeed item will make Vim recognize
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
730 formfeed characters and continue printing the current line at the beginning
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
731 of the first line on a new page. The use of formfeed characters provides
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
732 rudimentary print control but there are certain things to be aware of.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
733
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
734 Vim will always start printing a line (including a line number if enabled)
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
735 containing a formfeed character, even if it is the first character on the
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
736 line. This means if a line starting with a formfeed character is the first
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
737 line of a page then Vim will print a blank page.
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
738
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
739 Since the line number is printed at the start of printing the line containing
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
740 the formfeed character, the remainder of the line printed on the new page
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
741 will not have a line number printed for it (in the same way as the wrapped
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
742 lines of a long line when wrap in 'printoptions' is enabled).
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
743
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
744 If the formfeed character is the last character on a line, then printing will
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
745 continue on the second line of the new page, not the first. This is due to
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
746 Vim processing the end of the line after the formfeed character and moving
15
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
747 down a line to continue printing.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
748
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
749 Due to the points made above it is recommended that when formfeed character
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
750 processing is enabled, printing of line numbers is disabled, and that form
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
751 feed characters are not the last character on a line. Even then you may need
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
752 to adjust the number of lines before a formfeed character to prevent
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
753 accidental blank pages.
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
754
631143ac4a01 updated for version 7.0007
vimboss
parents:
diff changeset
755 ==============================================================================
14421
2f7e67dd088c Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
756 vim:tw=78:ts=8:noet:ft=help:norl: