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 .IR 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 x0100.bit ,
70 and so on
71 representing 256-character Unicode ranges.
72 .PP
73 .I Openfont
74 (see
75 .IR 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 .SH EXAMPLES
82 List the fonts on the system:
83 .IP
84 .EX
85 % fontsrv &
86 % 9p ls font
87 .EE
88 .LP
89 or:
90 .IP
91 .EX
92 % fontsrv -p .
93 .EE
94 .LP
95 Run 
96 .IR acme (1)
97 using the operating system's Monaco as the fixed-width font:
98 .IP
99 .EX
100 % acme -F /mnt/font/Monaco/13a/font
101 .EE
102 .LP
103 Run
104 .IR sam (1)
105 using the same font:
106 .IP
107 .EX
108 % font=/mnt/font/Monaco/13a/font sam
109 .EE
110 .SH SOURCE
111 .B \*9/src/cmd/fontsrv
112 .SH SEE ALSO
113 .IR font (7)
114 .SH BUGS
115 .PP
116 Due to OS X restrictions,
117 .I fontsrv
118 does not fork itself into the background
119 when serving a user-level file system.
120 .PP
121 .I Fontsrv
122 has no support for X11 fonts;
123 on X11 systems, it will serve an empty top-level directory.
124 .PP
125 On OS X, the anti-aliased bitmaps are not perfect.
126 For example, the lower case r in the subfont
127 .B Times-Roman/14a/x0000.bit
128 appears truncated on the right and
129 too light overall.
130