1
by Peter Van Eynde
Import upstream version 0.5 |
1 |
.TH CEDILLA 1 |
2 |
.SH NAME |
|
3 |
cedilla \- a best-effort text printer
|
|
4 |
.SH SYNOPSIS |
|
5 |
.B cedilla |
|
6 |
.RB [ \-fs |
|
7 |
.IR fontset ] |
|
8 |
.RB [ \-p |
|
9 |
.IR papersize ] |
|
10 |
.RB [ \-s |
|
11 |
.IR size ] |
|
12 |
.RB [ \-bs |
|
13 |
.IR baselineskip ] |
|
14 |
.RB [ \- w ] |
|
15 |
.RB [ \-h |
|
16 |
.IR header ] |
|
17 |
.RB [ \-hb |
|
18 |
.IR header\-baseline ] |
|
19 |
.RB [ \-f |
|
20 |
.IR footer ] |
|
21 |
.RB [ \-fb |
|
22 |
.IR footer\-baseline ] |
|
23 |
infile |
|
24 |
.RI [ outfile ] |
|
25 |
.SH DESCRIPTION |
|
26 |
.B Cedilla |
|
27 |
is a text printer that uses Unicode internally and will make heroic |
|
28 |
efforts to find or design suitable glyphs for exotic or rare characters. |
|
29 |
.SH OPTIONS |
|
30 |
.TP 8 |
|
31 |
.BI \-fs " fontset" |
|
32 |
Use the list of fonts specified by |
|
33 |
.IR fontset . |
|
34 |
The set of available fontsets is listed in the file |
|
35 |
.BR /etc/cedilla\-config.lisp . |
|
36 |
.TP 8 |
|
37 |
.BI \-p " papersize" |
|
38 |
Use the paper size specified by |
|
39 |
.I papersize |
|
40 |
(default |
|
41 |
.BR A4 ). |
|
42 |
The set of available paper sizes is listed in the file |
|
43 |
.BR /etc/cedilla\-config.lisp . |
|
44 |
.TP 8 |
|
45 |
.BI \-s " size" |
|
46 |
Set the font size to |
|
47 |
.I size |
|
48 |
points |
|
49 |
(default 11). |
|
50 |
.TP 8 |
|
51 |
.BI \-bs " baselineskip" |
|
52 |
Separate lines by |
|
53 |
.I baselineskip |
|
54 |
(by default, equal to |
|
55 |
.IR size ). |
|
56 |
.TP 8 |
|
57 |
.BI \-w |
|
58 |
Enable line wrapping. |
|
59 |
.TP 8 |
|
60 |
.BI \-h " header" |
|
61 |
Set the header format to |
|
62 |
.IR header . |
|
63 |
See HEADER AND FOOTER FORMATS below. |
|
64 |
.TP 8 |
|
65 |
.BI \-hb " header\-baseline" |
|
66 |
Set the header's baseline to be at a distance of |
|
67 |
.I header-baseline |
|
68 |
(default 1cm) |
|
69 |
of the top of the page. The argument must be a number in points. |
|
70 |
.TP 8 |
|
71 |
.BI \-f " footer" |
|
72 |
Set the footer format to |
|
73 |
.IR header . |
|
74 |
See HEADER AND FOOTER FORMATS below. |
|
75 |
.TP 8 |
|
76 |
.BI \-fb " footer\-baseline" |
|
77 |
Set the footer's baseline to be at a distance of |
|
78 |
.I header\-baseline |
|
79 |
of the top of the page. |
|
80 |
.TP 8 |
|
81 |
.B \-v |
|
82 |
Be verbose about unprintable characters. |
|
83 |
.TP 8 |
|
84 |
.B \-l |
|
85 |
List all glyphs known to Cedilla in the current fontset. |
|
86 |
.TP 8 |
|
87 |
.B \-V |
|
88 |
Display the version of Cedilla and exit. |
|
89 |
.TP 8 |
|
2
by Peter Van Eynde
* Cleared up description |
90 |
.B \-? |
1
by Peter Van Eynde
Import upstream version 0.5 |
91 |
Print a short help message and exit. |
92 |
.SH FILES |
|
93 |
.TP 5 |
|
94 |
.B /etc/cedilla\-config.lisp |
|
95 |
the system\-wide configuration file for
|
|
96 |
.BR Cedilla . |
|
97 |
.SH HEADER AND FOOTER FORMAT |
|
98 |
The format passed to the |
|
99 |
.B \-h |
|
100 |
and |
|
101 |
.B \-f |
|
102 |
options is of the form |
|
103 |
.TP 8 |
|
104 |
.RI [ left ,] center [, right ] |
|
105 |
where |
|
106 |
.IR left , |
|
107 |
.I center |
|
108 |
and |
|
109 |
.I right |
|
110 |
are strings that may contain any of the following sequences: |
|
111 |
.TP 8 |
|
112 |
.BR %% " typeset a percent sign" |
|
113 |
.TP 8 |
|
114 |
.BR %, " typeset a comma" |
|
115 |
.TP 8 |
|
116 |
.BR %p " typeset the page number as an Arabic number" |
|
117 |
.TP 8 |
|
118 |
.BR %P " typeset the page number in words" |
|
119 |
.TP 8 |
|
120 |
.BR %r " typeset the page number as a small Roman number" |
|
121 |
.TP 8 |
|
122 |
.BR %R " typeset the page number as a Roman number" |
|
123 |
.SH NOTES |
|
124 |
By design, |
|
125 |
.B Cedilla |
|
126 |
only accepts input data in UTF\-8. You are expected to use an external
|
|
127 |
converter such as |
|
128 |
.BR iconv (1) |
|
129 |
or |
|
130 |
.BR luit (1) |
|
131 |
in order to print text encoded in a legacy encoding. |
|
132 |
.B Cedilla |
|
133 |
is unable to print data that comes from a pipe; this is unavoidable, |
|
134 |
as |
|
135 |
.B Cedilla |
|
136 |
makes two passes over its input file. |
|
137 |
.SH AUTHOR |
|
138 |
.B Cedilla |
|
139 |
was written by Juliusz Chroboczek <jch@pps.jussieu.fr>. |
|
140 |
.SH SEE ALSO |
|
141 |
.BR iconv (1), |
|
142 |
.BR luit (1), |
|
143 |
.BR a2ps (1), |
|
144 |
.BR enscript (1), |
|
145 |
.BR ogonkify (1), |
|
146 |
.BR lpr (1). |