summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/ttf2pk.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/ttf2pk.1')
-rw-r--r--Master/texmf/doc/man/man1/ttf2pk.1311
1 files changed, 0 insertions, 311 deletions
diff --git a/Master/texmf/doc/man/man1/ttf2pk.1 b/Master/texmf/doc/man/man1/ttf2pk.1
deleted file mode 100644
index 516a3081223..00000000000
--- a/Master/texmf/doc/man/man1/ttf2pk.1
+++ /dev/null
@@ -1,311 +0,0 @@
-.\" man page for ttf2pk
-.
-.TH TTF2PK 1 10-Jan-2002 "FreeType version 1.5"
-.SH NAME
-ttf2pk \- convert a TrueType font into TeX's PK format
-.SH SYNOPSIS
-.na
-.nh
-.B ttf2pk
-.RB [ \-q ]
-.RB [ \-n ]
-.I "\%font-name \%resolution"
-.br
-.B ttf2pk
-.B \-t
-.RB [ \-q ]
-.I \%font-name
-.br
-.B "ttf2pk \-\^\-version"
-|
-.B \-\^\-help
-.ad
-.hy
-.
-.
-.
-.\" ====
-.\" ==== macro definitions
-.\" ====
-.
-.\" here we define \TeX for troff and nroff
-.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
-.if n .ds TX TeX
-.
-.\" and here the same for \LaTeX
-.if t \{\
-.ie '\*(.T'dvi' \
-.ds LX \fRL\h'-0.36m'\v'-0.15v'\s-3A\s0\h'-0.15m'\v'0.15v'\fP\*(TX
-.el .ds LX \fRL\h'-0.36m'\v'-0.22v'\s-2A\s0\h'-0.15m'\v'0.22v'\fP\*(TX
-.\}
-.if n .ds LX LaTeX
-.
-.\" \LaTeXe
-.\" note that we need \vareps for TeX instead of \eps which can only be
-.\" accessed with the \N escape sequence (in the Math Italic font)
-.if t \{\
-.ie '\*(.T'dvi' .ds LE \*(LX\h'0.15m'2\v'0.20v'\f(MI\N'34'\fP\v'-0.20v'
-.el .ds LE \*(LX\h'0.15m'2\v'0.20v'\(*e\v'-0.20v'
-.\}
-.if n .ds LE LaTeX\ 2e
-.
-.\" a typewriter font
-.if t \{\
-.de C
-\fC\\$1\fP\\$2
-..
-.\}
-.if n \{\
-.de C
-\\$1\\$2
-..
-.\}
-.
-.\" ====
-.\" ==== end of macro definitions
-.\" ====
-.
-.
-.
-.SH DESCRIPTION
-This program converts a TrueType font into a
-.C PK
-file; the created font can then be used with \*(TX
-or \*(LX.
-.PP
-CJKV (Chinese/Japanese/Korean/old Vietnamese) subfonts as created by
-.B ttf2tfm
-are also supported.
-.PP
-.B ttf2pk
-always assumes 10pt as the design size for the written \*(TX
-font.
-.
-.
-.SH PARAMETERS
-.TP
-.B \-q
-This optional switch makes
-.B ttf2pk
-quiet.
-It suppresses any informational output except warning and error
-messages.
-.TP
-.B \-n
-Use only `\c
-.C \&.pk '
-as the extension instead of `\c
-.C \&. \c
-.RI < \%resolution >\c
-.C pk '.
-.TP
-.B \-t
-Test for the existence of
-.IR \%font-name .
-Returns 0 on success and prints out the corresponding line of
-a map file (default:
-.C \%ttfonts.map ),
-provided the
-.B \-q
-switch isn't set.
-.TP
-.I font-name
-The \*(TX
-name of the font.
-.B ttf2pk
-looks this name up in a map file (see below) for further information how
-to process the font.
-.TP
-.I resolution
-The resolution, given in dots per inch.
-Currently the horizontal resolution is equal to the vertical
-resolution.
-The design size is always assumed to be 10pt.
-.TP
-.B \-\^\-version
-Shows the current version of
-.B ttf2pk
-and the used file search library (e.g.\ \c
-.BR kpathsea ).
-.TP
-.B \-\^\-help
-Shows usage information.
-.PP
-Environment variables for file searching are described in the manual page
-of
-.BR ttf2tfm .
-.
-.
-.SH "THE CONFIGURATION FILE"
-.B ttf2pk
-uses a small configuration file called
-.C ttf2pk.cfg ;
-in each line it contains a keyword with its value, separated by whitespace.
-Comment lines can start with any of the following characters: `*', `#',
-`;', and `%'.
-Leading whitespace is ignored.
-.PP
-Currently, only one keyword, `map', is recognized in this file; it takes
-a map file name as a parameter.
-If no extension is given to the map file name,
-.C \&.map
-is appended.
-No whitespace is allowed in the map file name.
-The `map' keyword can be given more than once to specify multiple map
-files; if the map file name is prepended by a plus sign, it is added to
-the list of map files to be used.
-Example:
-.PP
-.in +2m
-.C "map foo"
-.br
-.C "map +bar"
-.PP
-This makes
-.B ttf2pk
-to first read
-.C foo.map ,
-then
-.C bar.map .
-.PP
-If the configuration file is not found,
-.B ttf2pk
-tries to use
-.C \%ttfonts.map
-instead.
-.
-.
-.SH "MAP FILES"
-Parameters specified to
-.B ttf2tfm
-are preserved for
-.B ttf2pk
-in map files\(em\c
-.B ttf2tfm
-writes out to standard output, as the last line, a proper entry for a
-map file.
-.PP
-As an example, a call to
-.PP
-.in +2m
-.C "ttf2tfm arial -p T1.enc -s 0.25 -P 1 -E 0 arials"
-.PP
-will produce the following line:
-.PP
-.in +2m
-.C "arials arial Slant=0.25 Pid=1 Eid=0 Encoding=T1.enc"
-.PP
-See
-.BR ttf2tfm (1)
-and
-.BR afm2tfm (1)
-of the
-.B dvips
-package for a detailed description of encoding files.
-.PP
-Here a table listing the various
-.B ttf2tfm
-parameters and the corresponding entries in a map file:
-.PP
-.in +4m
-.ta 2i
--s Slant
-.br
--e Extend
-.br
--p Encoding
-.br
--f Fontindex
-.br
--P Pid
-.br
--E Eid
-.br
--n PS=Yes
-.br
--N PS=Only
-.br
--R Replacement
-.br
--x Rotate=Yes
-.br
--y Y-Offset
-.PP
-Single replacement glyph names given to
-.B ttf2tfm
-with `\c
-.BI \-r \ old-glyphname\ new-glyphname\c
-\&'
-are directly specified with `\c
-.IR old-glyphname = new-glyphname '.
-They will be ignored if in subfont mode or if no encoding file is given.
-.PP
-One additional parameter in a map file is unique to
-.BR ttf2pk :
-`Hinting', which can take the values `On' or `Off'.
-Some fonts (e.g.\ the CJK part of
-.C \%cyberbit.ttf )
-are rendered incorrectly if hinting is activated.
-Default is `On' (you can also use `Yes', `No', `1', and `0').
-.PP
-For a description of subfonts (i.e., entries of the form `\c
-.I <namestem>\c
-.C @\c
-.I <sfd-filename>\c
-.C @ ')
-please refer to
-.BR ttf2tfm (1).
-.PP
-The format of a map file is simple.
-Each line defines a font; first comes the \*(TX
-font name, then its TrueType font file name, followed by the
-parameters in any order.
-Case is significant (even for parameter names); the parameters are
-separated from its values by an equal sign, with whitespace possibly
-surrounding it.
-.B ttf2pk
-reads in all map files line by line in the order given in the
-configuration file, continuing until the \*(TX font specified on the
-command line is found, otherwise the programs exits with error code\ 2.
-Thus you can use any character invalid in a \*(TX
-font name to start a comment line.
-.PP
-You can use `\\' as the final character of a line to indicate that the
-input is continued on the next line.
-The backslash and the following newline character will be removed.
-.PP
-.B ttf2pk
-will abort if it can't find or read the \*(TX
-font metrics file of the given \*(TX
-font name.
-.
-.
-.SH "RETURN VALUE"
-If the call was successful, 0\ will be returned.
-In case of error, the return value is\ 1.
-Finally, if the font can't be found in the map files,
-2\ is returned.
-This simplifies the inclusion of
-.B ttf2pk
-into scripts like
-.B mktexpk
-for automatic font generation.
-.
-.
-.SH "SEE ALSO"
-.BR ttf2tfm (1),
-.BR afm2tfm (1)
-.
-.
-.SH AVAILABILITY
-.B ttf2pk
-is part of the FreeType\ 1 package, a high quality TrueType rendering
-library.
-.
-.
-.SH AUTHORS
-Werner LEMBERG
-.C <wl@gnu.org>
-.br
-Fr\('ed\('eric LOYER
-.C <loyer@ensta.fr>