diff options
Diffstat (limited to 'Master/texmf/doc/man')
-rw-r--r-- | Master/texmf/doc/man/man1/afm2afm.1 | 214 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/autoinst.1 | 583 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/cmap2enc.1 | 450 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/font2afm.1 | 196 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/ot2kpx.1 | 205 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/pfm2kpx.1 | 208 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/showglyphs.1 | 185 |
7 files changed, 2041 insertions, 0 deletions
diff --git a/Master/texmf/doc/man/man1/afm2afm.1 b/Master/texmf/doc/man/man1/afm2afm.1 new file mode 100644 index 00000000000..d190f994365 --- /dev/null +++ b/Master/texmf/doc/man/man1/afm2afm.1 @@ -0,0 +1,214 @@ +.\" Automatically generated by Pod::Man version 1.15 +.\" Thu Jan 12 09:06:57 2006 +.\" +.\" 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 +.ne \\$1 +.. +.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 +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. 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 \{\ +. 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 +.\" +.\" 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 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ====================================================================== +.\" +.IX Title "AFM2AFM 1" +.TH AFM2AFM 1 "fontools" "2006-01-12" "fontools" +.UC +.SH "NAME" +afm2afm \- reencode an \fIafm\fR file +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +afm2afm \fB\-e\fR \fIencoding\fR [\fB\-o\fR \fIoutput\fR] \fIafmfile\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). +.PP +Glyphs that are absent from the chosen encoding aren't written to the output, +which yields much smaller output files. +.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. +.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 diff --git a/Master/texmf/doc/man/man1/autoinst.1 b/Master/texmf/doc/man/man1/autoinst.1 new file mode 100644 index 00000000000..2861af70cdc --- /dev/null +++ b/Master/texmf/doc/man/man1/autoinst.1 @@ -0,0 +1,583 @@ +.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05) +.\" +.\" 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 Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.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. \*(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- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. ds R" '' +'br\} +.\" +.\" 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 (.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. +.ie \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. nr % 0 +. rr F +.\} +.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. +. \" fudge factors for nroff and troff +.if n \{\ +. ds #H 0 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ======================================================================== +.\" +.IX Title "AUTOINST 1" +.TH AUTOINST 1 "2009-04-09" "fontools" "fontools" +.\" 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" +autoinst \- wrapper script around the \fI\s-1LCDF\s0 TypeTools\fR, +for installing OpenType fonts in LaTeX. +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +autoinst [options] \fIfontfile\fR [\fIfontfile\fR ...] +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +Eddie Kohler's \fITypeTools\fR, mainly \fIotftotfm\fR, are great tools for +installing OpenType fonts for use with LaTeX, but their use (even in +automatic mode) is quite complicated; they need lots of long +command lines and don't generate the \fIfd\fR and \fIsty\fR files LaTeX needs. +\&\fBautoinst\fR simplifies the font installation +process by generating and executing all commands for \fIotftotfm\fR +and by creating all necessary \fIfd\fR and \fIsty\fR files. All the user then needs +to do is move these files to a suitable location +(\f(CW\*(C`$LOCALTEXMF/tex/latex/<Supplier>/<FontFamily>/\*(C'\fR is the +canonical choice) and update TeX's filename database. +.PP +Given a family of font files (in either \fI.ttf\fR or \fI.otf\fR format), +\&\fBautoinst\fR will create several LaTeX font families: +.RS 2 +.IP "\fB\-\fR" 2 +.IX Item "-" +Four text families (with lining and oldstyle figures, in tabular and +proportional variants), each with the following shapes: +.RS 2 +.RS 2 +.IP "\fIn\fR" 4 +.IX Item "n" +Roman text +.IP "\fIsc\fR" 4 +.IX Item "sc" +Small caps +.IP "\fInw\fR" 4 +.IX Item "nw" +`Upright swash'; usually normal text with some extra `oldstyle' ligatures, +such as ct, sp and st. +.IP "\fItl\fR" 4 +.IX Item "tl" +Titling shape. Meant for all-caps text only (even though it sometimes contains +lowercase glyphs as well), where letterspacing and the positioning of +punctuation characters have been adjusted to suit all-caps text. +This shape is generated only for the families with lining figures. +.IP "\fIit\fR" 4 +.IX Item "it" +Italic or oblique text +.IP "\fIscit\fR" 4 +.IX Item "scit" +Italic small caps +.IP "\fIsw\fR" 4 +.IX Item "sw" +Swash +.IP "\fItlit\fR" 4 +.IX Item "tlit" +Italic titling +.RE +.RS 2 +.RE +.RE +.RS 2 +.RE +.IP "\fB\-\fR" 2 +.IX Item "-" +For each text family: a family of TS1\-encoded symbol fonts, +in roman and italic shapes. +.IP "\fB\-\fR" 2 +.IX Item "-" +Four families with superiors, inferiors, numerators and denominators, +in roman and italic shapes. +.IP "\fB\-\fR" 2 +.IX Item "-" +An ornament family, in roman and italic shapes. +.RE +.RS 2 +.RE +.PP +Of course, if the font doesn't contain oldstyle figures, small caps etc., +the corresponding shapes or families are not created; +furthermore, the creation of most families and shapes can be controlled by +command-line options (see below). +.PP +The generated font families are named \fI<FontFamily>\-<Suffix>\fR, +where \fI<Suffix>\fR is one of +.IP "\fI\s-1LF\s0\fR" 8 +.IX Item "LF" +proportional (i.e., figures have varying widths) lining figures +.IP "\fI\s-1TLF\s0\fR" 8 +.IX Item "TLF" +tabular (i.e., all figures have the same width) lining figures +.IP "\fIOsF\fR" 8 +.IX Item "OsF" +proportional oldstyle figures +.IP "\fITOsF\fR" 8 +.IX Item "TOsF" +tabular oldstyle figures +.IP "\fISup\fR" 8 +.IX Item "Sup" +superior characters (many fonts only have an incomplete set +of superiors: figures, some punctuation and the letters +\&\fIabdeilmnorst\fR; normal forms will be used for the other characters) +.IP "\fIInf\fR" 8 +.IX Item "Inf" +inferior characters; usually only figures and punctuation, +normal forms for the other characters +.IP "\fIOrn\fR" 8 +.IX Item "Orn" +ornaments +.IP "\fINumr\fR" 8 +.IX Item "Numr" +numerators +.IP "\fIDnom\fR" 8 +.IX Item "Dnom" +denominators +.PP +The generated fonts are named \fI<FontFile>\-<suffix>\-<shape>\-<enc>\fR, +where \fI<FontFile>\fR is the name of the OpenType file, \fI<suffix>\fR +is the same as above (but in lowercase), \fI<shape>\fR is either empty, +`sc', `swash' or `titling', and \fI<enc>\fR is the encoding. +A typical name in this scheme is \fIMinionPro\-Regular\-osf\-sc\-ly1\fR. +.Sh "On the choice of text encoding" +.IX Subsection "On the choice of text encoding" +By default, all text families use the \s-1LY1\s0 encoding. This has been chosen +over T1 (Cork) because many OpenType fonts contain additional ligatures +such as fj and Th, and \s-1LY1\s0 has a number of empty slots to accommodate these. +.PP +A different encoding can be selected using the \fB \-\-encoding\fR +command line option (see below). +.Sh "Using the fonts with LaTeX" +.IX Subsection "Using the fonts with LaTeX" +\&\fBautoinst\fR generates a style file for using the font in LaTeX documents, +named `<\fIFontFamily\fR>.sty'. This style file also takes care of loading the +\&\fIfontenc\fR and \fItextcomp\fR packages, if necessary. +To use the font, simply put \f(CW\*(C`\eusepackage{MinionPro}\*(C'\fR +(or whatever the font is called) in the preamble of your document. +.PP +This style file defines a number of options: +.IP "\fIlining, oldstyle, tabular, proportional\fR" 4 +.IX Item "lining, oldstyle, tabular, proportional" +Choose which figures will be used for the text fonts. +The defaults are `oldstyle' and `proportional' (if available). +.IP "\fIultrablack, ultrabold, heavy, extrablack, black, extrabold, demibold, semibold, bold\fR" 4 +.IX Item "ultrablack, ultrabold, heavy, extrablack, black, extrabold, demibold, semibold, bold" +Choose the weight that LaTeX will use for the `bold' weight +(i.e., the value of \f(CW\*(C`\ebfdefault\*(C'\fR). +.IP "\fIlight, medium, regular\fR" 4 +.IX Item "light, medium, regular" +Choose the weight that LaTeX will use for the `regular' weight +(i.e., the value of \f(CW\*(C`\emddefault\*(C'\fR). +.IP "\fIscaled=<scale>\fR" 4 +.IX Item "scaled=<scale>" +Scale the font by a factor of \fI<scale>\fR. +For example: to increase the size of the font by 5%, use the command +\&\f(CW\*(C`\eusepackage[scaled=1.05]{MyriadPro}\*(C'\fR. +.Sp +This option is only available when the \fIxkeyval\fR package is found +in your TeX installation. +.PP +The style file will also try to load the \fIfontaxes\fR package (part of +the MinionPro for LaTeX project), which gives easy access to various font +shapes and styles. This package can be downloaded from the project's homepage +(\fIhttp://developer.berlios.de/projects/minionpro\fR) or directly through +the \s-1CVS\s0 web interface +(\fIhttp://cvs.berlios.de/cgi\-bin/viewcvs.cgi/minionpro/MinionPro/tex/\fR), +and is also available from \s-1CTAN\s0 as part of the archive \fIbase\-v2.zip\fR +(\fIhttp://www.ctan.org/tex\-archive/fonts/minionpro/base\-v2.zip\fR). +.PP +Using the machinery set up by \fIfontaxes\fR, the generated style file +also defines a few commands (which take the text to be typeset as argument) +and declarations (which don't take arguments, but affect all text up to +the end of the current group) of its own: +.PP +.Vb 1 +\& DECLARATION COMMAND SHORT FORM OF COMMAND +\& +\& \etlshape \etexttitling \etexttl +\& \esufigures \etextsuperior \etextsu +\& \einfigures \etextinferior \etextin +.Ve +.PP +In addition, the \f(CW\*(C`\eswshape\*(C'\fR and \f(CW\*(C`\etextsw\*(C'\fR commands are redefined to place +swash on the secondary shape axis (\fIfontaxes\fR places it on the primary +shape axis); this allows the use of `upright swash'. +Just saying \f(CW\*(C`\eswshape\*(C'\fR will still give normal (italic) swash, +but \f(CW\*(C`\eswshape\eupshape\*(C'\fR results in upright swash. +.PP +Note that there is no separate command for accessing the italic titling shape; +but these commands behave properly when nested, so \f(CW\*(C`\etlshape\eitshape\*(C'\fR gives +italic titling. +There are also no commands for accessing the numerator and denominator +fonts; these can be selected using \fIfontaxes\fR' low-level commands, +e.g., \f(CW\*(C`\efontfigurestyle{numerator}\eselectfont\*(C'\fR. +.PP +The style file also provides a command \f(CW\*(C`\eornament{\f(CI<number>\f(CW}\*(C'\fR, +where \f(CW\*(C`\f(CI<number>\f(CW\*(C'\fR is a number from 0 to the total number of +ornaments minus one. Ornaments are always typeset using the current family, +series and shape. A list of all ornaments in a font can be created by +running LaTeX on the file \fInfssfont.tex\fR (part of a standard +LaTeX installation) and specifying the ornament font +(e.g., \fIMinionPro-Regular-orn-u\fR). +.PP +This whole machinery builds on \fIfontaxes\fR; if that package cannot be found, +the style file doesn't provide high-level access to the more `exotic' +font shapes and styles. In that case, you're limited to using the lower-level +commands from standard \s-1NFSS\s0, or even plain TeX's \f(CW\*(C`\efont\*(C'\fR primitive +(and it's called `primitive' for a reason!) +.Sh "Using multiple font families in one document" +.IX Subsection "Using multiple font families in one document" +If you want to use several font families in one document, make sure +all fonts were installed using the same version of \fBautoinst\fR. +\&\fBautoinst\fR has seen some non-backward-compatible changes in the past, +and \fI.sty\fR and \fI.fd\fR files that were generated by different versions +of \fBautoinst\fR may not be able to coexist peacefully. +.Sh "\s-1NFSS\s0 codes" +.IX Subsection "NFSS codes" +In \s-1NFSS\s0, weight and width are concatenated into a single `series' attribute. +(\fINote:\fR versions of \fBautoinst\fR before 2007\-07\-27 erroneously formed +the series as `width plus weight' instead of the reverse.) +\&\fBautoinst\fR maps widths, weights and shapes to \s-1NFSS\s0 codes using +the following tables. These are based on the tables in Lehman's +\&\fIFont Installation Guide\fR, but some changes had to be made to avoid +name clashes for font families with many different widths and weights +(such as Helvetica Neue). +.PP +.Vb 1 +\& WEIGHT WIDTH +\& +\& Thin t Ultra Condensed uc +\& Ultra Light ul Extra Condensed ec +\& Extra Light el Condensed c +\& Light l Semicondensed sc +\& Book [1] Regular [1] +\& Regular [1] Semiextended sx +\& Medium mb Extended x +\& Demibold db +\& Semibold sb +\& Bold b +\& Extra Bold eb SHAPES +\& Black a +\& Extra Black ea Roman n +\& Heavy h Italic it +\& Ultra ub Oblique it [2] +\& Ultra Bold ub RomanI n [3] +\& Ultra Black ua RomanII it [3] +.Ve +.IP "[1]" 4 +.IX Item "[1]" +When \fIboth\fR weight and width are empty, the `series' attribute becomes `m'. +.IP "[2]" 4 +.IX Item "[2]" +Mapping the `Oblique' shape to `it' instead of the canonical `sl' simplifies +\&\fBautoinst\fR. Since font families with both `Italic' and `Oblique' shapes +probably do not exist (apart from Computer Modern), +this shouldn't cause problems in real life. +.IP "[3]" 4 +.IX Item "[3]" +To the best of my knowledge, the only font family that has two `Roman' shapes +is Silentium; since this has no `Italic' shape, +the `it' code is (ab)used for the `RomanII' shape. +.Sh "A note for MikTeX users" +.IX Subsection "A note for MikTeX users" +Calling \fIotftotfm\fR with the \fB \-\-automatic\fR option (as \fBautoinst\fR does by +default) requires a TeX-installation that uses the \fIkpathsea\fR library; with +TeX-installations that implement their own directory searching +(such as MiKTeX) \fIotftotfm\fR might complain that it +cannot find a writable \fItexmf\fR directory and leave all generated \fItfm\fR, +\&\fIvf\fR, \fIenc\fR and \fImap\fR files in the current working directory. +In that case, you need to move these to their correct destinations. +You also need to tell the dvi-driver (\fIdvips\fR, \fIdvipdfm\fR, \fIpdfTeX\fR etc.) +about the new font map files; this usually means editing some +configuration file. +.PP +Furthermore, some OpenType fonts lead to \fIpl\fR and \fIvpl\fR files that are too +big for MiKTeX's \fIpltotf\fR and \fIvptovf\fR; the versions that come with TeXLive +(\fIhttp://tug.org/ftp/texlive/Contents/live/bin/win32/\fR) don't have this +problem. +.SH "COMMAND-LINE OPTIONS" +.IX Header "COMMAND-LINE OPTIONS" +.IP "\fB \-\-encoding\fR=\fIencoding[,encoding]\fR" 4 +.IX Item " --encoding=encoding[,encoding]" +Use the encoding \fIencoding\fR for the text fonts. The default is `\s-1LY1\s0'. +A file named `<\fIencoding\fR>.enc' (in all \fIlowercase\fR) should be somewhere +where \fIotftotfm\fR can find it. Suitable encoding files +for \s-1LY1\s0, \s-1OT1\s0 and T1/TS1 come with \fIfontools\fR. (Note that these files are +called \fIfontools_xxx.enc\fR to avoid name clashes with other packages; +the `fontools_' prefix doesn't need to be specified.) +.Sp +Multiple text encodings can be specified as well: \f(CW\*(C` \-\-encoding=OT1,T1,LY1\*(C'\fR. +The encodings are passed to \fIfontenc\fR in the order specified, +so the last one will be the default text encoding. +.IP "\fB \-\-sanserif\fR" 4 +.IX Item " --sanserif" +Install the font as a sanserif font, accessed via \f(CW\*(C`\esffamily\*(C'\fR and \f(CW\*(C`\etextsf\*(C'\fR. +Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR, +so including it will make this font the default text font. +.IP "\fB \-\-typewriter\fR" 4 +.IX Item " --typewriter" +Install the font as a typewriter font, accessed via \f(CW\*(C`\ettfamily\*(C'\fR and +\&\f(CW\*(C`\etexttt\*(C'\fR. +Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR, +so including it will make this font the default text font. +.IP "\fB \-\-ts1\fR" 4 +.IX Item " --ts1" +.PD 0 +.IP "\fB \-\-nots1\fR" 4 +.IX Item " --nots1" +.PD +Turn the creation of TS1\-encoded fonts on or off. The default is \fB \-\-ts1\fR +if the text encodings (see \fI \-\-encoding\fR above) include T1, +\&\fB \-\-nots1\fR otherwise. +.IP "\fB \-\-smallcaps\fR" 4 +.IX Item " --smallcaps" +.PD 0 +.IP "\fB \-\-nosmallcaps\fR" 4 +.IX Item " --nosmallcaps" +.PD +Turn the creation of small caps fonts on or off. The default is +\&\fB \-\-smallcaps\fR. +.IP "\fB \-\-swash\fR" 4 +.IX Item " --swash" +.PD 0 +.IP "\fB \-\-noswash\fR" 4 +.IX Item " --noswash" +.PD +Turn the creation of swash fonts on or off. The default is \fB \-\-swash\fR. +.IP "\fB \-\-titling\fR" 4 +.IX Item " --titling" +.PD 0 +.IP "\fB \-\-notitling\fR" 4 +.IX Item " --notitling" +.PD +Turn the creation of titling fonts on or off. The default is \fB \-\-notitling\fR. +.IP "\fB \-\-superiors\fR" 4 +.IX Item " --superiors" +.PD 0 +.IP "\fB \-\-nosuperiors\fR" 4 +.IX Item " --nosuperiors" +.PD +Turn the creation of fonts with superior characters on or off. +The default is \fB \-\-superiors\fR. +.IP "\fB \-\-inferiors\fR" 4 +.IX Item " --inferiors" +.PD 0 +.IP "\fB \-\-noinferiors\fR" 4 +.IX Item " --noinferiors" +.PD +Turn the creation of fonts with inferior figures on or off. +The default is \fB \-\-noinferiors\fR. +.IP "\fB \-\-fractions\fR" 4 +.IX Item " --fractions" +.PD 0 +.IP "\fB \-\-nofractions\fR" 4 +.IX Item " --nofractions" +.PD +Turn the creation of fonts with numerators and denominators on or off. +The default is \fB \-\-nofractions\fR. +.IP "\fB \-\-ornaments\fR" 4 +.IX Item " --ornaments" +.PD 0 +.IP "\fB \-\-noornaments\fR" 4 +.IX Item " --noornaments" +.PD +Turn the creation of ornament fonts on or off. The default is \fB \-\-ornaments\fR. +.IP "\fB \-\-manual\fR" 4 +.IX Item " --manual" +Manual mode. By default, \fBautoinst\fR immediately executes all \fIotftotfm\fR +command lines it generates; with the \fB \-\-manual\fR option, these commands are +instead written to a batch command file (named `<\fIfont\fR>.bat', to make things +easier for our friends on Windows). Also, the generated \fIotftotfm\fR command +lines specify the \fI \-\-pl\fR option and leave out the \fI \-\-automatic\fR option; +this causes human readable (and editable) \fIpl\fR and \fIvpl\fR files to be created +instead of the default \fItfm\fR and \fIvf\fR files. +.IP "\fB \-\-verbose\fR" 4 +.IX Item " --verbose" +Verbose mode; print detailed info about what \fBautoinst\fR thinks it's doing. +.IP "\fB \-\-extra\fR=\fItext\fR" 4 +.IX Item " --extra=text" +Pass \fItext\fR as options to \fIotftotfm\fR. To prevent \fItext\fR from accidentily +being interpreted as options to \fBautoinst\fR, it should be properly quoted. +.SH "SEE ALSO" +.IX Header "SEE ALSO" +Eddie Kohler's TypeTools (\fIhttp://www.lcdf.org/type\fR). +.PP +Perl is usually pre-installed on Linux and Unix systems; +for Windows, good (and free) Perl implementations are +Strawberry Perl (\fIhttp://strawberryperl.com\fR) and +ActivePerl (available from \fIhttp://www.activestate.com\fR); +.PP +John Owens' \fIotfinst\fR (\fIhttp://www.ece.ucdavis.edu/~jowens/code/otfinst/\fR; +also available from \s-1CTAN\s0) is another wrapper around \fIotftotfm\fR, +and may work for you when \fBautoinst\fR doesn't. +.PP +Ready-made support files for MinionPro, providing more options and features +than \fBautoinst\fR ever will (including math), are available from +\&\fIhttp://developer.berlios.de/projects/minionpro/\fR. +.PP +XeTeX (\fIhttp://scripts.sil.org/xetex\fR) is a TeX extension that can use +any font installed in the operating system (including both flavours of +OpenType fonts) without additional support files. +It also isn't hindered by standard TeX's limitation to 8\-bit fonts, +so it is especially well suited to fonts with many ligatures and +alternate glyphs, such as Bickham, Poetica and Zapfino. +.SH "AUTHOR" +.IX Header "AUTHOR" +Marc Penninga <marc@penninga.info> +.PP +When sending a bug report, please give as much relevant information as +possible; this usually includes (but may not be limited to) the output from +running \fBautoinst\fR with the \fB \-\-verbose\fR option. +Please make sure that this output includes all error messages (if any); +this can be done using the command +.PP +.Vb 1 +\& autoinst (... all options and files ...) >autoinst.log 2>&1 +.Ve +.SH "COPYRIGHT" +.IX Header "COPYRIGHT" +Copyright (c) 2005\-2009 Marc Penninga. +.SH "LICENSE" +.IX Header "LICENSE" +This program is free software; you can redistribute it and/or modify +it under the terms of version 2 of the \s-1GNU\s0 General Public License +as published by the Free Software Foundation. +.PP +A copy of the \s-1GNU\s0 General Public License is included with the \fIfontools\fR +collection; 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 full story.) +.IP "\fI2009\-04\-09\fR" 12 +.IX Item "2009-04-09" +Prefixed the filenames of the included encoding files with +`fontools_', to prevent name clashes with other packages. +.IP "\fI2009\-04\-06\fR" 12 +.IX Item "2009-04-06" +A small patch to the make_ornament_encoding subroutine; +it now also recognises the \fIbullet.xxx\fR ornament glyphs +in Adobe's Kepler Pro. diff --git a/Master/texmf/doc/man/man1/cmap2enc.1 b/Master/texmf/doc/man/man1/cmap2enc.1 new file mode 100644 index 00000000000..b57fc021fd1 --- /dev/null +++ b/Master/texmf/doc/man/man1/cmap2enc.1 @@ -0,0 +1,450 @@ +.\" Automatically generated by Pod::Man version 1.15 +.\" Thu Feb 8 11:04:39 2007 +.\" +.\" 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 +.ne \\$1 +.. +.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 +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. 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 \{\ +. 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 +.\" +.\" 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 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ====================================================================== +.\" +.IX Title "CMAP2ENC 1" +.TH CMAP2ENC 1 "fontools" "2007-02-08" "fontools" +.UC +.SH "NAME" +cmap2enc \- convert glyph indices in a TrueType-flavored OpenType font to +Adobe glyph names +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +cmap2enc [options] \fIfontfile\fR \fIencoding\fR +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +Many TrueType-flavored OpenType fonts contain no glyph names. +When creating an \fIafm\fR file with \fIttf2afm\fR, this causes all glyphs to be +named something +like \f(CW\*(C`index0x01E7\*(C'\fR, which makes the \fIafm\fR file almost useless for use with +\&\fIfontinst\fR or \fIafm2tfm\fR. +.PP +\&\fBcmap2enc\fR uses the font's `cmap' table to map glyph indices to +Unicode values, and Adobe's \fIglyphlist.txt\fR file to map these to glyph names. +.PP +\&\fBcmap2enc\fR creates a new encoding file (for downloading with the font file) +and a \fImtx\fR file (for use with \fIfontinst\fR). The encoding file contains the +same glyphs as the original one, but has all glyph names replaced with +the corresponding glyph indices; the \fImtx\fR file maps these glyph indices back +to the original glyph names (it consists of many commands of the form +\&\f(CW\*(C`\erenameGlyph{index0x01E7}{Euro}\*(C'\fR, plus a definition of that +\&\f(CW\*(C`\erenameGlyph\*(C'\fR command). +.PP +Some of the glyph substitution features of OpenType fonts are supported; +e.g. when the `smcp' (Small Caps) feature is specified, the glyph names +of the lowercase glyphs will be mapped to the glyph indices of the +small capitals. +.PP +A list of features supported by the font can be generated using the \fB\-p\fR +option, see below. +.SH "EXAMPLES" +.IX Header "EXAMPLES" +\&\s-1NOTE:\s0 the \fIexamples/\fR subdirectory in the \fIfontools\fR distribution contains +several complete examples of the use of \fBcmap2enc\fR and other tools from +the \fIfontools\fR collection. +.Ip "\fB-\fR" 2 +.IX Item "-" +To display all scripts, languages and features supported by Linotype Palatino: +.Sp +.Vb 1 +\& cmap2enc -p pala.ttf +.Ve +.Ip "\fB-\fR" 2 +.IX Item "-" +To install Linotype Palatino in T1 encoding, with oldstyle figures: +.RS 2 +.Ip "\fB1.\fR" 3 +.IX Item "1." +Generate an encoding file \fIt1\-tosf-pala.enc\fR and a metrics file +\&\fIresetpala-t1\-osf.mtx\fR: +.Sp +.Vb 1 +\& cmap2enc -f onum pala.ttf t1.enc +.Ve +.Ip "\fB2.\fR" 3 +.IX Item "2." +Create an \fIafm\fR file for the font; this is done best using \fIfont2afm\fR +(also in the \fIfontools\fR collection): +.Sp +.Vb 1 +\& font2afm pala.ttf +.Ve +.Ip "\fB3.\fR" 3 +.IX Item "3." +Reencode the \fIafm\fR file using the \fIt1\-tosf-pala.enc\fR encoding to create +a `raw' font \fIrlplrj9d\fR, with either \fIafm2afm\fR (also in the \fIfontools\fR +collection) or \fIfontinst\fR (but be warned that \fIfontinst\fR might take a long +time, and can even crash if the \fIafm\fR is really big): +.Sp +.Vb 1 +\& afm2afm -e t1-tosf-pala.enc -o rlplrj9d.afm pala.afm +.Ve +or +.Sp +.Vb 1 +\& \etransformfont{rlplrj9d}{\ereencodefont{t1-tosf-pala}{\efromafm{pala}}} +.Ve +.Ip "\fB4.\fR" 3 +.IX Item "4." +Create a `value-added' \fIvpl\fR file from this raw font by adding +ligatures, faking missing glyphs etc. with \fIfontinst\fR: +.Sp +.Vb 2 +\& \einstallfont{lplrj9d}{rlplrj9d,resetpala-t1-tosf,newlatin} +\& {t1}{T1}{lplj}{m}{n}{} +.Ve +.RE +.RS 2 +.RE +.SH "OPTIONS" +.IX Header "OPTIONS" +\&\fBcmap2enc\fR supports the following command-line options: +.Ip "\fB\-p\fR" 4 +.IX Item "-p" +Print some info about the font, plus a list of all scripts, languages and +features contained in this font's \s-1GSUB\s0 table; then exit. (When using +this option, the \fIencoding\fR need not be specified.) +.Ip "\fB\-f\fR \fIfeature\fR[,\fIfeature\fR]*" 4 +.IX Item "-f feature[,feature]*" +Use the specified features when matching glyph indices to glyph names. +Multiple features can be specified as a comma-separated list, +\&\fBwithout\fR spaces between the items. +.Ip "\fB\-x\fR \fIextra\fR" 4 +.IX Item "-x extra" +Use the user-specified substitutions from \fIextra\fR (see below). +.Ip "\fB\-l\fR \fIlanguage\fR" 4 +.IX Item "-l language" +Select the specified language. The default is `\s-1DFLT\s0' (surprise!). +.Ip "\fB\-s\fR \fIscript\fR" 4 +.IX Item "-s script" +Select the specified script. The default is `latn'. +.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. +.Ip "\fIfontfile\fR" 4 +.IX Item "fontfile" +The font file can be any OpenType font, though \fBcmap2enc\fR is probably only +useful for the TrueType-flavored variant (PostScript-flavored ones always +contain glyph names in the `\s-1CFF\s0' table). +.Ip "\fIencoding\fR" 4 +.IX Item "encoding" +The encoding files read and written by \fBcmap2enc\fR are in standard \fIdvips\fR +format. The name of the output encoding file is +\&\f(CW\*(C`<encoding>\-<suffix>\-<font>.enc\*(C'\fR, +.Sp +where +.RS 4 +.Ip "\fBencoding\fR" 10 +.IX Item "encoding" +is the name of the input encoding file (without the extension `.enc'); +.Ip "\fBsuffix\fR" 10 +.IX Item "suffix" +names the OpenType features you specified: +.RS 10 +.Ip "\fItlf\fR" 10 +.IX Item "tlf" +for tabular lining figures (when neither the `onum' nor the `pnum' features +have been chosen) +.Ip "\fIlf\fR" 10 +.IX Item "lf" +for proportional width lining figures (when you've specified `pnum', +but not `onum') +.Ip "\fItosf\fR" 10 +.IX Item "tosf" +for tabular oldstyle figures (when you've specified `onum', but not `pnum') +.Ip "\fIosf\fR" 10 +.IX Item "osf" +for proportional width oldstyle figures (when both `onum' and `pnum' have been +chosen) +.Ip "\fIsc\fR" 10 +.IX Item "sc" +for small caps (`smcp' feature) +.Ip "\fIswash\fR" 10 +.IX Item "swash" +for swash (`swsh' feature) +.Ip "\fItitling\fR" 10 +.IX Item "titling" +for a titling font (`titl' feature) +.Ip "\fIsup\fR" 10 +.IX Item "sup" +for superior figures and (some) letters (`sups' feature) +.Ip "\fIorn\fR" 10 +.IX Item "orn" +for ornaments (`ornm' feature) +.RE +.RS 10 +.Sp +When several features have been specified, the \fBsuffix\fR is a combination +of the appropriate items; e.g., when you specify \-f onum,pnum,swsh (for a +swash font with proportional oldstyle figures) the \fBsuffix\fR is +\&\f(CW\*(C`osf\-swash\*(C'\fR. +.RE +.Ip "\fBfont\fR" 10 +.IX Item "font" +is the name of the input font file, without the `.ttf' or `.otf' extension. +.RE +.RS 4 +.RE +.Ip "\fImtx\fR" 4 +.IX Item "mtx" +The output \fImtx\fR file is in standard \fIfontinst\fR format. The name of this file +is \f(CW\*(C`reset<font>\-<encoding>\-<suffix>.mtx\*(C'\fR, +.Sp +where \fIfont\fR, \fIencoding\fR and \fIsuffix\fR have the same meaning as above. +.Ip "\fIextra\fR" 4 +.IX Item "extra" +The option \fB\-x\fR can be used to name a file containing extra substitutions +that complement or override the ones specified by the selected features. +It consists of one substitution per line; each is either of the form +\&\f(CW\*(C`<from>;<to>\*(C'\fR, where \fIfrom\fR and \fIto\fR are both glyph indices +(specified as four hexadecimal digits), or of the form +\&\f(CW\*(C`<glyph name>;<glyph index>\*(C'\fR, where \fIglyph name\fR is any glyph name +and \fIglyph index\fR the glyph index (again, four hex digits) that is to be +mapped to the specified glyph name. The \fIexamples/\fR subdirectory in the +\&\fIfontools\fR distribution contains some examples of user-defined +substitution files. +.SH "CAVEATS" +.IX Header "CAVEATS" +.Ip "\fB-\fR" 2 +.IX Item "-" +Most OpenType fonts contain several tables in the `cmap' table, +for different platforms and different encodings. +\&\fBcmap2enc\fR only reads the first table that implements Unicode, that is, +the first table with either platformID = 0 and encodingID = 3 or 4 +or platformID = 3 and encodingID = 1 or 10. +At least one of those will probably always be present, and (afaik) it doesn't +matter which of these is used. +.Sp +The fact that only tableFormat = 4 is supported might be more of a restriction, +though I haven't yet found any font that used a different tableFormat. +.Ip "\fB-\fR" 2 +.IX Item "-" +OpenType fonts implement features using so-called `Lookup Tables'. +\&\fBcmap2enc\fR supports only features from the `\s-1GSUB\s0' table that have +LookupType = 1 (single substitution). +.Sp +Some features are implemented as a combination of lookups from both +the `\s-1GSUB\s0' and the `\s-1GPOS\s0' tables; these features are (currently?) +not supported. An example of this are the `sinf' (Scientific Inferiors) and +\&'subs' (Subscripts) features of Linotype Palatino; these are implemented +by first replacing the standard numerals with smaller ones and then +adjusting their position. +.Ip "\fB-\fR" 2 +.IX Item "-" +Some of the font's features may yield surprising results. E.g., Linotype +Palatino doesn't have small-caps forms of dotlessi, germandbls and the +standard f-ligatures, so it will give you the lowercase forms of these glyphs +even when the `smcp' feature is specified. +(The \fIexamples/palatinox\fR subdirectory contains a file \fIunsetSCaps.mtx\fR +that deletes these lowercase forms; \fIfontinst\fR's \fInewlatin.mtx\fR file +will then create fake small-caps forms of these glyphs.) +.Ip "\fB-\fR" 2 +.IX Item "-" +If the user-defined substitution file substitutes glyph1 with glyph2, +\&\fBcmap2enc\fR will also substitute glyph2 with glyph2; this may seem silly, +but it means that any selected feature that would substitute glyph2 with glyph3 +gets overridden. +.Ip "\fB-\fR" 2 +.IX Item "-" +The glyph names are independent of the features selected, e.g., when using +features like `smcp' or `onum', glyph names still come out as `a' and `zero' +rather than `Asmall' and `zerooldstyle'. When installing the font with +\&\fIfontinst\fR, you should therefore always use \fIt1.etx\fR rather than \fIt1c.etx\fR +or \fIt1j.etx\fR. +.SH "SEE ALSO" +.IX Header "SEE ALSO" +The other programs in the \fIfontools\fR bundle: \fIafm2afm\fR, \fIautoinst\fR, +\&\fIfont2afm\fR, \fIot2kpx\fR, \fIpfm2kpx\fR, \fIshowglyphs\fR. +.PP +A good free (as in beer) Perl-implementation for Windows (and Linux) +is ActivePerl, available from \fIhttp://www.activestate.com\fR. +.SH "AUTHOR" +.IX Header "AUTHOR" +Marc Penninga <marc@penninga.info> +.PP +If you're sending a bug report, please give as much information as possible. +Also be sure to mention the name \fIfontools\fR somewhere in the subject line, +or risk being caught by my spam filter. +.SH "COPYRIGHT" +.IX Header "COPYRIGHT" +Copyright (c) 2005, 2006 Marc Penninga. +.SH "LICENSE" +.IX Header "LICENSE" +This program is free software; you can redistribute it and/or modify +it under the terms of version 2 of the \s-1GNU\s0 General Public License +as published by the Free Software Foundation. +.PP +A copy of the \s-1GNU\s0 General Public License is included with the \fIfontools\fR +collection; 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 "HISTORY" +.IX Header "HISTORY" +.Ip "\fI2006\-01\-17\fR" 12 +.IX Item "2006-01-17" +Changed the names of the generated output files; extended the documentation. +.Ip "\fI2005\-08\-01\fR" 12 +.IX Item "2005-08-01" +Removed some warning messages that didn't convey any useful information; +added contents of \fIglyphlist.txt\fR to the program itself and removed +the file from the \fIfontools\fR collection; +expanded the example in the documentation +.Ip "\fI2005\-04\-29\fR" 12 +.IX Item "2005-04-29" +Improved the documentation +.Ip "\fI2005\-03\-21\fR" 12 +.IX Item "2005-03-21" +Fixed somed bugs; added `titl' feature +.Ip "\fI2005\-03\-15\fR" 12 +.IX Item "2005-03-15" +Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR +.Ip "\fI2005\-03\-08\fR" 12 +.IX Item "2005-03-08" +Input files searched via \fBkpsewhich\fR (where available) +.Ip "\fI2005\-02\-18\fR" 12 +.IX Item "2005-02-18" +Rewrote some of the code, fixed a few bugs +.Ip "\fI2005\-01\-10\fR" 12 +.IX Item "2005-01-10" +First version diff --git a/Master/texmf/doc/man/man1/font2afm.1 b/Master/texmf/doc/man/man1/font2afm.1 new file mode 100644 index 00000000000..a692930536e --- /dev/null +++ b/Master/texmf/doc/man/man1/font2afm.1 @@ -0,0 +1,196 @@ +.\" Automatically generated by Pod::Man version 1.15 +.\" Wed Aug 30 11:37:48 2006 +.\" +.\" 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 +.ne \\$1 +.. +.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 +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. 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 \{\ +. 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 +.\" +.\" 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 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ====================================================================== +.\" +.IX Title "FONT2AFM 1" +.TH FONT2AFM 1 "fontools" "2006-08-30" "fontools" +.UC +.SH "NAME" +font2afm \- create font metrics (in \fIafm\fR format) for (almost) any font file +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +font2afm [options] \fIfont\fR ... +.PP +font2afm [options] @\fIfilelist\fR +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +\&\fBfont2afm\fR generates font metrics (in Adobe's \fIafm\fR format) for Type1, +TrueType and OpenType fonts. +.PP +\&\fBfont2afm\fR is just a wrapper script around several utilities (\fBcfftot1\fR, +\&\fBpf2afm\fR, \fBttf2afm\fR, \fBpfm2kpx\fR and \fBot2kpx\fR) that do the real work. +All these utilities need to be available on your system. +.SH "OPTIONS" +.IX Header "OPTIONS" +.Ip "\fB\-f\fR" 4 +.IX Item "-f" +Force overwriting of existing \fIafm\fR files. +.SH "FILES" +.IX Header "FILES" +.Ip "\fIfont\fR" 4 +.IX Item "font" +This can be any Type1 (in either \fIpfa\fR or \fIpfb\fR format), TrueType or +OpenType (both PostScript- and TrueType-flavored) font. +.Ip "\fIfilelist\fR" 4 +.IX Item "filelist" +This should contain a newline-separated list of font filenames. +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIpf2afm\fR (part of \fIGhostScript\fR), \fIttf2afm\fR (part of \fIpdfTeX\fR), +\&\fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, \fIot2kpx\fR, \fIpfm2kpx\fR, \fIcfftot1\fR +(part of Eddie Kohler's \fI\s-1LCDF\s0 TypeTools\fR). +.SH "AUTHOR" +.IX Header "AUTHOR" +Marc Penninga <marc@penninga.info> +.SH "HISTORY" +.IX Header "HISTORY" +.Ip "\fI2005\-04\-15\fR" 12 +.IX Item "2005-04-15" +First version +.Ip "\fI2005\-04\-29\fR" 12 +.IX Item "2005-04-29" +Improved the documentation +.Ip "\fI2005\-05\-23\fR" 12 +.IX Item "2005-05-23" +Bugfix. +.Ip "\fI2005\-07\-29\fR" 12 +.IX Item "2005-07-29" +Added support for PostScript-flavored (\fIotf\fR) OpenType fonts. +.Ip "\fI2005\-08\-08\fR" 12 +.IX Item "2005-08-08" +Bugfix. diff --git a/Master/texmf/doc/man/man1/ot2kpx.1 b/Master/texmf/doc/man/man1/ot2kpx.1 new file mode 100644 index 00000000000..1c180d772ea --- /dev/null +++ b/Master/texmf/doc/man/man1/ot2kpx.1 @@ -0,0 +1,205 @@ +.\" Automatically generated by Pod::Man version 1.15 +.\" Mon Apr 2 10:44:41 2007 +.\" +.\" 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 +.ne \\$1 +.. +.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 +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. 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 \{\ +. 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 +.\" +.\" 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 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ====================================================================== +.\" +.IX Title "OT2KPX 1" +.TH OT2KPX 1 "fontools" "2007-04-02" "fontools" +.UC +.SH "NAME" +ot2kpx \- extract kerning information from an OpenType font +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +ot2kpx \fIfont\fR +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +In many OpenType fonts, most kerning data is stored in the `\s-1GPOS\s0' table rather +than in the `kern' table. \fBot2kpx\fR extracts the kerning data from both tables +and prints it (in \fIafm\fR format) to \f(CW\*(C`stdout\*(C'\fR. +.SH "RESTRICTIONS" +.IX Header "RESTRICTIONS" +.Ip "\fB-\fR" 2 +.IX Item "-" +\&\fBot2kpx\fR prints data from all features named `kern', regardless of script +and language. Maybe it would be better to let the user choose a script +and language (defaulting to `latn' and `\s-1DFLT\s0') and print only the kerning +data from features associated with these values. +.Ip "\fB-\fR" 2 +.IX Item "-" +\&\fBot2kpx\fR uses only the XAdvance data associated with the first glyph in any +kerning pair; all other data in the ValueRecords is ignored. I'm not sure +whether this is The Right Thing to Do; however, almost always there is +no other data, so this approach gives correct results (in fact, the only +font I know of that does contain data other than XAdvance is Linotype +Palatino; this also contains XAdvDevice data, which is used (according to +the OpenType specification) to \fI`define subtle, device-dependent adjustments +at specific font sizes or device resolutions'\fR. Since there is no way to +express such adjustments in \fIafm\fR format, ignoring them seems to be the +only option.) +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, \fIfont2afm\fR, \fIpfm2kpx\fR. +.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\-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 +.Ip "\fI2005\-03\-21\fR" 12 +.IX Item "2005-03-21" +Test if \s-1GPOS\s0 table is present before trying to read it +.Ip "\fI2005\-04\-29\fR" 12 +.IX Item "2005-04-29" +Improved the documentation +.Ip "\fI2005\-05\-25\fR" 12 +.IX Item "2005-05-25" +Changed warning that's given when the font contains no \s-1GPOS\s0 table, to an +informational message. +.Ip "\fI2005\-07\-29\fR" 12 +.IX Item "2005-07-29" +A few updates to the documentation diff --git a/Master/texmf/doc/man/man1/pfm2kpx.1 b/Master/texmf/doc/man/man1/pfm2kpx.1 new file mode 100644 index 00000000000..0f3f38b6455 --- /dev/null +++ b/Master/texmf/doc/man/man1/pfm2kpx.1 @@ -0,0 +1,208 @@ +.\" Automatically generated by Pod::Man version 1.15 +.\" Fri Jul 29 13:54:23 2005 +.\" +.\" 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 +.ne \\$1 +.. +.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 +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. 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 \{\ +. 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 +.\" +.\" 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 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ====================================================================== +.\" +.IX Title "PFM2KPX 1" +.TH PFM2KPX 1 "fontools" "2005-07-29" "fontools" +.UC +.SH "NAME" +pfm2kpx \- extract correct kerning information from \fIpfm\fR +(Printer Font Metrics) files +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +pfm2kpx [options] \fIpfm\fR +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +Many PostScript Type1 fonts contain only +\&\fIpfb\fR and \fIpfm\fR files, but no \fIafm\fR (Adobe Font Metrics) files. These can be +generated with \fIpf2afm\fR (which comes with \fIGhostScript\fR), but +this might not yield all kerning pairs from the \fIpfm\fR file. The reason +for this is that \fIpf2afm\fR interprets \f(CW\*(C`dfCharSet = 0x00\*(C'\fR to mean that +the Adobe StandardEncoding has been used, whereas many fonts (or font +creation tools) instead use the Windows \s-1ANSI\s0 (aka codepage 1252) encoding. +(You know you've hit this problem when \fBpf2afm\fR complains "\f(CW\*(C`.notdef +character ocurred among kern pairs \-\- you'd better check the resulting +AFM file\*(C'\fR".) In this case, the resulting \fIafm\fR is incomplete and contains +wrong kerning pairs. +.PP +\&\fBpfm2kpx\fR extracts the correct kerning pairs from such \fIpfm\fR files and +repairs the \fIafm\fR (if necessary creating it first by running \fIpf2afm\fR). +If for some reason it can't update the \fIafm\fR, it prints the kerning pairs to +\&\f(CW\*(C`stdout\*(C'\fR instead. +.PP +When \fIpf2afm\fR doesn't complain about the kerning pairs, \fBpfm2kpx\fR +thinks the resulting \fIafm\fR file is fine and quits; this can be +changed by specifying the \fB\-f\fR option (see below). +.SH "OPTIONS" +.IX Header "OPTIONS" +.Ip "\fB\-f\fR" 4 +.IX Item "-f" +Force updating of the \fIafm\fR file, even if \fIpf2afm\fR doesn't complain. +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIpf2afm\fR (part of GhostScript), \fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, +\&\fIfont2afm\fR, \fIot2kpx\fR. +.SH "AUTHOR" +.IX Header "AUTHOR" +Marc Penninga <marc@penninga.info> +.SH "HISTORY" +.IX Header "HISTORY" +.Ip "\fI2005\-02\-17\fR" 12 +.IX Item "2005-02-17" +First version +.Ip "\fI2005\-02\-18\fR" 12 +.IX Item "2005-02-18" +Added \f(CW\*(C`binmode PFM\*(C'\fR to make \fBpfm2kpx\fR work on Windows platforms +.Ip "\fI2005\-03\-08\fR" 12 +.IX Item "2005-03-08" +Input files searched via \fBkpsewhich\fR (where available) +.Ip "\fI2005\-03\-14\fR" 12 +.IX Item "2005-03-14" +Rewrote some of the code to make it more robust, added the \fB\-f\fR option +.Ip "\fI2005\-03\-15\fR" 12 +.IX Item "2005-03-15" +Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR +.Ip "\fI2005\-04\-29\fR" 12 +.IX Item "2005-04-29" +Improved the documentation +.Ip "\fI2005\-05\-24\fR" 12 +.IX Item "2005-05-24" +Bugfix. +.Ip "\fI2005\-07\-29\fR" 12 +.IX Item "2005-07-29" +Some updates to the documentation. diff --git a/Master/texmf/doc/man/man1/showglyphs.1 b/Master/texmf/doc/man/man1/showglyphs.1 new file mode 100644 index 00000000000..06165b1be0f --- /dev/null +++ b/Master/texmf/doc/man/man1/showglyphs.1 @@ -0,0 +1,185 @@ +.\" Automatically generated by Pod::Man version 1.15 +.\" Fri Jul 29 13:54:24 2005 +.\" +.\" 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 +.ne \\$1 +.. +.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 +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. 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 \{\ +. 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 +.\" +.\" 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 +. ds #V .8m +. ds #F .3m +. ds #[ \f1 +. ds #] \fP +.\} +.if t \{\ +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) +. ds #V .6m +. ds #F 0 +. ds #[ \& +. ds #] \& +.\} +. \" simple accents for nroff and troff +.if n \{\ +. ds ' \& +. ds ` \& +. ds ^ \& +. ds , \& +. ds ~ ~ +. ds / +.\} +.if t \{\ +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' +.\} +. \" troff and (daisy-wheel) nroff accents +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] +.ds ae a\h'-(\w'a'u*4/10)'e +.ds Ae A\h'-(\w'A'u*4/10)'E +. \" corrections for vroff +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' +. \" for low resolution devices (crt and lpr) +.if \n(.H>23 .if \n(.V>19 \ +\{\ +. ds : e +. ds 8 ss +. ds o a +. ds d- d\h'-1'\(ga +. ds D- D\h'-1'\(hy +. ds th \o'bp' +. ds Th \o'LP' +. ds ae ae +. ds Ae AE +.\} +.rm #[ #] #H #V #F C +.\" ====================================================================== +.\" +.IX Title "SHOWGLYPHS 1" +.TH SHOWGLYPHS 1 "fontools" "2005-07-29" "fontools" +.UC +.SH "NAME" +showglyphs \- create a \fIpdf\fR file that shows all glyphs in a font +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +showglyphs \fIfontfile\fR +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +This program creates a \fIpdf\fR file that shows all glyphs in a given font. +.SH "FILES" +.IX Header "FILES" +.Ip "\fIfont\fR" 4 +.IX Item "font" +This can be any Type 1 or TrueType font; OpenType fonts are not (yet?) +supported. +.SH "RESTRICTIONS" +.IX Header "RESTRICTIONS" +.Ip "\fB-\fR" 4 +.IX Item "-" +\&\fBshowglyphs\fR only works on Unix/Linux systems. +.Ip "\fB-\fR" 4 +.IX Item "-" +\&\fBshowglyphs\fR needs a working, TDS-compliant Tex installation +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, \fIpfm2kpx\fR, \fIenc2etx\fR, +\&\fIetx2enc\fR, \fIot2kpx\fR. +.SH "AUTHOR" +.IX Header "AUTHOR" +Marc Penninga <marc@penninga.info> +.SH "HISTORY" +.IX Header "HISTORY" +.Ip "\fI2005\-04\-28\fR" 12 +.IX Item "2005-04-28" +First version +.Ip "\fI2005\-04\-29\fR" 12 +.IX Item "2005-04-29" +A few bugfixes; \fBshowglyphs\fR now works with glyphnames containing underscores +.Ip "\fI2005\-05\-24\fR" 12 +.IX Item "2005-05-24" +Another bugfix +.Ip "\fI2005\-07\-29\fR" 12 +.IX Item "2005-07-29" +A few updates to the documentation |