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