fontsrv.4 (2298B)
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.