cedilla(1) · carta

Usage

cedilla [-fs fontset] [-p papersize] [-s size] [-bs baselineskip] [-w] [-h header] [-hb header-baseline] [-f footer] [-fb footer-baseline] infile [outfile]

Overview

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.

Options

-fs fontset: Use the list of fonts specified by fontset. The set of available fontsets is listed in the file /etc/cedilla-config.lisp.

-p papersize: Use the paper size specified by papersize (default A4). The set of available paper sizes is listed in the file /etc/cedilla-config.lisp.

-s size: Set the font size to size points (default 11).

-bs baselineskip: Separate lines by baselineskip (by default, equal to size).

-w: Enable line wrapping.

-h header: Set the header format to header. See HEADER AND FOOTER FORMATS below.

-hb header-baseline: Set the header's baseline to be at a distance of header-baseline (default 1cm) of the top of the page. The argument must be a number in points.

-f footer: Set the footer format to header. See HEADER AND FOOTER FORMATS below.

-fb footer-baseline: Set the footer's baseline to be at a distance of header-baseline of the top of the page.

-v: Be verbose about unprintable characters.

-l: List all glyphs known to Cedilla in the current fontset.

-V: Display the version of Cedilla and exit.

-?: Print a short help message and exit.

Files

/etc/cedilla-config.lisp: the system-wide configuration file for Cedilla.

Header and footer format

The format passed to the -h and -f options is of the form

[left,]center[,right]: where left, center and right are strings that may contain any of the following sequences:

%% typeset a percent sign

%, typeset a comma

%p typeset the page number as an Arabic number

%P typeset the page number in words

%r typeset the page number as a small Roman number

%R typeset the page number as a Roman number

Notes

By design, Cedilla only accepts input data in UTF-8. You are expected to use an external converter such as iconv(1) or luit(1) in order to print text encoded in a legacy encoding.

Cedilla is unable to print data that comes from a pipe; this is unavoidable, as Cedilla makes two passes over its input file.