]> git.pld-linux.org Git - packages/t1lib.git/blame - t1lib-man.patch
remove fontpostinst from wrong package
[packages/t1lib.git] / t1lib-man.patch
CommitLineData
9af42edd
AF
1--- t1lib-1.3.1.orig/debian/FontDatabase.5
2+++ t1lib-1.3.1/debian/FontDatabase.5
3@@ -0,0 +1,77 @@
4+.TH FONTDATABASE 5
5+.SH NAME
6+FontDataBase \- database of fonts accessible to t1lib.
7+.SH DESCRIPTION
8+This manual page has been written for the Debian GNU/Linux
9+distribution. It has been adapted from the documentation included in
10+the upstream
11+.B t1lib
12+distribution.
13+.PP
14+.B /etc/t1lib/FontDataBase
15+is a text file which contains, minimally, the basenames of Type 1 font
16+files to be made accessible to the
17+.B t1lib
18+font rasterizer library. The format is intentionally similar to that
19+of the
20+.B fonts.dir
21+and
22+.B fonts.scale
23+files used by X11.
24+.PP
25+Line 1 of this file contains a positive integer specifying the number
26+of fonts declared in that file. This is as in the
27+.B fonts.dir
28+files of the X11 system.
29+.PP
30+All remaining lines contain declarations of one font each. The only
31+thing taken from such a line is the last string (delimited by white
32+space) in it. It is assumed to be a filename of the format
33+\fIbasename\fR.\fIsomeextension\fR.
34+.PP
35+The \fIbasename\fR part is assumed to be the
36+.BR basename (1)
37+of a fontfile. After the a string has been parsed, the
38+.I extension
39+is cut off and replaced in turn with
40+.I .pfa
41+and
42+.I .pfb.
43+The initialization routine tries to open a font file in
44+its search path with one of the resulting filenames.
45+.PP
46+The remainder of the line, i.e., from beginning to the start of the
47+filename string, is completely ignored and thus may contain
48+information for other programs.
49+.SH EXAMPLES
50+Here is a minimal font database file for 4 fonts:
51+.sp
52+.nf
53+4
54+isvl.afm
55+isvli.afm
56+isvd.afm
57+isvdi.afm
58+.fi
59+.PP
60+This file is \fIminimal\fR, because it contains just the information
61+needed, and nothing not needed by the library.
62+.PP
63+Here is a more realistic example, which allows an application to match
64+a fully qualified X11 fontname to a FontID in
65+.B t1lib.
66+This is also a valid font database file:
67+.sp
68+.nf
69+4
70+Souvenir Souvenir-Light --- -itc-souvenir-light-r-normal--#-0-0-0-p-0-iso8859-1 isvl.afm
71+Souvenir Souvenir-LightItalic -*- -itc-souvenir-light-i-normal--#-0-0-0-p-0-iso8859-1 isvli.afm
72+ Souvenir-Demi *-- -itc-souvenir-demi-r-normal--#-0-0-0-p-0-iso8859-1 isvd.afm
73+ Souvenir-DemiItalic **- -itc-souvenir-demi-i-normal--#-0-0-0-p-0-iso8859-1 isvdi.afm
74+.fi
75+.PP
76+.SH FILES
77+.I /etc/t1lib/FontDataBase
78+.SH "SEE ALSO"
79+.BR mkfontdir (1x)
80+
81--- t1lib-1.3.1.orig/debian/type1afm.1
82+++ t1lib-1.3.1/debian/type1afm.1
83@@ -0,0 +1,34 @@
84+.TH TYPE1AFM 8
85+.SH NAME
86+.B type1afm
87+\- create a font metrics file from a Type 1 font file
88+.SH SYNOPSIS
89+.B type1afm
90+[
91+.BR \-l
92+]
93+.B fontfile
94+[
95+.B fontfile...
96+]
97+.SH DESCRIPTION
98+This manual page was written for the Debian GNU/Linux distribution
99+because the original program does not have a manual page.
100+.PP
101+.B type1afm
102+reads in Type 1 font files specified on the command line, rasterizes
103+them to 1000bp, and writes AFM (font metrics) files based on the
104+observed metrics information.
105+.PP
106+The AFM file is created in the same directory as the font file, so be
107+sure that you have write access there before running this program.
108+.SH OPTIONS
109+.TP
110+.BR \-l
111+Write a log file
112+.SH SEE ALSO
113+.BR getafm (1)
114+.SH AUTHOR
115+This manual page was David Huggins-Daines <dhd@debian.org>
116+for the Debian GNU/Linux distribution (but may be used by others)
117+
118--- t1lib-1.3.1.orig/debian/xglyph.1
119+++ t1lib-1.3.1/debian/xglyph.1
120@@ -0,0 +1,111 @@
121+.TH XGLYPH 1
122+.SH NAME
123+xglyph \- demonstration program for the t1lib font rasterizer library.
124+.SH SYNOPSIS
125+.B xglyph
126+[
127+.B fontfile...
128+]
129+.SH "DESCRIPTION"
130+This manual page documents briefly the
131+.BR xglyph
132+program.
133+This manual page was written for the Debian GNU/Linux distribution
134+because the original program does not have a manual page.
135+.PP
136+.B xglyph
137+is a program which demonstrates the capabilities of the
138+.B t1lib
139+library. It allows the user to view an arbitrary character or string
140+rendered in the various ways pgossible with the library. By default,
141+it writes a log file named \fIt1lib.log\fR in the current directory.
142+.PP
143+If invoked with no arguments, it will attempt to read the global
144+configuration file and font database. It will also accept any number
145+of filenames on the command line, in which case these are treated as
146+font files to be loaded instead of the default font database.
147+.SH "OPTIONS"
148+.TP
149+.BR \-\-help
150+Shows a brief help text
151+.TP
152+.BR \-\-Help
153+Shows a description of all options
154+.TP
155+.BR \-\-noGrid
156+Don't draw grid lines when displaying glyphs
157+.TP
158+.BR \-\-setPad
159+Set bitmap padding
160+.TP
161+.BR \-\-logError
162+Log errors only
163+.TP
164+.BR \-\-logWarning
165+Log errors and warnings
166+.TP
167+.BR \-\-logStatistic
168+Log errors, warnings, and statistics
169+.TP
170+.BR \-\-logDebug
171+Log just about everything
172+.TP
173+.BR \-\-ignoreForceBold
174+Don't make pseudo-boldface glyphs
175+.TP
176+.BR \-\-ignoreFamilyAlignment
177+.TP
178+.BR \-\-ignoreHinting
179+Ignore hints when scaling glyphs
180+.TP
181+.BR \-\-debugLine
182+Show debugging info for line-drawing
183+operations in the rasterizer
184+.TP
185+.BR \-\-debugRegion
186+Show debugging info for region operations in
187+the rasterizer
188+.TP
189+.BR \-\-debugPath
190+Show debugging info for path operations in the
191+rasterizer
192+.TP
193+.BR \-\-debugFont
194+.TP
195+.BR \-\-debugHint
196+Show debugging info for hinting in the rasterizer.
197+.TP
198+.BR \-\-checkPerformance
199+Do some simple performance tests while rasterizing.
200+.TP
201+.BR \-\-checkCopyFont
202+Check that copying fonts works.
203+.TP
204+.BR \-\-checkConcatGlyphs
205+Check that concatenating glyphs works.
206+.TP
207+.BR \-\-checkBadCharHandling
208+.TP
209+.BR \-\-checkDefaultEncoding
210+Set a default encoding vector.
211+.SH "ENVIRONMENT"
212+In the Debian GNU/Linux version of this program, the environment
213+variable
214+.B T1LIB_CONFIG,
215+if set, points to an alternate configuration
216+file with which to initialize the library.
217+.SH "SEE ALSO"
218+.BR FontDataBase (5),
219+.BR t1libconfig (8).
220+.PP
221+.B xglyph
222+is much more fully documented in the LaTeX documentation that
223+accompanies the upstream
224+.B t1lib
225+distribution. This documentation is installed in PostScript and source
226+formats with the t1lib-dev package in /usr/share/doc/t1lib-dev, and is
227+also accessible through the dwww system.
228+.SH AUTHOR
229+This manual page was written by David Huggins-Daines
230+<dhd@debian.org>, for the Debian GNU/Linux system (but may
231+be used by others).
This page took 0.117521 seconds and 4 git commands to generate.