diff options
author | Karl Berry <karl@freefriends.org> | 2011-06-22 15:12:10 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-06-22 15:12:10 +0000 |
commit | 3d484dbd59d1501386da5ec4eb44b9b6f39132e9 (patch) | |
tree | 38b40a7f82707fa6753e81d48a64f764da6f0aa7 /Master/texmf/doc/kpathsea | |
parent | e9926fd469aff4508bb8cacdfa41eb2186e40ef8 (diff) |
texinfo manual updates
git-svn-id: svn://tug.org/texlive/trunk@23088 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/kpathsea')
-rw-r--r-- | Master/texmf/doc/kpathsea/kpathsea.html | 64 | ||||
-rw-r--r-- | Master/texmf/doc/kpathsea/kpathsea.pdf | bin | 445618 -> 443325 bytes |
2 files changed, 34 insertions, 30 deletions
diff --git a/Master/texmf/doc/kpathsea/kpathsea.html b/Master/texmf/doc/kpathsea/kpathsea.html index 075aa10f522..123e826ce95 100644 --- a/Master/texmf/doc/kpathsea/kpathsea.html +++ b/Master/texmf/doc/kpathsea/kpathsea.html @@ -10,7 +10,7 @@ This file documents the Kpathsea library for path searching. Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, -2004, 2005, 2007, 2008, 2009, 2010 Karl Berry & Olaf Weber. +2004, 2005, 2007, 2008, 2009, 2010, 2011 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -170,8 +170,8 @@ Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> <h2 class="unnumbered">Kpathsea library</h2> <p>This manual documents how to install and use the Kpathsea library for -filename lookup. It corresponds to version 6.0.0, -released in July 2010. +filename lookup. It corresponds to version 6.0.1, +released in April 2011. <ul class="menu"> <li><a accesskey="1" href="#Introduction">Introduction</a>: Overview. @@ -197,8 +197,8 @@ Up: <a rel="up" accesskey="u" href="#Top">Top</a> <h2 class="chapter">1 Introduction</h2> <p><a name="index-introduction-1"></a><a name="index-fundamental-purpose-of-Kpathsea-2"></a> -This manual corresponds to version 6.0.0 of the Kpathsea -library, released in July 2010. +This manual corresponds to version 6.0.1 of the Kpathsea +library, released in April 2011. <p>The library's fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do when @@ -1303,7 +1303,7 @@ also be passed: <dl> <dt>‘<samp><span class="samp">--dpi </span><var>num</var></samp>’<dd>Sets the resolution of the generated font to <var>num</var>. <br><dt>‘<samp><span class="samp">--mfmode </span><var>name</var></samp>’<dd>Sets the Metafont mode to <var>name</var>. -<br><dt>‘<samp><span class="samp">--bdpi </span><var>num</var></samp>’<dd>Sets the the “base dpi” for the font. This must match the mode being +<br><dt>‘<samp><span class="samp">--bdpi </span><var>num</var></samp>’<dd>Sets the “base dpi” for the font. This must match the mode being used. <br><dt>‘<samp><span class="samp">--mag </span><var>string</var></samp>’<dd>A “magstep” string suitable for the Metafont <code>mag</code> variable. This must match the combination of <var>bdpi</var> and <var>dpi</var> being used. @@ -2438,8 +2438,14 @@ to look at the distributed <samp><span class="file">texmf.cnf</span></samp>, whi mentions most features. The format of <samp><span class="file">texmf.cnf</span></samp> files follows: <ul> -<li><a name="index-comments_002c-in-_0040file_007btexmf_002ecnf_007d-461"></a>Comments start with ‘<samp><span class="samp">%</span></samp>’ and continue to the end of the line. +<li><a name="index-comments_002c-in-_0040file_007btexmf_002ecnf_007d-461"></a>Comments start with ‘<samp><span class="samp">%</span></samp>’, either at the beginning of a line or +preceded by whitespace, and continue to the end of the line. That is, +as with most shells, a ‘<samp><span class="samp">%</span></samp>’ in the “middle” of a value does not +start a comment. Examples: + <pre class="example"> % this is a comment + var = a%b % but the value of var will be "a%b". +</pre> <li><a name="index-blank-lines_002c-in-_0040file_007btexmf_002ecnf_007d-462"></a>Blank lines are ignored. <li><a name="index-backslash_002dnewline-463"></a><a name="index-continuation-character-464"></a><a name="index-whitespace_002c-not-ignored-on-continuation-lines-465"></a><a name="index-g_t_005c_0040r_007b_002c-line-continuation-in-_0040file_007btexmf_002ecnf_007d_007d-466"></a>A ‘<samp><span class="samp">\</span></samp>’ at the end of a line acts as a continuation character, i.e., @@ -2458,18 +2464,18 @@ lines is not ignored. <li>If ‘<samp><span class="samp">.</span><var>progname</var></samp>’ is present, the definition only applies if the program that is running is named (i.e., the last component of <code>argv[0]</code> is) <var>progname</var> or -<samp><var>progname</var><span class="file">.exe</span></samp>. This allows different flavors of TeX to -have different search paths, for example. +<samp><var>progname</var><span class="file">.{exe,bat,cmd,...}</span></samp>. Most notably, this allows +different flavors of TeX to have different search paths. <li><a name="index-right_002dhand-side-of-variable-assignments-468"></a><var>value</var> may contain any characters except ‘<samp><span class="samp">%</span></samp>’ and ‘<samp><span class="samp">@</span></samp>’. -(These restrictions are only necessary because of the processing done on -<samp><span class="file">texmf.cnf</span></samp> at build time, so you can stick those characters in -after installation if you have to.) The ‘<samp><span class="samp">$</span><var>var</var><span class="samp">.</span><var>prog</var></samp>’ -feature is not available on the right-hand side; instead, you must use -an additional variable (see below for example). A ‘<samp><span class="samp">;</span></samp>’ in -<var>value</var> is translated to ‘<samp><span class="samp">:</span></samp>’ if running under Unix; this is -useful to write a single <samp><span class="file">texmf.cnf</span></samp> which can be used under both -Unix and NT. +(These restrictions are only necessary because of the processing done +on <samp><span class="file">texmf.cnf</span></samp> at build time, so you can stick those characters +in after installation if you have to.) The +‘<samp><span class="samp">$</span><var>var</var><span class="samp">.</span><var>prog</var></samp>’ feature is not available on the +right-hand side; instead, you must use an additional variable (see +below for example). A ‘<samp><span class="samp">;</span></samp>’ in <var>value</var> is translated to +‘<samp><span class="samp">:</span></samp>’ if running under Unix; this is useful to write a single +<samp><span class="file">texmf.cnf</span></samp> which can be used under both Unix and Windows. <li>All definitions are read before anything is expanded, so you can use variables before they are defined (like Make, unlike most other @@ -2487,12 +2493,12 @@ these points: TEXINPUTS.latex2e = $latex2e_inputs TEXINPUTS.latex = $latex2e_inputs </pre> - <p><a name="index-shell-scripts-as-configuration-files-469"></a><a name="index-configuration-files-as-shell-scripts_002e-470"></a>Although this format has obvious similarities to Bourne shell -scripts—change the comment character to <code>#</code>, disallow spaces -around the <code>=</code>, and get rid of the <code>.</code><var>name</var> convention, -and it could be run through the shell. But there seemed little -advantage to doing this, since all the information would have to passed -back to Kpathsea and parsed there anyway, since the <code>sh</code> process + <p><a name="index-shell-scripts-as-configuration-files-469"></a><a name="index-configuration-files-as-shell-scripts_002e-470"></a>This format has obvious similarities to Bourne shell scripts—change +the comment character to <code>#</code>, disallow spaces around the +<code>=</code>, and get rid of the <code>.</code><var>name</var> convention, and it +could be run through the shell. However, there seemed little +advantage in this, since all the information would have to passed back +to Kpathsea and parsed there anyway, since the <code>sh</code> process couldn't affect its parent's environment. <p><a name="index-cnf_002ec-471"></a>The implementation of all this is in <samp><span class="file">kpathsea/cnf.c</span></samp>. @@ -2691,13 +2697,11 @@ expands to ‘<samp><span class="samp">xA1y:xB1y:xA2y:xB2y</span></samp>&rsq assigning a brace list to <code>$TEXMF</code>, as mentioned in <samp><span class="file">texmf.in</span></samp>. - <p>You can also use the path separator in stead of the comma. The last + <p>You can also use the path separator instead of the comma. The last example could have been written ‘<samp><span class="samp">x{A:B}{1:2}y</span></samp>’. <p><a name="index-expand_002ec-504"></a>Brace expansion is implemented in the source file -<samp><span class="file">kpathsea/expand.c</span></samp>. It is a modification of the Bash sources, and -is thus covered by the GNU General Public License, rather than the -Library General Public License that covers the rest of Kpathsea. +<samp><span class="file">kpathsea/expand.c</span></samp>. <div class="node"> <a name="KPSE_DOT-expansion"></a> @@ -3094,7 +3098,7 @@ space to specify the format, to simplify quoting of calls from shells. vf: .vf dvips config (dvipsconfig): ist: .ist - truetype fonts: .ttf .ttc .TTF .TTC + truetype fonts: .ttf .ttc .TTF .TTC .dfont type42 fonts: .t42 .T42 web2c files (web2c): other text files (othertext): @@ -3582,8 +3586,8 @@ dynamic creation program: <code>mktextfm</code>. <br><dt>‘<samp><span class="samp">Troff fonts</span></samp>’<dd><a name="index-TRFONTS-695"></a>(Troff fonts, used by DMP; see <a href="web2c.html#DMP-invocation">DMP invocation</a>) <code>TRFONTS</code>. - <br><dt>‘<samp><span class="samp">truetype fonts</span></samp>’<dd><a name="index-g_t_002ettf-696"></a><a name="index-g_t_002ettc-697"></a><a name="index-TTFONTS-698"></a>(TrueType outline fonts) <code>TTFONTS</code>; suffixes ‘<samp><span class="samp">.ttf</span></samp>’, -‘<samp><span class="samp">.ttc</span></samp>’. + <br><dt>‘<samp><span class="samp">truetype fonts</span></samp>’<dd><a name="index-g_t_002ettf-696"></a><a name="index-g_t_002ettc-697"></a><a name="index-TTFONTS-698"></a>(TrueType outline fonts) <code>TTFONTS</code>; suffixes ‘<samp><span class="samp">.ttf</span></samp>’ and +‘<samp><span class="samp">.TTF</span></samp>’, ‘<samp><span class="samp">.ttc</span></samp>’ and ‘<samp><span class="samp">.TTC</span></samp>’, ‘<samp><span class="samp">.dfont</span></samp>’. <br><dt>‘<samp><span class="samp">type1 fonts</span></samp>’<dd><a name="index-g_t_002epfa-699"></a><a name="index-g_t_002epfb-700"></a><a name="index-T1FONTS-701"></a><a name="index-T1INPUTS-702"></a><a name="index-TEXPSHEADERS-703"></a><a name="index-DVIPSHEADERS-704"></a>(Type 1 PostScript outline fonts, see <a href="dvips.html#Glyph-files">Glyph files</a>) <code>T1FONTS</code>, <code>T1INPUTS</code>, <code>TEXPSHEADERS</code>, <code>DVIPSHEADERS</code>; diff --git a/Master/texmf/doc/kpathsea/kpathsea.pdf b/Master/texmf/doc/kpathsea/kpathsea.pdf Binary files differindex fd41680f38a..89bde9989c1 100644 --- a/Master/texmf/doc/kpathsea/kpathsea.pdf +++ b/Master/texmf/doc/kpathsea/kpathsea.pdf |