summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/afm2afm.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/afm2afm.1')
-rw-r--r--Master/texmf/doc/man/man1/afm2afm.1185
1 files changed, 85 insertions, 100 deletions
diff --git a/Master/texmf/doc/man/man1/afm2afm.1 b/Master/texmf/doc/man/man1/afm2afm.1
index d190f994365..d15c5cb8b21 100644
--- a/Master/texmf/doc/man/man1/afm2afm.1
+++ b/Master/texmf/doc/man/man1/afm2afm.1
@@ -1,26 +1,11 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Thu Jan 12 09:06:57 2006
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
+.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
.de Vb \" Begin verbatim text
.ft CW
.nf
@@ -28,16 +13,15 @@
..
.de Ve \" End verbatim text
.ft R
-
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. | will give a
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available. \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
+.\" double quote, and \*(R" will give a right double quote. \*(C+ will
+.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
@@ -56,26 +40,28 @@
. ds R" ''
'br\}
.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD. Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD. Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
-.\"
-.\" For nroff, turn off justification. Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
+.el \{\
+. de IX
+..
+.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
-.bd B 3
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
@@ -135,80 +121,79 @@
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
-.\" ======================================================================
+.\" ========================================================================
.\"
.IX Title "AFM2AFM 1"
-.TH AFM2AFM 1 "fontools" "2006-01-12" "fontools"
-.UC
+.TH AFM2AFM 1 "2012-03-06" "fontools" "Marc Penninga"
+.\" For nroff, turn off justification. Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
.SH "NAME"
-afm2afm \- reencode an \fIafm\fR file
+afm2afm \- reencode an afm file
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
-afm2afm \fB\-e\fR \fIencoding\fR [\fB\-o\fR \fIoutput\fR] \fIafmfile\fR
+.IP "\fBafm2afm\fR" 8
+.IX Item "afm2afm"
+[\fB\-help\fR]
+[\fB\-encoding\fR \fIencodingfile\fR]
+[\fB\-output\fR \fIoutputfile\fR]
+\&\fBafmfile\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
-This program reencodes an \fIafm\fR file. It's mainly intended to be used with
-\&\fIafm\fR files that were extracted from TrueType or OpenType fonts, since these
-are often too big to be handled with tools like \fIfontinst\fR (Adobe's
-CaflischScriptPro-Regular font, for example, contains 1289 glyphs and
-278678 kerning pairs, leading to an \fIafm\fR file of nearly 9MB).
+\&\fBafm2afm\fR re-encodes an \fIafm\fR file.
+.PP
+Metrics (including kerning data) for characters not present in the
+chosen encoding are excluded from the output, which resuls in
+much smaller files.
+.PP
+Note that if you don't specify an encoding file, the \fIafm\fR file
+isn't re-encoded, but the unused data is still pruned.
.PP
-Glyphs that are absent from the chosen encoding aren't written to the output,
-which yields much smaller output files.
+The program also generates an entry for a \fIdvips\fR\-style map file,
+but only if the \fIafm\fR file has been re-encoded and
+the output was written to file
+(i.e., if both the \fI\-encoding\fR and \fI\-output\fR options were specified).
+.SH "OPTIONS AND ARGUMENTS"
+.IX Header "OPTIONS AND ARGUMENTS"
+.IP "\fB\-help\fR" 4
+.IX Item "-help"
+Print a short description of the syntax
+.IP "\fB\-encoding\fR \fIencodingfile\fR" 4
+.IX Item "-encoding encodingfile"
+Re-encode to the enconding in \fIencodingfile\fR
+.IP "\fB\-output\fR \fIoutputfile\fR" 4
+.IX Item "-output outputfile"
+Write the result to \fIoutputfile\fR instead of \f(CW\*(C`stdout\*(C'\fR.
+.IP "\fBafmfile\fR" 4
+.IX Item "afmfile"
+The \fIafm\fR file to be re-encoded.
.PP
-The program also generates an entry for a \fIdvips\fR\-style map file.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-Option names were chosen to match those of \fIttf2afm\fR.
-.Ip "\fB\-e\fR \fIencoding\fR" 4
-.IX Item "-e encoding"
-Reencode using the encoding given in file \fIencoding\fR.
-.Ip "\fB\-o\fR \fIoutput\fR" 4
-.IX Item "-o output"
-Write the reencoded \fIafm\fR to file \fIoutput\fR instead of \f(CW\*(C`stdout\*(C'\fR.
-The mapfile entry will still be written to \f(CW\*(C`stdout\*(C'\fR.
-.SH "FILES"
-.IX Header "FILES"
-All input files are searched using \fBkpsewhich\fR or \fBfindtexmf\fR when these
-commands are available; otherwise only the current working directory
-is searched.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIautoinst\fR, \fIcmap2enc\fR, \fIfont2afm\fR, \fIot2kpx\fR, \fIpfm2kpx\fR.
+Option names may be shortened to a unique prefix.
.SH "AUTHOR"
.IX Header "AUTHOR"
-Marc Penninga <marc@penninga.info>
-.SH "HISTORY"
-.IX Header "HISTORY"
-.Ip "\fI2005\-01\-10\fR" 12
-.IX Item "2005-01-10"
-First version
-.Ip "\fI2005\-01\-25\fR" 12
-.IX Item "2005-01-25"
-Added printing of mapfile entry
-.Ip "\fI2005\-02\-18\fR" 12
-.IX Item "2005-02-18"
-Rewrote some of the code
-.Ip "\fI2005\-03\-08\fR" 12
-.IX Item "2005-03-08"
-Input files searched via \fBkpsewhich\fR (where available)
-.Ip "\fI2005\-03\-15\fR" 12
-.IX Item "2005-03-15"
-Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR (if available)
-.Ip "\fI2005\-04\-15\fR" 12
-.IX Item "2005-04-15"
-Updated creation of mapfile entry; look for font file to deduce the correct
-font file format (pfb, pfa, ttf). If no font file is found,
-pfb is assumed.
-.Ip "\fI2005\-04\-20\fR" 12
-.IX Item "2005-04-20"
-Program quits if the specified output file exists
-.Ip "\fI2005\-04\-29\fR" 12
-.IX Item "2005-04-29"
-Improved the documentation
-.Ip "\fI2005\-07\-29\fR" 12
-.IX Item "2005-07-29"
-Some updates to the documentation
-.Ip "\fI2006\-01\-12\fR" 12
-.IX Item "2006-01-12"
-A few minor changes to the code
+Marc Penninga <marcpenninga@gmail.com>
+.SH "COPYRIGHT"
+.IX Header "COPYRIGHT"
+Copyright (C) 2005\-2012 Marc Penninga.
+.SH "LICENSE"
+.IX Header "LICENSE"
+This program is free software; you can redistribute it and/or modify
+it under the terms of the \s-1GNU\s0 General Public License as published
+by the Free Software Foundation, either version 2 of the License,
+or (at your option) any later version.
+A copy of the \s-1GNU\s0 General Public License is included with \fBautoinst\fR;
+see the file \fIGPLv2.txt\fR.
+.SH "DISCLAIMER"
+.IX Header "DISCLAIMER"
+This program is distributed in the hope that it will be useful,
+but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
+\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.
+See the \s-1GNU\s0 General Public License for more details.
+.SH "RECENT CHANGES"
+.IX Header "RECENT CHANGES"
+(See the source code for the rest of the story.)
+.IP "\fI2012\-02\-01\fR" 12
+.IX Item "2012-02-01"
+Refactored the code; added the \*(L"no re-encoding, only pruning\*(R"
+functionality.