summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/kpathsea
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-06-22 15:12:10 +0000
committerKarl Berry <karl@freefriends.org>2011-06-22 15:12:10 +0000
commit3d484dbd59d1501386da5ec4eb44b9b6f39132e9 (patch)
tree38b40a7f82707fa6753e81d48a64f764da6f0aa7 /Master/texmf/doc/kpathsea
parente9926fd469aff4508bb8cacdfa41eb2186e40ef8 (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.html64
-rw-r--r--Master/texmf/doc/kpathsea/kpathsea.pdfbin445618 -> 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:&nbsp;<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:&nbsp;<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>&lsquo;<samp><span class="samp">--dpi </span><var>num</var></samp>&rsquo;<dd>Sets the resolution of the generated font to <var>num</var>.
<br><dt>&lsquo;<samp><span class="samp">--mfmode </span><var>name</var></samp>&rsquo;<dd>Sets the Metafont mode to <var>name</var>.
-<br><dt>&lsquo;<samp><span class="samp">--bdpi </span><var>num</var></samp>&rsquo;<dd>Sets the the &ldquo;base dpi&rdquo; for the font. This must match the mode being
+<br><dt>&lsquo;<samp><span class="samp">--bdpi </span><var>num</var></samp>&rsquo;<dd>Sets the &ldquo;base dpi&rdquo; for the font. This must match the mode being
used.
<br><dt>&lsquo;<samp><span class="samp">--mag </span><var>string</var></samp>&rsquo;<dd>A &ldquo;magstep&rdquo; 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 &lsquo;<samp><span class="samp">%</span></samp>&rsquo; and continue to the end of the line.
+<li><a name="index-comments_002c-in-_0040file_007btexmf_002ecnf_007d-461"></a>Comments start with &lsquo;<samp><span class="samp">%</span></samp>&rsquo;, 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 &lsquo;<samp><span class="samp">%</span></samp>&rsquo; in the &ldquo;middle&rdquo; 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 &lsquo;<samp><span class="samp">\</span></samp>&rsquo; at the end of a line acts as a continuation character, i.e.,
@@ -2458,18 +2464,18 @@ lines is not ignored.
<li>If &lsquo;<samp><span class="samp">.</span><var>progname</var></samp>&rsquo; 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 &lsquo;<samp><span class="samp">%</span></samp>&rsquo; and &lsquo;<samp><span class="samp">@</span></samp>&rsquo;.
-(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 &lsquo;<samp><span class="samp">$</span><var>var</var><span class="samp">.</span><var>prog</var></samp>&rsquo;
-feature is not available on the right-hand side; instead, you must use
-an additional variable (see below for example). A &lsquo;<samp><span class="samp">;</span></samp>&rsquo; in
-<var>value</var> is translated to &lsquo;<samp><span class="samp">:</span></samp>&rsquo; 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
+&lsquo;<samp><span class="samp">$</span><var>var</var><span class="samp">.</span><var>prog</var></samp>&rsquo; feature is not available on the
+right-hand side; instead, you must use an additional variable (see
+below for example). A &lsquo;<samp><span class="samp">;</span></samp>&rsquo; in <var>value</var> is translated to
+&lsquo;<samp><span class="samp">:</span></samp>&rsquo; 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&mdash;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&mdash;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 &lsquo;<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 &lsquo;<samp><span class="samp">x{A:B}{1:2}y</span></samp>&rsquo;.
<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>&lsquo;<samp><span class="samp">Troff fonts</span></samp>&rsquo;<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>&lsquo;<samp><span class="samp">truetype fonts</span></samp>&rsquo;<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 &lsquo;<samp><span class="samp">.ttf</span></samp>&rsquo;,
-&lsquo;<samp><span class="samp">.ttc</span></samp>&rsquo;.
+ <br><dt>&lsquo;<samp><span class="samp">truetype fonts</span></samp>&rsquo;<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 &lsquo;<samp><span class="samp">.ttf</span></samp>&rsquo; and
+&lsquo;<samp><span class="samp">.TTF</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.ttc</span></samp>&rsquo; and &lsquo;<samp><span class="samp">.TTC</span></samp>&rsquo;, &lsquo;<samp><span class="samp">.dfont</span></samp>&rsquo;.
<br><dt>&lsquo;<samp><span class="samp">type1 fonts</span></samp>&rsquo;<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
index fd41680f38a..89bde9989c1 100644
--- a/Master/texmf/doc/kpathsea/kpathsea.pdf
+++ b/Master/texmf/doc/kpathsea/kpathsea.pdf
Binary files differ