tfontsrv.4 - plan9port - [fork] Plan 9 from user space
 (HTM) git clone git://src.adamsgaard.dk/plan9port
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       tfontsrv.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.