Table of contents

• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS
• CONFIGURATION PARAMETERS
• NOTES
• FILES
• SEE ALSO

NAME

SYNOPSIS

DESCRIPTION

By default, textfmt will generate an output document that is formtted 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

-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 encoding in the generated \*(Ps.

-f font

Set text using the \*(Ps font named font.

-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.

-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 \*(Ps, then the next-to-last page, etc.

-V spacing

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

CONFIGURATION PARAMETERS

Tag	Type	Default	Description
Columns	integer	\s-11\s+1	number of columns in formatted output
FontDir	string	\s-1see below\s+1	directory for font metric files
GaudyHeaders	boolean	\s-1No\s+1	enable/disable guady page headers
ISO8859	boolean	\s-1Yes\s+1	use ISO 8859-1 character encoding
LineWrap	boolean	\s-1Yes\s+1	wrap/truncate text lines
Orientation	string	\s-1portrait\s+1	orientation of text on page
OutlineMargin	inches	\s-10\s+1	width of outline line
PageCollation	string	\s-1forward\s+1	collate pages in forward or reverse direction
PageHeaders	boolean	\s-1Yes\s+1	enable/disable page headers
PageHeight	float	-	output page height
PageMargins	string	\s-1see below\s+1	margins for formatted page
PageSize	string	\s-1default\s+1	output page size from database
PageWidth	float	-	output page width
TabStop	integer	\s-18\s+1	inter-stop setting in characters
TextFont	string	\s-1Courier\s+1	name of font for setting text
TextLineHeight	inches	-	text formatting line height control
TextPointSize	inches	\s-1see below\s+1	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 points.

Columns

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

FontDir

The directory where Adobe Font Metric (\s-1AFM\s+1) files are located; by default /usr/local/lib/fax/afm.

GaudyHeaders

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

ISO8859

Control the use of encoding in the generated \*(Ps (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. (Equvalent 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 name of font to use for setting text. (Equivalent to the -f option.)

TextLineHeight

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

TextPointSize

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

NOTES

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

FILES

/usr/local/lib/fax/hyla.conf	system-wide configuration file
~/.hylarc	per-user configuration file
/usr/local/lib/fax/pagesizes	page size database
/usr/local/lib/fax/afm	font metric files

SEE ALSO