@@ -4511,223 +4511,71 @@ A jump table for the options with a short description can be found at |Q_op|.
45114511 {not in Vi}
45124512 {only available when compiled with the | +printer |
45134513 feature}
4514- This defines the name of the printer to be used when the | :hardcopy |
4515- command is issued with a bang (!) to skip the printer selection
4516- dialog. On Win32, it should be the printer name exactly as it appears
4517- in the standard printer dialog.
4518- If the option is empty, then vim will use the system default printer
4519- for ":hardcopy!"
4520-
4521- *'printencoding'* *'penc'* *E620*
4522- 'printencoding' 'penc' String (default empty, except for:
4523- Windows, OS/2: cp1252,
4524- Macintosh: mac-roman,
4525- VMS: dec-mcs,
4526- HPUX: hp-roman8,
4527- EBCDIC: ebcdic-uk)
4514+ The name of the printer to be used for | :hardcopy | .
4515+ See | pdev-option | .
4516+
4517+ *'printencoding'* *'penc'*
4518+ 'printencoding' 'penc' String (default empty, except for some systems)
45284519 global
45294520 {not in Vi}
45304521 {only available when compiled with the | +printer |
45314522 and | +postscript | features}
4532- Sets the character encoding used when printing. This option tells VIM
4533- which print character encoding file from the "print" directory in
4534- 'runtimepath' to use.
4535-
4536- This option will accept any value from | encoding-names | . Any
4537- recognized names are converted to VIM standard names - see 'encoding'
4538- for more details. Names not recognized by VIM will just be converted
4539- to lower case and underscores replaced with '-' signs.
4540-
4541- If 'printencoding' is empty or VIM cannot find the file then it will
4542- use 'encoding' (if VIM is compiled with | +multi_byte | and it is set an
4543- 8-bit encoding) to find the print character encoding file. If VIM is
4544- unable to find a character encoding file then it will use the "latin1"
4545- print character encoding file.
4546-
4547- When 'encoding' is set to a multi-byte encoding, VIM will try to
4548- convert characters to the printing encoding for printing (if
4549- 'printencoding' is empty then the conversion will be to latin1).
4550- Conversion to a printing encoding other than latin1 will require VIM
4551- to be compiled with the | +iconv | feature. If no conversion is
4552- possible then printing will fail. Any characters that cannot be
4553- converted will be replaced with upside down question marks.
4554-
4555- Four print character encoding files are provided to support default
4556- Mac, VMS, HPUX, and EBCDIC character encodings and are used by default
4557- on these platforms. Code page 1252 print character encoding is used
4558- by default on Windows and OS/2 platforms.
4559-
4523+ Sets the character encoding used when printing.
4524+ See | penc-option | .
45604525
45614526 *'printexpr'* *'pexpr'*
45624527'printexpr' 'pexpr' String (default: see below)
45634528 global
45644529 {not in Vi}
45654530 {only available when compiled with the | +printer |
45664531 and | +postscript | features}
4567- Expression that is evaluated to print the PostScript produced with
4568- ":hardcopy".
4569- The file name to be printed is in | v:fname_in | .
4570- The arguments to the ":hardcopy" command are in | v:cmdarg | .
4571- The expression must take care of deleting the file after printing it.
4572- When there is an error, the expression must return a non-zero number.
4573- If there is no error, return zero or an empty string.
4574- The default for non MS-Windows or VMS systems is to simply use "lpr"
4575- to print the file: >
4576-
4577- system('lpr' . (&printdevice == '' ? '' : ' -P' . &printdevice)
4578- . ' ' . v:fname_in) . delete(v:fname_in) + v:shell_error
4579- <
4580- On MS-Dos, MS-Windows and OS/2 machines the default is to copy the
4581- file to the currently specified printdevice: >
4582-
4583- system('copy' . ' ' . v:fname_in . (&printdevice == ''
4584- ? ' LPT1:' : (' \"' . &printdevice . '\"')))
4585- . delete(v:fname_in)
4586- <
4587- On VMS machines the default is to send the file to either the default
4588- or currently specified printdevice: >
4532+ Expression used to print the PostScript produced with | :hardcopy | .
4533+ See | pexpr-option | .
45894534
4590- system('print' . (&printdevice == '' ? '' : ' /queue=' .
4591- &printdevice) . ' ' . v:fname_in) . delete(v:fname_in)
4592- <
4593- If you change this option, using a function is an easy way to avoid
4594- having to escape all the spaces. Example: >
4595-
4596- :set printexpr=PrintFile(v:fname_in)
4597- :function PrintFile(fname)
4598- : call system("ghostview " . a:fname)
4599- : call delete(a:fname)
4600- : return v:shell_error
4601- :endfunc
4602-
4603- < Be aware that some print programs return control before they have read
4604- the file. If you delete the file too soon it will not be printed.
4605- These programs usually offer an option to have them remove the file
4606- when printing is done.
4607- *E365*
4608- If evaluating the expression fails or it results in a non-zero number,
4609- you get an error message. In that case Vim will delete the
4610- file. In the default value for non-MS-Windows a trick is used: Adding
4611- "v:shell_error" will result in a non-zero number when the system()
4612- call fails.
4613- This option cannot be set from a | modeline | or in the | sandbox | , for
4614- security reasons.
4615-
4616- *'printfont'* *'pfn'* *E613*
4535+ *'printfont'* *'pfn'*
46174536'printfont' 'pfn' string (default "courier")
46184537 global
46194538 {not in Vi}
46204539 {only available when compiled with the | +printer |
46214540 feature}
4622- This is the name of the font that will be used for the | :hardcopy |
4623- command's output. It has the same format as the 'guifont' option,
4624- except that only one font may be named, and the special "guifont=*"
4625- syntax is not available.
4626- In the Win32 GUI version this specifies a font name with its extra
4627- attributes, as with the 'guifont' option.
4628- For other systems, only ":h11" is recognized, where "11" is the point
4629- size of the font. When omitted, the point size is 10.
4541+ The name of the font that will be used for | :hardcopy | .
4542+ See | pfn-option | .
46304543
46314544 *'printheader'* *'pheader'*
46324545'printheader' 'pheader' string (default "%<%f%h%m%=Page %N")
46334546 global
46344547 {not in Vi}
46354548 {only available when compiled with the | +printer |
46364549 feature}
4637- This defines the format of the header produced in | :hardcopy | output.
4638- The option is defined in the same way as the 'statusline' option.
4639- If Vim has not been compiled with the | +statusline | feature, this
4640- option has no effect and a simple default header is used, which shows
4641- the page number.
4550+ The format of the header produced in | :hardcopy | output.
4551+ See | pheader-option | .
4552+
4553+ *'printmbcharset'* *'pmbcs'*
4554+ 'printmbcharset' 'pmbcs' string (default "")
4555+ global
4556+ {not in Vi}
4557+ {only available when compiled with the | +printer |
4558+ and | +multi_byte | features}
4559+ The CJK character set to be used for CJK output from | :hardcopy | .
4560+ See | pmbcs-option | .
4561+
4562+ *'printmbfont'* *'pmbfn'*
4563+ 'printmbfont' 'pmbfn' string (default "")
4564+ global
4565+ {not in Vi}
4566+ {only available when compiled with the | +printer |
4567+ and | +multi_byte | features}
4568+ List of font names to be used for CJK output from | :hardcopy | .
4569+ See | pmbfn-option | .
46424570
46434571 *'printoptions'* *'popt'*
46444572'printoptions' 'popt' string (default "")
46454573 global
46464574 {not in Vi}
46474575 {only available when compiled with | +printer | feature}
4648- This is a comma-separated list of items that control the format of
4649- the output of | :hardcopy | :
4650-
4651- left:{spec} left margin (default: 10pc)
4652- right:{spec} right margin (default: 5pc)
4653- top:{spec} top margin (default: 5pc)
4654- bottom:{spec} bottom margin (default: 5pc)
4655- {spec} is a number followed by "in" for
4656- inches, "pt" for points (1 point is 1/72 of an
4657- inch), "mm" for millimeters or "pc" for a
4658- percentage of the media size.
4659- Weird example:
4660- left:2in,top:30pt,right:16mm,bottom:3pc
4661- If the unit is not recognized there is no
4662- error and the default value is used.
4663-
4664- header:{nr} Number of lines to reserve for the header.
4665- Only the first line is actually filled, thus
4666- when {nr} is 2 there is one empty line. The
4667- header is formatted according to
4668- 'printheader' .
4669- header:0 Do not print a header.
4670- header:2 (default) Use two lines for the header
4671-
4672- syntax:n Do not use syntax highlighting. This is
4673- faster and thus useful when printing large
4674- files.
4675- syntax:y Do syntax highlighting.
4676- syntax:a (default) Use syntax highlighting if the printer appears
4677- to be able to print color or grey.
4678-
4679- number:y Include line numbers in the printed output.
4680- number:n (default) No line numbers.
4681-
4682- wrap:y (default) Wrap long lines.
4683- wrap:n Truncate long lines.
4684-
4685- duplex:off Print on one side.
4686- duplex:long (default) Print on both sides (when possible), bind on
4687- long side.
4688- duplex:short Print on both sides (when possible), bind on
4689- short side.
4690-
4691- collate:y (default) Collating: 1 2 3, 1 2 3, 1 2 3
4692- collate:n No collating: 1 1 1, 2 2 2, 3 3 3
4693-
4694- jobsplit:n (default) Do all copies in one print job
4695- jobsplit:y Do each copy as a separate print job. Useful
4696- when doing N-up postprocessing.
4697-
4698- portrait:y (default) Orientation is portrait.
4699- portrait:n Orientation is landscape.
4700- *a4* *letter*
4701- paper:A4 (default) Paper size: A4
4702- paper:{name} Paper size from this table:
4703- {name} size in cm size in inch ~
4704- 10x14 25.4 x 35.57 10 x 14
4705- A3 29.7 x 42 11.69 x 16.54
4706- A4 21 x 29.7 8.27 x 11.69
4707- A5 14.8 x 21 5.83 x 8.27
4708- B4 25 x 35.3 10.12 x 14.33
4709- B5 17.6 x 25 7.17 x 10.12
4710- executive 18.42 x 26.67 7.25 x 10.5
4711- folio 21 x 33 8.27 x 13
4712- ledger 43.13 x 27.96 17 x 11
4713- legal 21.59 x 35.57 8.5 x 14
4714- letter 21.59 x 27.96 8.5 x 11
4715- quarto 21.59 x 27.5 8.5 x 10.83
4716- statement 13.97 x 21.59 5.5 x 8.5
4717- tabloid 27.96 x 43.13 11 x 17
4718-
4719- formfeed:n (default) Treat form feed characters (0x0c) as a normal
4720- print character.
4721- formfeed:y When a form feed character is encountered,
4722- continue printing of the current line at the
4723- beginning of the first line on a new page.
4724-
4725- The item indicated with (default) is used when the item is not
4726- present. The values are not always used, especially when using a
4727- dialog to select the printer and options.
4728- Example: >
4729- :set printoptions=paper:letter,duplex:off
4730- <
4576+ List of items that control the format of the output of | :hardcopy | .
4577+ See | popt-option | .
4578+
47314579 *'quoteescape''* *'qe'*
47324580'quoteescape' 'qe' string (default "\")
47334581 local to buffer
0 commit comments