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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
.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).