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.