NAME

fontsampler - make sample pages from PostScript fonts

SYNOPSIS

fontsampler [options] [PostScript font files ...]

Options:
  -details		show font details instead of samples
  -align		align to double page (only with -details)
  -manualfeed		manual feed paper
  -title XXX		descriptive title
  -include		include the font definition (default)
  -ident		show identification
  -help		brief help message
  -man                 full documentation
  -verbose		verbose information

DESCRIPTION

fontsampler writes a PostScript document to standard output to make sample pages of PostScript fonts.

The program takes, as command line arguments, PostScript font files. Each of These files should contain an ASCII encoded font (a so called .pfa file), or a binary encoded font (a so called .pfb file).

The resultant PostScript document conforms to Adobe's Document Structuring Conventions (DSC), version 3.0.

The program can run in one of two modes, depending on the -details option. Without this option, from every font the name and a small sample of characters is printed, up to 50 font samples per page.

With the -details option, every font gets at least one page of output. These pages contain detailed information about all the glyphs that are present in the font, starting with the glyphs as defined in the ISO Latin1 encoding, and followed by the glyphs are not part of this encoding. Each page can take up to 256 glyphs.

OPTIONS

-details

Enable detailed output.

-align

With -details, start every new font on an even page. Useful for n-up processing and duplex printing.

-manualfeed

Manual feed is requested when the job is printed. Requires a printer that can handle PostScript Level 2 of above.

-title XXX

A descriptive title that is printed on top of each page.

-[no]include

When enabled, the font definitions are inserted in the PostScript output. This results in a self-contained PostScript document that can be printed directly.

When disabled, DSC comments are inserted in the output that need to be processed by a suitable print manager (unless all fonts are resident in the printer).

-incldue is enabled by default.

-help

Print a brief help message and exits.

-ident

Prints program identification.

-verbose

More verbose information.

BUGS AND PROBLEMS

If a font is shown in a one-page detail page, and it gets substituted by a multi-page font, the PostScript engine will crash. This usually happens if the font cannot be found, and the PostScript engine substitutes the (multi-page) Courier font.

AUTHOR

Johan Vromans, Squirrel Consultancy <jvromans@squirrel.nl>

COPYRIGHT and DISCLAIMER

This program is Copyright 1990,1999 by Johan Vromans. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

If you do not have a copy of the GNU General Public License write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.