SYNOPSIS

update-xfonts-traditional --bdf-filter

update-xfonts-traditional --process-pcf in.pcf.gz out.pcf.gz

update-xfonts-traditional --process-fontdirs fontdir ...

update-xfonts-traditional --process-fonttrees fonttree ...

DESCRIPTION

update-xfonts-traditional generates versions of X11 PCF fonts which have been edited to restore compatibility with traditional versions of US-ASCII, and to restore some of the glyphs to more traditional appearance.

MODES

--bdf-filter

Takes a BDF on standard input and tries to generate an edited BDF on standard output.

--process-pcf

Takes to PCF filename arguments; the input PCF is uncompressed, decompiled to a BDF, processed, recompiled to a PCF and recompressed.

--process-fontdirs

In each fontdir all files font.pcf.gz are processed, to generate where applicable corresponding trad--font.pcf.gz files. The mtime, ctime and inode number of the input files are recorded so that reprocessing the same directory later will be fast.

--process-fonttrees

Each fonttree is searched for font directories which are processed as above.

--update

Each built in font tree location is searched for font directories which are processed as above.

OPTIONS

-R|--rules-path rulespath

Prepend rulespath to the path of directories from which to load glyph editing rules.

--share-dir share-dir

Use share-dir instead of /usr[/local]/share/xfonts-traditional.

--parallel|-j cpus

Use up to cpus cores for processing fonts. The default is all the cpus available.

--always-reprocess

When scanning font directories, always reprocess all the fonts, regardless of whether we think they have been done already.

--no-tolerate-bad-fonts

Treat bad input fonts (eg, ones for which pcf2bdf crashes, or ones with other problems) as a fatal error. Normally they just produce a warning.

FILES

xfonts-traditional.done

In each font directory, records information about processed fonts, so as to optimise away unnecessary reprocessing.

xfonts-traditional.log

In each font directory, records a lot of which fonts were processed and to a certain extent if not why not.

/usr/share/fonts/X11 /usr/local/share/fonts/X11

Default font tree paths for --update.

trad--font.pcf.gz

In any font directory, our output files. Any other files matching this pattern may be overwritten or deleted.