aboutsummaryrefslogtreecommitdiff
path: root/man/man4/fontsrv.4
blob: 7344cde9628b70e10e1109ce055d8869e252c80c (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
.TH FONTSRV 4
.SH NAME
fontsrv \- file system access to host fonts
.SH SYNOPSIS
.B fontsrv
[
.B -m
.I mtpt
]
[
.B -s
.I srvname
]
.PP
.B fontsrv
.B -p
.I path
.SH DESCRIPTION
.I Fontsrv
presents the host window system's fonts
in the standard Plan 9 format
(see
.IR font (7)).
It serves a virtual directory tree mounted at
.I mtpt
(if the
.B -m
option is given)
and posted at
.I srvname
(default
.IR font ).
.PP
The 
.B -p
option changes 
.IR fontsrv 's
behavior: rather than serve a file system,
.I fontsrv
prints to standard output the contents of the named 
.IR path .
If
.I path
names a directory in the served file system,
.I fontsrv
lists the directory's contents.
.PP
The fonts are arranged in a two-level tree.
The root contains directories named for each system font.
Each font directory contains subdirectories named for
a point size and whether the subfonts are anti-aliased:
.B 10
(bitmap)
.BR 10a
(anti-aliased greyscale)
.BR 12 ,
.BR 12a ,
and so on.
The font directory will synthesize additional sizes on
demand: looking up
.B 19a
will synthesize the 19-point anti-aliased size
if possible.
Each size directory contains a
.B font
file and subfont files
named
.BR x0000.bit ,
.BR x0100.bit ,
and so on
representing 256-character Unicode ranges.
.PP
.I Openfont
(see
.IR graphics (3))
recognizes font paths beginning with 
.B /mnt/font
and implements them by invoking
.IR fontsrv ;
it need not be running already.
See 
.IR font (7)
for a full discussion of font name syntaxes.
.SH EXAMPLES
List the fonts on the system:
.IP
.EX
% fontsrv &
% 9p ls font
.EE
.LP
or:
.IP
.EX
% fontsrv -p .
.EE
.LP
Run 
.IR acme (1)
using the operating system's Monaco as the fixed-width font:
.IP
.EX
% acme -F /mnt/font/Monaco/13a/font
.EE
.LP
Run
.IR sam (1)
using the same font:
.IP
.EX
% font=/mnt/font/Monaco/13a/font sam
.EE
.SH SOURCE
.B \*9/src/cmd/fontsrv
.SH SEE ALSO
.IR font (7)
.SH BUGS
.PP
Due to OS X restrictions,
.I fontsrv
does not fork itself into the background
when serving a user-level file system.
.PP
.I Fontsrv
has no support for X11 fonts;
on X11 systems, it will serve an empty top-level directory.
.PP
On OS X, the anti-aliased bitmaps are not perfect.
For example, the lower case r in the subfont
.B Times-Roman/14a/x0000.bit
appears truncated on the right and
too light overall.