.\" -*- nroff -*-
.TH fntsample 1 @DATE@
.SH NAME
fntsample \- PDF and PostScript font samples generator
\" macros
.de SAMPLE
.br
.RS
.nf
.nh
..
.de ESAMPLE
.hy
.fi
.RE
..
.SH SYNOPSIS
.B fntsample
.BI "[ " OPTIONS " ]"
.BI "\-f " FONT-FILE " \-o " OUTPUT-FILE
.br
.B fntsample \-h
.SH DESCRIPTION
.B fntsample
program can be used to generate font samples that show Unicode coverage
of the font and are similar in appearance to Unicode charts. Samples can be saved
into PDF (default) or PostScript file.
.SH OPTIONS
.B fntsample
supports the following options.
.TP
.BI "\-f " FONT-FILE
Make samples of 
.I FONT-FILE
.TP
.BI "\-o " OUTPUT-FILE
Write output to 
.I OUTPUT-FILE
.TP
.BI "-d " OTHER-FONT
Compare
.I FONT-FILE
with
.IR OTHER-FONT .
Glyphs added to
.I FONT-FILE
will be highlighted.
.TP
.BI \-s
Use PostScript format for output instead of PDF.
.TP
.BI \-l
Print document outlines data to standard output.
This data can be used to add outlines (aka bookmarks) to resulting PDF file with \fBpdfoutline\fP program.
.TP
.BI "\-h"
Display help text and exit
.SH EXAMPLES
.RI "Make PDF samples for " font.ttf " and write them to file " samples.pdf :
.SAMPLE
fntsample -f font.ttf -o samples.pdf
.ESAMPLE
.PP
.RI "Make PDF samples for " font.ttf ", compare it with " oldfont.ttf 
.RI "and highlight new glyphs. Write output to file " samples.pdf :
.SAMPLE
fntsample -f font.ttf -d oldfont.ttf -o samples.pdf
.ESAMPLE
.PP
.RI "Make PostScript samples for " font.ttf " and write output to file " samples.ps :
.SAMPLE
fntsample -f font.ttf -s -o samples.ps
.ESAMPLE
.PP
.RI "Make PDF samples for " font.ttf " and save output to file " samples.pdf " adding outlines to it:"
.SAMPLE
fntsample -f font.ttf -o temp.pdf -l > outlines.txt
pdfoutline temp.pdf outlines.txt samples.pdf
.ESAMPLE
.SH AUTHOR
Copyright \(co 2007 Eugeniy Meshcheryakov <eugen@debian.org>
.br
Homepage: <http://sourceforge.net/projects/fntsample>
.SH SEE ALSO
.PP
.BR pdfoutline (1)