Provided by: hylafax-client_4.4.4-7_i386 bug

NAME

       textfmt - convert text to POSTSCRIPT® for facsimile transmission

SYNOPSIS

       /usr/sbin/textfmt [ options ] [ files...  ]

DESCRIPTION

       textfmt  takes  ASCII text and generates formatted POSTSCRIPT® suitable
       for facsimile transmission.  It is usually invoked as a filter  program
       by the sendfax(1) program.  Input files may be specified on the command
       line.  If none are given, then textfmt will read from standard input.

       By default, textfmt will generate an output document that is  formatted
       with  a  single  vertical column of text, set in a 10 point fixed width
       font, and with a simple page header that consists  of  the  file  name,
       last  modification  date,  and  the  page  number.  Pages are generated
       according to the default  page  dimensions  (see  pagesizes(5)).   When
       multi-column output is requested, text is set by default with a 7 point
       fixed width font.

OPTIONS

       Many of the options to textfmt have been chosen for compatibility  with
       the  Adobe  Systems’  enscript  program; other options are for features
       that are not provided by enscript.

       -1     Set text in one column.

       -2     Set text two columns.

       -B     Suppress page headers.

       -c     Clip long text lines instead of wrapping them at page margins.

       -D     Do not use ISO 8859-1 encoding in the generated POSTSCRIPT.

       -f font
              Set text using the POSTSCRIPT font named font.

       -F fontdir(s)
              Path(s) to afm font files.

       -G     Use a gaudy-style page header.

       -m cols
              Set text in cols columns.

       -Ml=#,r=#,t=#,b=#
              Set the page margins; the default margins are:  left  and  right
              .25 inch, top .85 inch, bottom .5 inch.

       -o     Draw an outline around each column of text; the specified number
              defines the width of the line that is drawn.

       -p pts Set text using fonts with pts point size (integer only).

       -r     Set pages rotated by 90 degrees (in ‘‘Landscape mode’’).

       -R     Set pages unrotated (in ‘‘Portrait mode’’).

       -s size
              Set the output size according to the named  page  size.   Images
              are  normally  created  with a system-default page size (usually
              letter-size pages, 8.5" by 11", for  sites  in  North  America).
              Alternate page sizes are specified symbolically using either the
              name or abbreviation of an entry in the  pagesizes(5)  database;
              e.g.   a3  (ISO  A3),  a4 (ISO A4), a5 (ISO A5), a6 (ISO A6), b4
              (ISO B4),  na-let  (North  American  Letter),  us-leg  (American
              Legal),  us-led  (American Ledger), us-exe (American Executive),
              jp-let  (Japanese  Letter),   and   jp-leg   (Japanese   Legal).
              Comparisons are case-insensitive and any match of a substring of
              the full page-size name  is  sufficient;  e.g.  ‘‘legal’’  would
              match ‘‘American Legal’’.

       -U     Reverse  collate  pages; that is the last page will appear first
              in the resultant POSTSCRIPT, then the next-to-last page, etc.

       -V spacing
              Set the line height; the default height is 1.2 x point size.

CONFIGURATION PARAMETERS

       textfmt   reads    configuration    information    from    the    files
       /etc/hylafax/hyla.conf,  and  ~/.hylarc;  in that order.  Configuration
       files follow  the  conventions  described  in  hylafax-client(1).   The
       following configuration parameters are recognized:
       Tag  Type Default   Description
       Columns   integer   1    number of columns in formatted output
       GaudyHeaders   boolean   No   enable/disable guady page headers
       FontMap       string  see below location of ghostscript Fontmap file
       FontPath      string  see below directory for font metric files
       ISO8859   boolean   Yes  use ISO 8859-1 character encoding
       LineWrap  boolean   Yes  wrap/truncate text lines
       Orientation    string    portrait  orientation of text on page
       OutlineMargin  inches    0    width of outline line
       PageCollation  string    forward   collate pages in forward or reverse direction
       PageHeaders    boolean   Yes  enable/disable page headers
       PageHeight     float     -    output page height
       PageMargins    string    see below margins for formatted page
       PageSize  string    default   output page size from database
       PageWidth float     -    output page width
       TabStop   integer   8    inter-stop setting in characters
       TextFont  string    Courier   name of font for setting text
       TextLineHeight inches    -    text formatting line height control
       TextPointSize  inches    see below size to use in setting text

       The  configuration  parameters  are  explained  below.  Most parameters
       correspond to a command line option.  Parameter values identified above
       as  inches  are converted according to the following conventions (where
       ‘‘#.##’’ is a decimal number):
              #.##bp    big point (1in = 72bp)
              #.##cc    cicero (1cc = 12dd)
              #.##cm    centimeter
              #.##dd    didot point (1157dd = 1238pt)
              #.##in    inch
              #.##mm    millimeter (10mm = 1cm)
              #.##pc    pica (1pc = 12pt)
              #.##pt    point (72.27pt = 1in)
              #.##sp    scaled point (65536sp = 1pt)

       Unit names can be upper or lower case but no white space  is  permitted
       between  the  number  and  the unit.  Values specified with no unit are
       interpreted as big points.

       Columns        The number of columns to set text  in.   (Equivalent  to
                      the -m option.)

       FontMap        The  directory  or  directories  where  the  ghostscript
                      Fontmap  file(s)  are  located;   multiple   paths   are
                      separated by a colon (":"). The Fontmap table allows the
                      translation of the descriptive name of the font (as used
                      by  the  TextFont  parameter)  to  the  ghostscript font
                      filenames. Setting the value to "" (zero length  string)
                      disables  this  translation  and  provides functionality
                      with RIPs other than ghostscript.

       FontPath       The  path  where  Adobe  Font  Metric  (AFM)  files  are
                      located;   by   default  /usr/share/fonts/type1/gsfonts.
                      (Equivalent to the -F option.)

       GaudyHeaders   Control whether or not to use a gaudy-style page header.
                      (Equivalent to the -G option.)

       ISO8859        Control  the use of ISO 8859-1 encoding in the generated
                      POSTSCRIPT (Equivalent to the -D option.)

       LineWrap       Control whether long text lines are wrapper or truncated
                      at  the  right  hand  margin.   (Equivalent  to  the  -c
                      option.)

       Orientation    Control  whether   pages   are   oriented   horizontally
                      (‘‘landscape’’)     or     vertically    (‘‘portrait’’).
                      (Equivalent to the -r and -R options.)

       OutlineMargin  Control whether columns of text have a line drawn around
                      them  and the width of the line.  Setting this parameter
                      to 0 disables outlines.  (Equivalent to the -o  option.)

       PageCollation  Control  whether  the  output file has pages collated in
                      the same order as the input  file  (‘‘forward’’)  or  in
                      reverse   order  (‘‘reverse).   (Equivalent  to  the  -U
                      option.)

       PageHeaders    Control whether page headers are generated.  (Equivalent
                      to the -B option.)

       PageHeight     Set the output page height in inches (in inches).

       PageMargins    Set   the   output   page  dimensions.   Dimensions  are
                      specified as string  of  the  form:  ‘‘l=#,r=#,t=#,b=#’’
                      where l indicates the left margin, r indicates the right
                      margin, t indicates the  top  margin,  b  indicates  the
                      bottom  margin,  and  numbers are interpreted as inches.
                      (Equivalent to the -M option.)

       PageSize       Set the output page dimensions by name.  (Equivalent  to
                      the -s option.)

       PageWidth      Set the output page width in inches (in inches).

       TabStop        Set the tab stop distance; in characters.

       TextFont       Set  the  descriptive  name  of  font to use for setting
                      text.  (Equivalent to the -f option.)

       TextLineHeight Set  the  vertical  text  line   height   and   spacing.
                      (Equivalent to the -V option.)

       TextPointSize  Set  the point size to use in setting text.  (Equivalent
                      to the -p option.)

NOTES

       If textfmt is unable to locate font metric information for a font, then
       it  will  use  a fixed-width metric that is 60% of the text point size;
       this metric will  almost  certainly  result  in  incorrectly  formatted
       POSTSCRIPT.

       textfmt  is  distantly  related  to  the  lptops program written by Don
       Beebe.

FILES

       /etc/hylafax/hyla.conf    system-wide configuration file
       ~/.hylarc                 per-user configuration file
       /etc/hylafax/pagesizes    page size database
       /usr/share/fonts/type1/gsfonts   font metric files

SEE ALSO

       hylafax-client(1), sendfax(1), pagesizes(5)

                                 May 17, 1996                       TEXTFMT(1)