File: mn42.html

package info (click to toggle)
tex4ht 20011214-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 8,272 kB
  • ctags: 992
  • sloc: xml: 17,548; ansic: 9,389; makefile: 129; sh: 43; sed: 8
file content (50 lines) | stat: -rw-r--r-- 3,312 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
<?xml version="1.0"?> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">  
<html xmlns="http://www.w3.org/TR/xhtml1/transitional"  
> 
<head><title>bookkeeping file</title> 
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> 
<meta name="generator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)" /> 
<!--xhtml,th4,index--> 
<meta name="src" content="mn.tex" /> 
<meta name="date" content="2001-02-28 17:02:00" /> 
<link rel="stylesheet" type="text/css" href="mn.css" /> 
</head><body 
>
    <a 
 href="mn41.html#mn42.html" >exit</a>
    <h3 class="SubSectionHead"><a 
   name="QQ1-42-36"></a>Placement of the Bookkeeping File</h3>
<!--l. 5947--><p class="noindent"><a 
   name="index42-36001"></a> <a 
   name="index42-36002"></a> <a 
   name="index42-36003"></a> <a 
   name="index42-36004"></a><a 
   name="TEX4HTWR"></a>To cut down on the time invested to locate files, the <span class="cmtt-10">tex4ht.c </span>program maintains a bookkeeping file where it
records the addresses of the files it finds. Whenever the program needs to locate a file, it first searches the address in
the bookkeeping file. If it doesn&#8217;t find the address there, the program embarks on a search throughout the physical
directories of its platform.
</p><!--l. 5959--><p class="indent">    The program places the bookkeeping file at the first applicable location of the following list.
</p><!--l. 5962--><p class="indent">
</p><ol type="1" >
<li>The pointer specified by an optional &#8216;<span class="cmtt-10">-l</span>&#8217; switch provided to the invocation of the <span class="cmtt-10">tex4ht </span>program.
</li>
<li>A file named <span class="cmtt-10">tex4ht.fls </span>in the directory specified by an optional environment variable named <span class="cmtt-10">TEX4HTWR</span>.
</li>
<li>The location specified by an optional &#8216;<span class="cmtt-10">l</span>&#8217; record provided in the environment file. </li>
<li>A file named <span class="cmtt-10">tex4ht.fls </span>in the work directory. </li></ol>
    A given address may start with the character &#8216;<span class="cmtt-10">~</span>&#8217; or the character pair &#8216;<span class="cmtt-10">~~</span>&#8217;. The single character &#8216;<span class="cmtt-10">~</span>&#8217; is
interpreted to be the directory address of the root, provided in an environment variable named <span class="cmtt-10">HOME</span>. The
character pair &#8216;<span class="cmtt-10">~~</span>&#8217; is interpreted to be a directory address provided in an environment variable named
<span class="cmtt-10">TEX4HTWR</span>. The address stored in the latter environment variable may also start with a single character
&#8216;<span class="cmtt-10">~</span>&#8217;.
<!--l. 5989--><p class="indent">    The bookkeeping file must have writable access mode, and the directory which contains the file should have a
compatible access mode.
</p><!--l. 5993--><p class="indent">    The bookkeeping file is a dynamically constructed variant of the ls-R file of kpathsea. TeX4ht
ignores its own bookkeeping mechanism, if the program <span class="cmtt-10">tex4ht.c </span>is compiled with a raised <span class="cmtt-10">-DKPATHSEA</span>
switch.

</p>
     
</body></html>