Commit | Line | Data |
---|---|---|
a0ceefde IJ |
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. |