~ubuntu-branches/ubuntu/dapper/cedilla/dapper

.TH CEDILLA 1

.SH NAME

cedilla \- a best-effort text printer

.SH SYNOPSIS

.B cedilla

.RB [ \-fs

.IR fontset ]

.RB [ \-p

.IR papersize ]

.RB [ \-s

.IR size ]

.RB [ \-bs

.IR baselineskip ]

.RB [ \- w ]

.RB [ \-h

.IR header ]

.RB [ \-hb

.IR header\-baseline ]

.RB [ \-f

.IR footer ]

.RB [ \-fb

.IR footer\-baseline ]

infile 

.RI [ outfile ]

.SH DESCRIPTION

.B Cedilla

is a text printer that uses Unicode internally and will make heroic

efforts to find or design suitable glyphs for exotic or rare characters.

.SH OPTIONS

.TP 8

.BI \-fs " fontset"

Use the list of fonts specified by

.IR fontset .

The set of available fontsets is listed in the file

.BR /etc/cedilla\-config.lisp .

.TP 8

.BI \-p " papersize"

Use the paper size specified by

.I papersize

(default

.BR A4 ).

The set of available paper sizes is listed in the file

.BR /etc/cedilla\-config.lisp .

.TP 8

.BI \-s " size"

Set the font size to

.I size

points

(default 11).

.TP 8

.BI \-bs " baselineskip"

Separate lines by

.I baselineskip

(by default, equal to 

.IR size ).

.TP 8

.BI \-w

Enable line wrapping.

.TP 8

.BI \-h " header"

Set the header format to 

.IR header .

See HEADER AND FOOTER FORMATS below.

.TP 8

.BI \-hb " header\-baseline"

Set the header's baseline to be at a distance of

.I header-baseline

(default 1cm)

of the top of the page.  The argument must be a number in points.

.TP 8

.BI \-f " footer"

Set the footer format to 

.IR header .

See HEADER AND FOOTER FORMATS below.

.TP 8

.BI \-fb " footer\-baseline"

Set the footer's baseline to be at a distance of

.I header\-baseline

of the top of the page.

.TP 8

.B \-v

Be verbose about unprintable characters.

.TP 8

.B \-l

List all glyphs known to Cedilla in the current fontset.

.TP 8

.B \-V

Display the version of Cedilla and exit.

.TP 8

.B \-?

Print a short help message and exit.

.SH FILES

.TP 5

.B /etc/cedilla\-config.lisp

the system\-wide configuration file for

.BR Cedilla .

.SH HEADER AND FOOTER FORMAT

The format passed to the

.B \-h

and

.B \-f

options is of the form

.TP 8

.RI [ left ,] center [, right ]

where 

.IR left ,

.I center

and

.I right

are strings that may contain any of the following sequences:

.TP 8

.BR %% " typeset a percent sign"

.TP 8

.BR %, " typeset a comma"

.TP 8

.BR %p " typeset the page number as an Arabic number"

.TP 8

.BR %P " typeset the page number in words"

.TP 8

.BR %r " typeset the page number as a small Roman number"

.TP 8

.BR %R " typeset the page number as a Roman number"

.SH NOTES

By design,

.B Cedilla

only accepts input data in UTF\-8.  You are expected to use an external

converter such as 

.BR iconv (1)

or

.BR luit (1)

in order to print text encoded in a legacy encoding.

.B Cedilla

is unable to print data that comes from a pipe; this is unavoidable,

as

.B Cedilla

makes two passes over its input file.

.SH AUTHOR

.B Cedilla

was written by Juliusz Chroboczek <jch@pps.jussieu.fr>.

.SH SEE ALSO

.BR iconv (1),

.BR luit (1),

.BR a2ps (1),

.BR enscript (1),

.BR ogonkify (1),

.BR lpr (1).