blob: 002cf444c437dd1f46ce0f8bf0f1236e5927d31c (
plain)
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
51
52
53
|
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->
<html xmlns="http://www.w3.org/1999/xhtml"
>
<head><title>bookkeeping file</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)" />
<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)" />
<!-- xhtml,th4,index -->
<meta name="src" content="mn.tex" />
<link rel="stylesheet" type="text/css" href="mn.css" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
</head><body
>
<a
href="mn34.html#mn35.html" >exit</a> <h3 class="SubSectionHead"><a
name="QQ1-35-74"></a>Placement of the Bookkeeping File</h3>
<a
name="index35-74001"></a> <a
name="index35-74002"></a> <a
name="index35-74003"></a> <a
name="index35-74004"></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’t find the address there, the program embarks on a search throughout the physical
directories of its platform.
<!--l. 8190--><p class="indent" > The program places the bookkeeping file at the first applicable location of the following list.
</p><!--l. 8193--><p class="indent" >
</p><ol type="1" >
<li>The pointer specified by an optional ‘<span class="cmtt-10">-l</span>’ 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 ‘<span class="cmtt-10">l</span>’ record provided in the environment file. </li>
<li>A file named <span class="cmtt-10">tex4ht.fls </span>in the work directory. </li></ol>
<!--l. 8209--><p class="indent" > A given address may start with the character ‘<span class="cmtt-10">~</span>’ or the character pair ‘<span class="cmtt-10">~~</span>’. The single character ‘<span class="cmtt-10">~</span>’ 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 ‘<span class="cmtt-10">~~</span>’ 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
‘<span class="cmtt-10">~</span>’.
</p><!--l. 8220--><p class="indent" > The bookkeeping file must have writable access mode, and the directory which contains the file should have a
compatible access mode. On multi-user platforms, it is recommended not to share the bookkeeping file, but to ask
for such files in the users’ directories.
</p><!--l. 8226--><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>
<hr />
<!--l. 8230--><p class="indent" > <small>Generated August 24, 2020 - <a href="/tex4ht/">tex4ht home page</a></small></p>
</body></html>
|
