1 .TH FONTSRV 4
2 .SH NAME
3 fontsrv \- file system access to host fonts
4 .SH SYNOPSIS
5 .B fontsrv
6 [
7 .B -m
8 .I mtpt
9 ]
10 [
11 .B -s
12 .I srvname
13 ]
14 .PP
15 .B fontsrv
16 .B -p
17 .I path
18 .SH DESCRIPTION
19 .I Fontsrv
20 presents the host window system's fonts
21 in the standard Plan 9 format
22 (see
23 .MR font (7) ).
24 It serves a virtual directory tree mounted at
25 .I mtpt
26 (if the
27 .B -m
28 option is given)
29 and posted at
30 .I srvname
31 (default
32 .IR font ).
33 .PP
34 The
35 .B -p
36 option changes
37 .IR fontsrv 's
38 behavior: rather than serve a file system,
39 .I fontsrv
40 prints to standard output the contents of the named
41 .IR path .
42 If
43 .I path
44 names a directory in the served file system,
45 .I fontsrv
46 lists the directory's contents.
47 .PP
48 The fonts are arranged in a two-level tree.
49 The root contains directories named for each system font.
50 Each font directory contains subdirectories named for
51 a point size and whether the subfonts are anti-aliased:
52 .B 10
53 (bitmap)
54 .BR 10a
55 (anti-aliased greyscale)
56 .BR 12 ,
57 .BR 12a ,
58 and so on.
59 The font directory will synthesize additional sizes on
60 demand: looking up
61 .B 19a
62 will synthesize the 19-point anti-aliased size
63 if possible.
64 Each size directory contains a
65 .B font
66 file and subfont files
67 named
68 .BR x0000.bit ,
69 .BR x0020.bit ,
70 and so on
71 representing 32-character Unicode ranges.
72 .PP
73 .I Openfont
74 (see
75 .MR graphics (3) )
76 recognizes font paths beginning with
77 .B /mnt/font
78 and implements them by invoking
79 .IR fontsrv ;
80 it need not be running already.
81 See
82 .MR font (7)
83 for a full discussion of font name syntaxes.
84 .SH EXAMPLES
85 List the fonts on the system:
86 .IP
87 .EX
88 % fontsrv &
89 % 9p ls font
90 .EE
91 .LP
92 or:
93 .IP
94 .EX
95 % fontsrv -p .
96 .EE
97 .LP
98 Run
99 .MR acme (1)
100 using the operating system's Monaco as the fixed-width font:
101 .IP
102 .EX
103 % acme -F /mnt/font/Monaco/13a/font
104 .EE
105 .LP
106 Run
107 .MR sam (1)
108 using the same font:
109 .IP
110 .EX
111 % font=/mnt/font/Monaco/13a/font sam
112 .EE
113 .SH SOURCE
114 .B \*9/src/cmd/fontsrv
115 .SH SEE ALSO
116 .MR font (7)
117 .SH BUGS
118 .PP
119 Due to OS X restrictions,
120 .I fontsrv
121 does not fork itself into the background
122 when serving a user-level file system.
123 .PP
124 .I Fontsrv
125 has no support for X11 fonts;
126 on X11 systems, it will serve an empty top-level directory.
127 .PP
128 On OS X, the anti-aliased bitmaps are not perfect.
129 For example, the lower case r in the subfont
130 .B Times-Roman/14a/x0000.bit
131 appears truncated on the right and
132 too light overall.