t1lib-man.patch

   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).