aboutsummaryrefslogtreecommitdiff
path: root/man/man1/psfonts.html
blob: b0510a810b3ba53bb52ff7df57309e10c3f14cfd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
<head>
<title>psfonts(1) - Plan 9 from User Space</title>
<meta content="text/html; charset=utf-8" http-equiv=Content-Type>
</head>
<body bgcolor=#ffffff>
<table border=0 cellpadding=0 cellspacing=0 width=100%>
<tr height=10><td>
<tr><td width=20><td>
<tr><td width=20><td><b>PSFONTS(1)</b><td align=right><b>PSFONTS(1)</b>
<tr><td width=20><td colspan=2>
    <br>
<p><font size=+1><b>NAME     </b></font><br>

<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

    psfonts, psdownload &ndash; add necessary fonts to PostScript document
    for printing<br>
    
</table>
<p><font size=+1><b>SYNOPSIS     </b></font><br>

<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

    <tt><font size=+1>psfonts</font></tt> [ <i>files ...</i> ] 
    <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
    
    <tt><font size=+1>psdownload</font></tt> [ <tt><font size=+1>options</font></tt> ] [ <i>files ...</i> ]<br>
    
</table>
<p><font size=+1><b>DESCRIPTION     </b></font><br>

<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

    Plan 9&#8217;s <a href="../man1/troff.html"><i>troff</i>(1)</a> and <a href="../man1/tr2post.html"><i>tr2post</i>(1)</a> use non-standard PostScript fonts
    (found in <tt><font size=+1>/usr/local/plan9/postscript/font</font></tt>). Before sending PostScript
    output from <i>tr2post</i> to a standard printer, code implementing the
    non-standard fonts must be added to the PostScript. 
    <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
    
    <i>Psfonts</i> copies <i>files</i> (or standard input) to standard output, adding
    necessary PostScript fonts. 
    <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
    
    <i>Psdownload</i> is the more general program used to implement <i>psfonts</i>.
    The options are:<br>
    <tt><font size=+1>&#8722;c</font></tt> <i>comment<br>
    </i>
    <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

        Expect the fonts used in the document to be listed in a comment
        beginning with this string (default <tt><font size=+1>%%DocumentFonts:</font></tt>).<br>
        
    </table>
    <tt><font size=+1>&#8722;f</font></tt> <i>atend<br>
    </i>
    <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

        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 <tt><font size=+1>%%DocumentFonts: (atend)</font></tt> comment is encountered).<br>
        
    </table>
    <tt><font size=+1>&#8722;m</font></tt> <i>mapfile<br>
    </i>
    <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

        Use <i>mapfile</i> 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</i> is not a rooted path,
        it is evaluated relative to the <i>fontdir</i> (see <tt><font size=+1>&#8722;H</font></tt> below).<br>
        
    </table>
    <tt><font size=+1>&#8722;p</font></tt> <i>printer<br>
    </i>
    <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

        Set the name of the printer. This option is deprecated. Its only
        effect is to override the <tt><font size=+1>&#8722;r</font></tt> option, causing <i>fontdir</i><tt><font size=+1>/printers/</font></tt><i>printer</i>
        to be used as the resident fonts list.<br>
        
    </table>
    <tt><font size=+1>&#8722;r</font></tt> <i>residentfonts<br>
    </i>
    <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

        Read a list of fonts assumed to be on the printer (not necessary
        to re-download) from the file <i>residentfonts</i>. If <i>residentfonts</i>
        is not a rooted path, it is evaluated relative to the <i>fontdir</i>
        (see <tt><font size=+1>&#8722;H</font></tt> below).<br>
        
    </table>
    <tt><font size=+1>&#8722;H</font></tt> <i>fontdir<br>
    </i>
    <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

        Set the directory that is assumed to contain the PostScript fonts
        and information about printers (see <tt><font size=+1>&#8722;m</font></tt>, <tt><font size=+1>&#8722;p</font></tt>, and <tt><font size=+1>&#8722;r</font></tt> above; default
        <tt><font size=+1>/usr/local/plan9/postscript/font</font></tt>).<br>
        
    </table>
    <tt><font size=+1>&#8722;T</font></tt> <i>tmpdir<br>
    </i>
    <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

        Use <i>tmpdir</i> for storing temporary files (default <tt><font size=+1>/var/tmp</font></tt>).<br>
        
    </table>
    <tt><font size=+1>&#8722;D</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;Produce copious amounts of debugging information on standard
    error.<br>
    <tt><font size=+1>&#8722;I</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;Continue running even after fatal errors occur.<br>
    
</table>
<p><font size=+1><b>EXAMPLE     </b></font><br>

<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

    See <a href="../man1/tr2post.html"><i>tr2post</i>(1)</a> for an example.<br>
    
</table>
<p><font size=+1><b>SOURCE     </b></font><br>

<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

    <tt><font size=+1>/usr/local/plan9/bin/psfonts<br>
    /usr/local/plan9/src/cmd/postscript/download<br>
    </font></tt>
</table>
<p><font size=+1><b>SEE ALSO    </b></font><br>

<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>

    <a href="../man1/troff.html"><i>troff</i>(1)</a>, <a href="../man1/tr2post.html"><i>tr2post</i>(1)</a><br>
    
</table>

<td width=20>
<tr height=20><td>
</table>
<!-- TRAILER -->
<table border=0 cellpadding=0 cellspacing=0 width=100%>
<tr height=15><td width=10><td><td width=10>
<tr><td><td>
<center>
<a href="../../"><img src="../../dist/spaceglenda100.png" alt="Space Glenda" border=1></a>
</center>
</table>
<!-- TRAILER -->
</body></html>