Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
TEXTFMT(1)		    General Commands Manual		    TEXTFMT(1)

       textfmt - convert text to POSTSCRIPT(R) for facsimile transmission

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

       textfmt takes ASCII text	and generates formatted	POSTSCRIPT(R) 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 ac-
       cording to the  default	page  dimensions  (see	pagesizes(5F)).	  When
       multi-column output is requested, text is set by	default	with a 7 point
       fixed width font.

       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.

	      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(5F)  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  Le-
	      gal), 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 ``Amer-
	      ican 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.

       textfmt	reads  configuration  information  from	 the  files   /usr/lo-
       cal/lib/fax/hyla.conf,  and  ~/.hylarc;	in  that order.	 Configuration
       files follow the	conventions described in hylafax-client(1).  The  fol-
       lowing 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 cor-
       respond 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 in-
       terpreted 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	 sepa-
		      rated  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 file-
		      names. Setting the value to "" (zero length string) dis-
		      ables  this  translation and provides functionality with
		      RIPs other than ghostscript.

       FontPath	      The path where Adobe Font	Metric	(AFM)  files  are  lo-
		      cated; by	default	/usr/local/lib/afm. (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 op-

       Orientation    Control whether pages are	oriented horizontally (``land-
		      scape'')	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 re-
		      verse 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	speci-
		      fied 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  mar-
		      gin, 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.  (Equiva-
		      lent to the -V option.)

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

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

       textfmt	is  distantly  related	to  the	 lptops	program	written	by Don

       /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/afm   font metric	files

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

				 May 17, 1996			    TEXTFMT(1)


Want to link to this manual page? Use this URL:

home | help