.\" Process this file with
.\" groff -man -Tascii trbdf.1
.\"
.TH trbdf 1 "NOV 2002" trscripts "User Manuals"
.SH NAME
trbdf \- convert BDF-font from one encoding to other
.SH SYNOPSIS
.B trbdf -C | -l | -h

.B trbdf [-s] [-f
.I input-codeset
.B ] [-t
.I output-codeset
.B ] [--foundry[=]
.I new-foundry
.B ]
.I BDF-font
.SH DESCRIPTION
.B trbdf
is a program for translation of BDF fonts from one encoding to other.
One exciting feature of
.B trbdf
is that it tries to approximate the symbols that miss from the font or
from the encoding of the font with existing symbols when possible.

If the option
.B -s
or
.B --gen-script
is given
.B trbdf
will generate an
.BR awk (1)
script for translation of BDF-fonts for fixed combination of
.I input-codeset
and
.I output-codeset
This is useful for faster convertion of many files.  This script is
used as filter.

If none of 
.BR \-C,
.BR \-s,
.BR \-l,
.BR \-h
and their equivalents is given the
.I BDF-font
will be read assuming it is coded with codeset
.I "input-codeset"
On standard output it will be recoded so to use codeset
.I "output-codeset"
Both
.I "input-codeset"
and
.I "output-codeset"
are case insensitive and default to `cp1251'.
.SH OPTIONS
.IP "-C, --copyright"
Display copying conditions and warranty information.
.IP "-s, --gen-script"
Generates conversion script for given input and output encodings
instead to convert BDF-font.  This option is usefull if you have to
convert many fonts.  The generated script expects the input font from
its standard input and outputs the converted font.
.IP "-l, --list"
List all known codesets.
.IP "-h, --help"
Display this help and exit.
.IP "-f input-codeset, --from[=]input-codeset"
Codeset of the source font.
.IP "-f output-codeset, --to[=]output-codeset"
Codeset of the generated font.
.IP "--foundry[=]new-foundry"
Use this option if you want to change the foundry of the generated
fonts.
.SH AUTHOR
Anton Zinoviev <anton@lml.bas.bg>, <zinoviev@fmi.uni-sofia.bg>
.SH "SEE ALSO"
.BR bdftopcf (1x)