chiark / gitweb /
wip
[xfonts-traditional] / update-xfonts-traditional.8
1 .\" Hey, Emacs!  This is an -*- nroff -*- source file.
2 .TH UPDATE\-XFONTS\-TRADITIONAL 8 "2012" "Greenend" "chiark utilities"
3 .SH NAME
4 update\-xfonts\-traditional \- generate traditional ASCII fixed-with fonts
5 .SH SYNOPSIS
6 .B update\-xfonts\-traditional --bdf-filter
7 .LP
8 .B update\-xfonts\-traditional --process-pcf \fIin.pcf.gz\fP \fIout.pcf.gz\fP
9 .LP
10 .B update\-xfonts\-traditional --process-fontdirs \fIfontdir\fR ...
11 .LP
12 .B update\-xfonts\-traditional --process-fonttrees \fIfonttree\fR ...
13 .SH DESCRIPTION
14 .B update\-xfonts\-traditional
15 generates versions of X11 PCF fonts which have been edited to restore
16 compatibility with traditional versions of US-ASCII, and to restore
17 some of the glyphs to more traditional appearance.
18 .SH MODES
19 .TP
20 .BI --bdf-filter
21 Takes a BDF on standard input and tries to generate an edited BDF on
22 standard output.
23 .TP
24 .BI --process-pcf
25 Takes to PCF filename arguments; the input PCF is uncompressed,
26 decompiled to a BDF, processed, recompiled to a PCF and recompressed.
27 .TP
28 .BI --process-fontdirs
29 In each
30 .I fontdir
31 all files
32 .IB font .pcf.gz
33 are processed, to generate where applicable corresponding
34 .BI trad-- font .pcf.gz
35 files.  The mtime, ctime and inode number of the input files are
36 recorded so that reprocessing the same directory later will be fast.
37 .TP
38 .BI --process-fonttrees
39 Each
40 .I fonttree
41 is searched for font directories which are processed as above.
42 .TP
43 .BI --update
44 Each built in font tree location is searched for font directories
45 which are processed as above.
46 .SH OPTIONS
47 .TP
48 \fB-R\fP|\fB--rules-path\fP \fIrulespath\fP
49 Prepend
50 .I rulespath
51 to the path of directories from which to load glyph editing rules.
52 .TP
53 \fB--share-dir\fP \fIshare-dir\fP
54 Use
55 .I share-dir
56 instead of
57 .BR "/usr[/local]/share/xfonts-traditional" .
58 .SH FILES
59 .TP
60 .B xfonts-traditional.done
61 In each font directory, records information about processed fonts, so
62 as to optimise away unnecessary reprocessing.
63 .TP
64 .B xfonts-traditional.log
65 In each font directory, records a lot of which fonts were processed
66 and to a certain extent if not why not.
67 .TP
68 .B /usr/share/fonts/X11 /usr/local/share/fonts/X11
69 Default font tree paths for --update.
70 .TP
71 .BI trad-- font .pcf.gz
72 In any font directory, our output files.  Any other files matching
73 this pattern may be overwritten or deleted.
74 .SH EXIT STATUS
75 .TP
76 .B 0
77 All went well and there were no warnings.
78 .TP
79 .B 2
80 With
81 .B --bdf-filter
82 and
83 .B --process-pcf
84 only, indicates that the input font did not need to
85 be edited, or was not suitable for editing, and has
86 .B not
87 been written out, so the output is incomplete, but this is not an
88 error.
89 .TP
90 any other
91 There were problems.
92 .SH BUGS
93 Only the 6x13 font conventionally called \"fixed\" is currently
94 supported.  This package comes too late to rescue Unix from an
95 incompatible change to its character set.