NAME

       update-xfonts-traditional - generate traditional ASCII fixed-with fonts

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.

EXIT STATUS

       0      All went well and there were no warnings.

       2      With --bdf-filter and --process-pcf only, indicates that the input font did not need to be edited,
              or was not suitable for editing, and has not been written out, so the output  is  incomplete,  but
              this is not an error.

       any other
              There were problems.

BUGS

       Only  the  6x13 font conventionally called supported.  This package comes too late to rescue Unix from an
       incompatible change to its character set.