plan9port/man/man1/psfonts.1
Russ Cox 977b25a76a tmac: introduce real manual reference macro instead of overloading IR
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links.
But not all such IR invocations should be manual links;
those had to be written to avoid the IR macro before.
Worse, the \X'...' ending the IR causes troff to emit only a single space after a period.

Defining a new IM macro for manual references fixes both problems.

Fixes #441.
2020-08-13 23:43:43 -04:00

125 lines
2.3 KiB
Groff

.TH PSFONTS 1
.SH NAME
psfonts, psdownload \- add necessary fonts to PostScript document for printing
.SH SYNOPSIS
.B psfonts
[
.I files ...
]
.PP
.B psdownload
[
.B options
]
[
.I files ...
]
.SH DESCRIPTION
Plan 9's
.IM troff (1)
and
.IM tr2post (1)
use non-standard PostScript fonts
(found in
.BR \*9/postscript/font ).
Before sending PostScript output from
.I tr2post
to a standard printer, code implementing
the non-standard fonts must be added to the PostScript.
.PP
.I Psfonts
copies
.I files
(or standard input)
to standard output, adding necessary PostScript fonts.
.PP
.I Psdownload
is the more general program used to implement
.IR psfonts .
The options are:
.TP
.BI -c " comment
Expect the fonts used in the document to be listed in
a comment beginning with this string
(default
.BR %%DocumentFonts: ).
.TP
.BI -f " atend
Expect extra fonts comments at the end of the document,
so read the entire input before starting output
(by default this only happens if a
.B %%DocumentFonts:
.B (atend)
comment is encountered).
.TP
.BI -m " mapfile
Use
.I mapfile
to translate from PostScript font names to files.
Each line in the map has two white space-separated
fields: a font name and the corresponding file.
If
.I mapfile
is not a rooted path, it is evaluated relative to the
.I fontdir
(see
.B -H
below).
.TP
.BI -p " printer
Set the name of the printer.
This option is deprecated. Its only effect is to override the
.B -r
option, causing
.IB fontdir /printers/ printer
to be used as the resident fonts list.
.TP
.BI -r " residentfonts
Read a list of fonts assumed to be on the printer
(not necessary to re-download) from the file
.IR residentfonts .
If
.I residentfonts
is not a rooted path, it is evaluated relative to the
.I fontdir
(see
.B -H
below).
.TP
.BI -H " fontdir
Set the directory that is assumed to contain the PostScript fonts
and information about printers
(see
.BR -m ,
.BR -p ,
and
.B -r
above;
default
.BR \*9/postscript/font ).
.TP
.BI -T " tmpdir
Use
.I tmpdir
for storing temporary files
(default
.BR /var/tmp ).
.B
.TP
.BI -D
Produce copious amounts of debugging information on standard error.
.TP
.BI -I
Continue running even after fatal errors occur.
.PD
.SH EXAMPLE
See
.IM tr2post (1)
for an example.
.SH SOURCE
.B \*9/bin/psfonts
.br
.B \*9/src/cmd/postscript/download
.SH SEE ALSO
.IM troff (1) ,
.IM tr2post (1)