| 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. |