diff options
Diffstat (limited to 'Master/texmf/doc/man/man1/afm2afm.1')
-rw-r--r-- | Master/texmf/doc/man/man1/afm2afm.1 | 185 |
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. |