aboutsummaryrefslogtreecommitdiff
path: root/man/man4/fontsrv.4
blob: 3052ffe2fcca4d7eeb6afcc9e8fabf555f622a51 (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
.TH FONTSRV 4
.SH NAME
fontsrv \- file system access to host fonts
.SH SYNOPSIS
.B fontsrv
[
.B -m
.I mtpt
]
.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 
.I 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.
.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.