diff options
Diffstat (limited to 'Master/texmf-dist/doc/dvips/dvips.html')
| -rw-r--r-- | Master/texmf-dist/doc/dvips/dvips.html | 144 |
1 files changed, 81 insertions, 63 deletions
diff --git a/Master/texmf-dist/doc/dvips/dvips.html b/Master/texmf-dist/doc/dvips/dvips.html index 5ff67700e09..9ee7e75896a 100644 --- a/Master/texmf-dist/doc/dvips/dvips.html +++ b/Master/texmf-dist/doc/dvips/dvips.html @@ -1,9 +1,9 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- This manual documents Dvips version 5.995 -(April 2015), a program to translate a DVI file into +<!-- This manual documents Dvips version 5.996 +(April 2016), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. --> -<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ --> <head> <title>Dvips: A DVI-to-PostScript translator</title> @@ -20,16 +20,16 @@ PostScript. You may freely use, modify and/or distribute this file. --> <style type="text/css"> <!-- a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} blockquote.smallquotation {font-size: smaller} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} -div.indentedblock {margin-left: 3.2em} div.lisp {margin-left: 3.2em} div.smalldisplay {margin-left: 3.2em} div.smallexample {margin-left: 3.2em} -div.smallindentedblock {margin-left: 3.2em; font-size: smaller} div.smalllisp {margin-left: 3.2em} -kbd {font-style:oblique} +kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} pre.menu-comment {font-family: serif} @@ -38,10 +38,9 @@ pre.smalldisplay {font-family: inherit; font-size: smaller} pre.smallexample {font-size: smaller} pre.smallformat {font-family: inherit; font-size: smaller} pre.smalllisp {font-size: smaller} -span.nocodebreak {white-space:nowrap} -span.nolinebreak {white-space:nowrap} -span.roman {font-family:serif; font-weight:normal} -span.sansserif {font-family:sans-serif; font-weight:normal} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} ul.no-bullet {list-style: none} --> </style> @@ -49,7 +48,7 @@ ul.no-bullet {list-style: none} </head> -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> +<body lang="en"> <h1 class="settitle" align="center">Dvips: A DVI-to-PostScript translator</h1> @@ -205,8 +204,8 @@ Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why Dvips</a>, Up: <a href=" <a name="Dvips"></a> <h1 class="top">Dvips</h1> -<p>This manual documents Dvips version 5.995 -(April 2015), a program to translate a DVI file into +<p>This manual documents Dvips version 5.996 +(April 2016), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. </p> @@ -314,10 +313,10 @@ Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Pre <p>Installing Dvips is mostly the same as installing any Kpathsea-using program. Therefore, for the basic steps involved, -see <a href="kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. +see <a href="http://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. </p> <p>For solutions to common installation problems and information on how to -report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems, +report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="http://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems, see <a href="#Debug-options">Debug options</a>. Also see the Dvips home page at <a href="http://www.radicaleye.com/dvips">http://www.radicaleye.com/dvips</a>. </p> @@ -357,7 +356,7 @@ printer (output device). Since these are site-specific, <code>make install</code> does not create them; you must create them yourself. </p> <p>(These Dvips configuration files are independent of the Kpathsea -configuration file <samp>texmf.cnf</samp> (see <a href="kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). +configuration file <samp>texmf.cnf</samp> (see <a href="http://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). </p> <a name="index-config_002eproto"></a> <a name="index-prototype-printer-configuration-file"></a> @@ -511,7 +510,7 @@ work. The following sections provide some helpful hints if you find yourself in such a situation. </p> <p>For details on effective bug reporting, common installation problems, -and <code>mktexpk</code> problems, see <a href="kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>. +and <code>mktexpk</code> problems, see <a href="http://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>. </p> <p>A good first debugging operation is to set the environment variable <code>DVIPSDEBUG</code>, which will display any configuration and map files @@ -555,7 +554,7 @@ To track all classes, you can use <code>-1</code>. </p> <p>You can also set the environment variable <code>KPATHSEA_DEBUG</code> instead of using ‘<samp>-d</samp>’. Some of these debugging options are actually -provided by Kpathsea (see <a href="kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). +provided by Kpathsea (see <a href="http://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). </p> <p>The classes are: </p> @@ -822,7 +821,7 @@ progress reports appear by default. The next time that document is printed, these fonts will have been saved in the proper directories, so printing will go much faster. (If Dvips tries to endlessly generate the same fonts over and over again, it hasn’t been installed properly. -See <a href="kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.) +See <a href="http://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.) </p> <p>Many options are available (see the next section). For a brief summary of available options, just type @@ -1190,8 +1189,8 @@ no matter what the pages are actually numbered. generation. This overrides any value from configuration files. With the default paths, explicitly specifying the mode also makes the program assume the fonts are in a subdirectory named <var>mode</var>. -See <a href="kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite>Kpathsea</cite>. If Metafont does not understand the <var>mode</var> name, see -<a href="kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>. +See <a href="http://tug.org/texinfohtml/kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite>Kpathsea</cite>. If Metafont does not understand the <var>mode</var> name, see +<a href="http://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>. </p> </dd> <dt>‘<samp>-M*</samp>’</dt> @@ -1259,7 +1258,7 @@ larger. If you find this unacceptable or encounter another problem with the Omega or pTeX extensions, you can switch off the pTeX extension by using ‘<samp>-noptex</samp>’, or both by using ‘<samp>-noomega</samp>’ (but please do send a bug report if you find such problems, -see <a href="kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). +see <a href="http://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). </p> </dd> <dt>‘<samp>-o <var>name</var></samp>’</dt> @@ -1561,7 +1560,7 @@ configuration files are read, so they override values in the configuration files. (Except for <code>TEXCONFIG</code>, which defines where the configuration files themselves are found.) </p> -<p>See <a href="kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of +<p>See <a href="http://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of interpretation of path and other environment variables common to all Kpathsea-using programs. Only the environment variables specific to Dvips are mentioned here. @@ -1576,7 +1575,7 @@ standard output, for debugging. This isn’t done by default because these files are read even before the banner is printed. For voluminous additional debugging, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ -(see <a href="kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is +(see <a href="http://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is set to any value, it automatically turns on <code>DVIPSDEBUG</code>.) </p> </dd> @@ -1584,7 +1583,7 @@ set to any value, it automatically turns on <code>DVIPSDEBUG</code>.) <a name="index-DVIPSFONTS"></a> </dt> <dd><p>Default path to search for all fonts. Overrides all the font path -config file options and other environment variables (see <a href="kpathsea.html#Supported-file-formats">Supported +config file options and other environment variables (see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). </p> </dd> @@ -1602,7 +1601,7 @@ config file option (see <a href="#Configuration-file-commands">Configuration fil <p>Overrides ‘<samp>mktexpk</samp>’ as the name of the program to invoke to create missing PK fonts. You can change the arguments passed to the <code>mktexpk</code> program with the <code>MAKETEXPK</code> environment -variable; see <a href="kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>. +variable; see <a href="http://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>. </p> </dd> <dt><code>DVIPSRC</code> @@ -1644,7 +1643,7 @@ platforms.) </dt> <dd><p>Path to search for included graphics files. Overrides the ‘<samp>S</samp>’ config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>). If not set, -<code>TEXINPUTS</code> is looked for. See <a href="kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +<code>TEXINPUTS</code> is looked for. See <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </p> </dd> </dl> @@ -1665,7 +1664,7 @@ Previous: <a href="#Environment-variables" accesskey="p" rel="prev">Environment device configuration files (called <samp>*.cfg</samp> on MS-DOS), which override the <samp>texmf.cnf</samp> configuration files generic to Kpathsea which Dvips also reads -(see <a href="kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). +(see <a href="http://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). </p> <p>For information about installing these files, including a prototype file you can copy, see <a href="#config_002eps-installation">config.ps installation</a>. @@ -1698,7 +1697,7 @@ or individually by each user. <li> <a name="index-config_002eps_002c-searched-for"></a> Dvips first reads (if it exists) <samp>config.ps</samp>; it is searched for along the path for Dvips configuration files, as described in -<a href="kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +<a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </li><li> <a name="index-_002edvipsrc_002c-searched-for"></a> A user-specific startup file is loaded, so individual users can override @@ -1710,7 +1709,7 @@ the name <samp>$HOME/.dvipsrc</samp>, which is in the user’s home director On MS-DOS and MS-Windows, where users generally don’t have their private directories, the startup file is called <samp>dvips.ini</samp> and it is searched for along the path for Dvips configuration files (as described -in <a href="kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.); users are +in <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.); users are expected to set this path as they see fit for their taste. </li><li> <a name="index-_002dPprinter_002c-and-config-file-searching"></a> @@ -1964,7 +1963,7 @@ global map file. This can be used for font families. <a name="index-TEXFONTS_002c-overrides-P"></a> <p>Use <var>path</var> to search for bitmap PK font files is <var>path</var>. The <code>PKFONTS</code>, <code>TEXPKS</code>, <code>GLYPHFONTS</code>, and <code>TEXFONTS</code> -environment variables override this. See <a href="kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +environment variables override this. See <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </p> </dd> <dt>‘<samp>q*</samp>’</dt> @@ -2601,8 +2600,8 @@ TeX, add a line like this near the top of your input file: <pre class="example">\input epsf </pre></div> -<a name="index-epsf_002esty"></a> -<p>If you are using LaTeX 2.09, add the ‘<samp>epsf</samp>’ style option, as in: +<p><a name="index-epsf_002esty"></a> +If you are using LaTeX 2.09, add the ‘<samp>epsf</samp>’ style option, as in: </p> <div class="example"> <pre class="example">\documentstyle[12pt,epsf]{article} @@ -2956,8 +2955,8 @@ file to standard output. For example: <pre class="example">\special{psfile="`gnuplot foo"} </pre></div> -<a name="index-gnuplot"></a> -<p>to include the file <samp>foo</samp>. Of course, the command to be executed +<p><a name="index-gnuplot"></a> +to include the file <samp>foo</samp>. Of course, the command to be executed can be anything, including using a file conversion utility such as <samp>tek2ps</samp> or whatever is appropriate. This feature can be disabled with the ‘<samp>-R</samp>’ command-line option or ‘<samp>R</samp>’ configuration option. @@ -3023,7 +3022,7 @@ treated as a bitmap. For example, if your figure used the single letter </dl> <p>MetaPost’s output figures contain lines like this for bitmap fonts used -in a MetaPost label (see <a href="web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>). +in a MetaPost label (see <a href="http://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>). </p> <hr> @@ -3314,8 +3313,8 @@ PostScript comments, for example. <pre class="example">\special{ps: plotfile <var>filename</var>} </pre></div> -<a name="index-rotate_002etex"></a> -<p>inserts the contents of <var>filename</var> verbatim into the output (except +<p><a name="index-rotate_002etex"></a> +inserts the contents of <var>filename</var> verbatim into the output (except for omitting lines that begin with %). An example of the proper use of literal specials can be found in the file <samp>rotate.tex</samp>, which makes it easy to typeset text turned in multiples of 90 degrees. @@ -3485,7 +3484,7 @@ are supported; Ghostscript includes limited distiller support </p> <p>Macros you can use in your TeX document to insert the specials in the first place are available from <samp><var>CTAN:</var>/support/hypertex</samp>. For -CTAN info, see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>. +CTAN info, see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>. </p> <a name="index-http_003a_002f_002fwww_002ewin_002etue_002enl_002f_007edickie_002fidvi"></a> <a name="index-http_003a_002f_002fxxx_002elanl_002egov_002fhypertex"></a> @@ -3570,7 +3569,7 @@ package (e.g., <code>tetex-extra</code> in Debian). Failing that, commercial versions of the Computer Modern fonts are available from Blue Sky; public domain versions - in particular, the lm fonts, and the cm-super fonts, are available from CTAN sites (for CTAN info, -see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). +see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). </p> <p>You can convert a PostScript file to PDF using <code>distill</code>, which comes with Adobe Acrobat, or <code>ps2pdf</code>, which comes with @@ -3837,7 +3836,7 @@ can get AFM files for Adobe’s fonts from TeX uses <em>TeX font metrics</em> (‘<samp>.tfm</samp>’) files. When you say ‘<samp>\font = <var>font</var></samp>’ in your TeX document, TeX reads a file named ‘<samp><var>font</var>.tfm</samp>’. (Well, except for the <samp>texfonts.map</samp> -feature; see <a href="kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then +feature; see <a href="http://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then calculate the space occupied by characters from the font when typesetting. In addition, the DVI drivers you use to print or view the DVI file produced by TeX may need to look at the TFM file. @@ -3847,11 +3846,11 @@ DVI file produced by TeX may need to look at the TFM file. <a name="index-pltotf"></a> <a name="index-_002epl-property-list-files"></a> <p>TFM files are binary (and hence are typically much smaller than AFM -files). You can use the <code>tftopl</code> program (see <a href="web2c.html#tftopl-invocation">tftopl +files). You can use the <code>tftopl</code> program (see <a href="http://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl invocation</a> in <cite>Web2c</cite>) that comes with TeX to transform a TFM file into a human-readable “property list” (‘<samp>.pl</samp>’) file. You can also edit a PL file and transform it back to a TeX-readable TFM with -the companion program <code>pltotf</code> (see <a href="web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you’re likely to want +the companion program <code>pltotf</code> (see <a href="http://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you’re likely to want to do often, but the capability is there. </p> </li><li> <a name="index-pfm-files"></a> @@ -3957,7 +3956,7 @@ isn’t a reference manual on virtual fonts. For more information: The primary document on virtual fonts is Donald E. Knuth, <cite>TUGboat</cite> 11(1), Apr. 1990, pp. 13–23, “Virtual Fonts: More Fun for Grand Wizards” (<samp><var>CTAN:</var>/info/virtual-fonts.knuth</samp>; for CTAN info, -see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). (Don’t be intimidated by +see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). (Don’t be intimidated by the subtitle.) </p> <a name="index-vf-files"></a> @@ -3966,8 +3965,8 @@ the subtitle.) virtual font, a recipe for typesetting that character. A VF file, like a TFM file, is in a compressed binary format. The <code>vftovp</code> and <code>vptovf</code> programs convert a VF file to a human-readable VPL -(virtual property list) format and back again. See <a href="web2c.html#vftovp-invocation">vftovp -invocation</a> in <cite>Web2c</cite>, and <a href="web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>. +(virtual property list) format and back again. See <a href="http://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp +invocation</a> in <cite>Web2c</cite>, and <a href="http://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>. </p> <a name="index-base-fonts"></a> <p>In the case of a PostScript font <var>f</var> being used in a straightforward @@ -3984,7 +3983,7 @@ created when you run <code>vptovf</code>. <a name="index-expansion_002c-of-virtual-fonts"></a> <a name="index-virtual-font-expansion"></a> <p>You can <em>expand</em> virtual fonts into their base fonts with DVIcopy -(see <a href="web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are +(see <a href="http://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are using a DVI translator that doesn’t understand vf’s itself. </p> @@ -4303,10 +4302,11 @@ can also obtain special effects such as an oblique font. <a name="index-fontinst"></a> <a name="index-virtual-fonts_002c-creating"></a> <a name="index-Jeffrey_002c-Alan"></a> -<p>An alternative to Afm2tfm for creating virtual fonts is Alan Jeffrey’s -<code>fontinst</code> program, available from -<samp><var>CTAN:</var>fonts/utilities/fontinst</samp> (for CTAN info, -see <a href="kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). +<p>Alternatives to Afm2tfm for creating virtual fonts include +<code>fontinst</code> <a href="http://ctan.org/pkg/fontinst">http://ctan.org/pkg/fontinst</a>, +<code>lcdf-typetools</code>, particularly <code>otftotfm</code> +(<a href="http://ctan.org/pkg/lcdf-typetools">http://ctan.org/pkg/lcdf-typetools</a>), and <code>afm2p</code> +(<a href="http://tex.aanhet.net/afm2pl/">http://tex.aanhet.net/afm2pl/</a>), among others. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a>:</td><td> </td><td align="left" valign="top">Reencoding with -t, -p, -T. @@ -4687,8 +4687,8 @@ put the line <pre class="example">rptmro Times-Roman ".167 SlantFont" </pre></div> -<a name="index-psfonts_002emap-1"></a> -<p>into <samp>psfonts.map</samp>. Then ‘<samp>rptmro</samp>’ (our name for the obliqued +<p><a name="index-psfonts_002emap-1"></a> +into <samp>psfonts.map</samp>. Then ‘<samp>rptmro</samp>’ (our name for the obliqued Times) will act as if it were a resident font, although it is actually constructed from Times-Roman via the PostScript routine <code>SlantFont</code> (which will slant everything 1/6 to the right, in this case). @@ -4769,9 +4769,10 @@ Previous: <a href="#Special-font-effects" accesskey="p" rel="prev">Special font <pre class="example">afm2tfm [<var>option</var>]… <var>afmfile</var>[.afm] [<var>tfmfile</var>[.tfm]] </pre></div> -<p>Afm2tfm reads <var>afmfile</var> and writes a corresponding (but raw) TFM -file. If <var>tfmfile</var> is not supplied, the base name of the AFM file is -extended with ‘<samp>.tfm</samp>’ to get the output filename. +<p>Afm2tfm reads <var>afmfile</var> and writes a corresponding (but “raw”, +see below) TFM file. If <var>tfmfile</var> is not supplied, the base name +of the AFM file is extended with ‘<samp>.tfm</samp>’ to get the output +filename. </p> <p>The simplest example: </p> @@ -4780,14 +4781,15 @@ extended with ‘<samp>.tfm</samp>’ to get the output filename. </pre></div> <a name="index-accents_002c-wrong"></a> +<a name="index-raw-tfm-files"></a> <p>The TFM file thus created is <em>raw</em> because it omits ligature and -kern information, and does no character remapping; it simply contains -the character information in the AFM file in TFM form, which is the form +kern information, and does no character remapping; it contains only +the character information in the AFM file in TFM format, which is the form that TeX understands. The characters have the same code in the TFM file as in the AFM file. For text fonts, this means printable ASCII characters will work ok, but little else, because standard PostScript fonts have a different encoding scheme than the one that plain TeX -expects (see <a href="#Encodings">Encodings</a>). Although both schemes agree for the +expects (see <a href="#Encodings">Encodings</a>). Although the encodings agree for most printable ASCII characters, other characters such as ligatures and accents vary. Thus, in practice, it’s almost always desirable to create a virtual font as well with the ‘<samp>-v</samp>’ or ‘<samp>-V</samp>’ option. @@ -4796,6 +4798,19 @@ See <a href="#Making-a-font-available">Making a font available</a>. <p>The command line options to Afm2tfm: </p> <dl compact="compact"> +<dt>‘<samp>-a</samp>’</dt> +<dd><a name="index-_002da-1"></a> +<a name="index-accent-height-adjustment_002c-omitting"></a> +<p>By default, Afm2tfm looks for precomposed accented characters, such as +tdieresis, and possibly adjusts the height of the basic letter (t) +upward so that the result of using <code>\accent</code> (as in <code>\"t</code>) +is visually the same as the precomposed characters. The <code>-a</code> +option omits such adjustments, so that all characters’ heights remain +as they are given in the AFM file. (Until Afm2tfm 8.4, released in +2016, heights could also be adjusted downward, but this is no longer +the case.) +</p> +</dd> <dt>‘<samp>-c <var>ratio</var></samp>’</dt> <dd><a name="index-_002dc-ratio"></a> <a name="index-scaling-small-caps"></a> @@ -5114,8 +5129,8 @@ example: \Blue{nesting blue}, recovering the red} and back to original. </pre></div> -<a name="index-color-nesting-level"></a> -<p>The color nesting level has no hard limit, but it is not advisable to +<p><a name="index-color-nesting-level"></a> +The color nesting level has no hard limit, but it is not advisable to nest too deeply lest you and the reader lose track of the color history. </p> <p>The global color command has the form @@ -5124,8 +5139,8 @@ nest too deeply lest you and the reader lose track of the color history. <pre class="example">\text<var>ColorName</var> </pre></div> -<a name="index-_005ctextColorName"></a> -<p>These macros take no arguments and changes the default color from that +<p><a name="index-_005ctextColorName"></a> +These macros take no arguments and changes the default color from that point on to <var>ColorName</var>. This of course can be overridden globally by another such command or locally by local color commands. For example, expanding on the example above, we might have @@ -5563,6 +5578,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-_002d_002dversion"><code>--version</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002da"><code>-a</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dA"><code>-A</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002da-1"><code>-a</code></a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dB"><code>-B</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002db-num"><code>-b <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dc-num"><code>-c <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> @@ -5697,6 +5713,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-absolute-filenames_002c-disabling">absolute filenames, disabling</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dl">absolute page number, and ‘<samp>-l</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dp">absolute page number, and ‘<samp>-p</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-accent-height-adjustment_002c-omitting">accent height adjustment, omitting</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-accents_002c-in-wrong-position">accents, in wrong position</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-accents_002c-wrong">accents, wrong</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-accuracy-in-positioning">accuracy in positioning</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> @@ -6147,6 +6164,7 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <tr><th><a name="Index_cp_letter-R">R</a></th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-r-config-command-_0028page-reversal_0029"><code>r <span class="roman">config command (page reversal)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> <tr><td></td><td valign="top"><a href="#index-R-fallback-resolution-config-command"><code>R <span class="roman">fallback resolution config command</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-raw-tfm-files">raw tfm files</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-reencode_002f_002a_002eenc"><code>reencode/*.enc</code></a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-reencoding">reencoding</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-reencoding-PostScript-fonts">reencoding PostScript fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |