← Back to branch summary

~ubuntu-branches/debian/sid/tex4ht/sid

« back to all changes in this revision

Viewing changes to doc/mn42.html

  • Committer: Bazaar Package Importer
  • Author(s): Kapil Hari Paranjape
  • Date: 2005-04-05 14:14:41 UTC
  • mfrom: (1.2.1 upstream) (2.1.2 hoary)
  • Revision ID: james.westby@ubuntu.com-20050405141441-x4dojdgz3frkfyet
Tags: 20050402.1817-1
http://bugs.debian.org/299934
http://bugs.debian.org/295109
http://bugs.debian.org/219348
http://bugs.debian.org/219347
* New upstream release (2005-04-02-18:17). Closes: #299934.
* See README.src, README.validate, README.Debian and copyright
  for information on minor changes.
* This upload fixes a some .htf files. Closes: #295109.
* Updated the description to reflect recent changes.
* Fixed some typos in src/tex4ht-mkht.tex and consequently
  in the mk4ht script.
* Updated the man page to include mk4ht. 
* Updated the description of options for the scripts in the man page.
  Put more information in the man page about the way the system works.
  Closes: #219348, #219347.
* Added debian/watch file.

Show diffs side-by-side

added added

removed removed

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