summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/tex4ht/mn37.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn37.html')
-rw-r--r--Master/texmf-dist/doc/generic/tex4ht/mn37.html121
1 files changed, 60 insertions, 61 deletions
diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn37.html b/Master/texmf-dist/doc/generic/tex4ht/mn37.html
index f32d5d31b92..4ba0896af8f 100644
--- a/Master/texmf-dist/doc/generic/tex4ht/mn37.html
+++ b/Master/texmf-dist/doc/generic/tex4ht/mn37.html
@@ -1,79 +1,78 @@
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "xhtml1-transitional.dtd">
+ "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>driver</title>
+<head><title>Compile</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)" />
-<meta name="originator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)" />
+<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" />
-<meta name="date" content="2004-02-11 18:07:00" />
<link rel="stylesheet" type="text/css" href="mn.css" />
</head><body
>
<a
- href="mn-port.html#mn37.html" >exit driver</a>
+ href="mn31.html#mn37.html" >exit Compile</a> <a
+ name="doc-c"></a>
<h3 class="SubSectionHead"><a
- name="QQ1-37-47"></a>Driving the Translation of Pictures and Other Tasks</h3>
- <a
- name="index37-47001"></a> <a
- name="index37-47002"></a> <a
- name="index37-47003"></a>TeX4ht outputs a script file (&#8216;<span class="cmtt-10">.lg</span>&#8217;) describing how the dvi file (extension &#8216;<span class="cmtt-10">.idv</span>&#8217;) of pictures should
-be processed, the CSS instructions to be included for the file, and user-initiated requests from the
-operating system. In the default setting, the script file holds abstract commands similar to the following
-ones.
-<dl > <dt><span class="cmtt-10">--- needs --- source.idv[i] ==&gt; target.gif ---</span></dt><dd>
-<!--l. 5916--><p class="indent"> An abstract command of this form requests that the i&#8217;th page in the dvi file will be translated into a target file
-whose name is provided.
-</p>
- </dd><dt><span class="cmtt-10">--- characters --- </span></dt><dd>
-<!--l. 5924--><p class="indent"> This abstract command is a identifies where the requests for pictorial characters start.
+ name="QQ1-37-76"></a>Compiling tex4ht.c</h3>
+<ul type="disc" >
+<li> <a
+ name="index37-76001"></a>You might want to activate some of the options at the start of the file by uncommenting the corresponding
+lines.
+<div class="Verbatim"><span class="cmtt-10">/*</span><span class="cmtt-10">&#x00A0;**********************************************</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;Compiler</span><span class="cmtt-10">&#x00A0;options</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;*</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;(uncommented</span><span class="cmtt-10">&#x00A0;|</span><span class="cmtt-10">&#x00A0;command</span><span class="cmtt-10">&#x00A0;line)</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;*</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">------------------------------------------------*</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;Classic</span><span class="cmtt-10">&#x00A0;C</span><span class="cmtt-10">&#x00A0;(CC)</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;default</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;ANSI</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;ansi-c,</span><span class="cmtt-10">&#x00A0;c++</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;DOS_C</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;HAVE_STRING_H</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;&#x003C;string.h&#x003E;</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;HAVE_DIRENT_H</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;&#x003C;dirent.h&#x003E;</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;HAVE_SYS_NDIR_H</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;&#x003C;sys/ndir.h&#x003E;</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;HAVE_SYS_DIR_H</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;&#x003C;sys/dir.h&#x003E;</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;HAVE_NDIR_H</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;&#x003C;dir.h&#x003E;</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;WIN32</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;KPATHSEA</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">#define</span><span class="cmtt-10">&#x00A0;BCC32</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;</span><span class="cmtt-10">&#x00A0;bordland</span><span class="cmtt-10">&#x00A0;c++</span><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">&#x00A0;</span>
+<br /><span class="cmtt-10">*************************************************</span><span class="cmtt-10">&#x00A0;</span>
+<br /></div>
+<!--l. 8502--><p class="noindent" ></p></li>
+<li> <a
+ name="index37-76002"></a> <a
+ name="index37-76003"></a> <a
+ name="index37-76004"></a> <a
+ name="index37-76005"></a> <a
+ name="index37-76006"></a> <a
+ name="index37-76007"></a> <a
+ name="index37-76008"></a>Values may be assigned in the command line or the beginning of the source file, to the environment variables
+<a
+ href="mn32.html#ENVFILE" name="x-ENVFILE">ENVFILE</a>, <a
+ href="mn40.html#HTFDIR" name="x-HTFDIR">HTFDIR</a>, <a
+ href="mn38.html#LGPIC" name="x-LGPIC">LGPIC</a>, <a
+ href="mn38.html#LGSEP" name="x-LGSEP">LGSEP</a>, <a
+ href="mn34.html#LGTYP" name="x-LGTYP">LGTYP</a>, <a
+ href="mn36.html#MAXFONTS" name="x-MAXFONTS">MAXFONTS</a>, and <a
+ href="mn36.html#TFMDIR" name="x-TFMDIR">TFMDIR</a>.
+<!--l. 8524--><p class="indent" > For instance,
+</p><!--l. 8526--><p class="indent" > <span class="cmtt-10">gcc -o tex4ht tex4ht.c -DENVFILE=&#8217;"path/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"&#8217;</span>
+<span class="cmtt-10">-DHAVE_DIRENT_H</span>
</p>
- </dd></dl>
-<!--l. 5929--><p class="indent"> A manual brute-force execution of the abstract commands can be a tedious job for large number of pictures.
-The <span class="cmtt-10">t4ht </span>is in essence an interpreter for these abstract commands.
-</p><!--l. 5934--><p class="indent"> Another possible approach for automating the process is to request lg scripts in the form of shell scripts or
-batch files.
-</p><!--l. 5941--><p class="indent"> <big><span class="cmbx-10">Alternatives to &#8216;</span><span class="cmtt-10">--- needs --- source.idv[i] ==&gt; target.gif ---</span><span class="cmbx-10">&#8217;</span></big>
-</p><!--l. 5944--><p class="indent"> The default setting is made with a request of the form &#8216;<span class="cmtt-10">--- needs --- %%1.idv[%%2] ==&gt; %%3.gif ---</span>&#8217;,
-where the parameters <span class="cmtt-10">%%1</span>, <span class="cmtt-10">%%2</span>, and <span class="cmtt-10">%%3 </span>respectively represent the name of the source file without
-its extension, a page number, and a name of the target file. Alternative patterns to these abstract
-commands can be requested in the following locations, with the order reflecting on the priority given to the
-requests.
-</p><!--l. 5953--><p class="indent">
-</p><ul type="disc" >
-<li>In the <a
- href="mn38.html" >command line</a> of <span class="cmtt-10">tex4ht</span>, where the pattern should be prefixed with &#8216;<span class="cmtt-10">-s</span>&#8217;.
-<!--l. 5957--><p class="noindent"></p></li>
-<li>In the environment file <span class="cmtt-10">tex4ht.env </span>within a block of consecutive lines, where the lines should be identified with the
-character <a
- href="mn33.html#sc-1" name="sc">&#8216;<span class="cmtt-10">s</span>&#8217;</a>.
-<!--l. 5963--><p class="noindent"></p></li>
-<li>In <span class="cmtt-10">tex4ht </span>with the pattern provided through the variable <a
- href="mn36.html#x-LGPIC" name="LGPIC">LGPIC</a> of <span class="cmtt-10">tex4ht.c</span>.
- </li></ul>
- The character &#8216;<span class="cmtt-10">%</span>&#8217; can be introduced into a pattern through the entry &#8216;<span class="cmtt-10">%%%</span>&#8217;. On the other hand, the
-parameters &#8216;<span class="cmtt-10">%%1</span>&#8217;, &#8216;<span class="cmtt-10">%%2</span>&#8217;, and <span class="cmtt-10">%%3 </span>can specify, between the first two percentage characters (i.e., &#8216;<span class="cmtt-10">%...%1</span>&#8217;,
-&#8216;<span class="cmtt-10">%...%2</span>&#8217;, and &#8216;<span class="cmtt-10">%...%3</span>&#8217;), any format for the outcome that is compatible with the print formats of
-C.
-<!--l. 5977--><p class="indent"> <big><span class="cmbx-10">Alternatives to &#8216;</span><span class="cmtt-10">--- characters ---</span><span class="cmbx-10">&#8217;</span></big>
-</p><!--l. 5979--><p class="indent"> Substitutions for this abstract command can be requested in the following locations.
-</p><!--l. 5986--><p class="indent">
-</p><ul type="disc" >
-<li>In the <a
- href="mn38.html" name="mn38.html" >overview</a> of <span class="cmtt-10">tex4ht</span>, prefixed with &#8216;<span class="cmtt-10">-b</span>&#8217;.
-<!--l. 6157--><p class="noindent"></p></li>
-<li>In a line within the environment file &#8216;<span class="cmtt-10">tex4ht.file</span>&#8217;, where the line should be identified with the character
-&#8216;<a
- href="mn33.html#bsc-1" name="bsc">b</a>&#8217;.
-<!--l. 6163--><p class="noindent"></p></li>
-<li>In <span class="cmtt-10">tex4ht </span>with the substitution provided during compilation time through the variable <a
- href="mn36.html#x-LGSEP" name="LGSEP">LGSEP</a> of
-<span class="cmtt-10">tex4ht.c</span>.
</li></ul>
+<!--l. 8532--><p class="indent" > The switch &#8216;<span class="cmtt-10">-DENVFILE</span>&#8217; is optional, if the program can reach the environment file in an <a
+ href="mn32.html#envloc">alternative</a>
+manner.
+</p>
+ <h3 class="SubSectionHead"><a
+ name="QQ1-37-77"></a>Compiling t4ht.c</h3>
+ <a
+ name="index37-77001"></a>The environment variable <span class="cmtt-10">ENVFILE </span>is available also in &#8216;<span class="cmtt-10">t4ht.c</span>&#8217;.
+<!--l. 8542--><p class="indent" > For instance,
+</p><!--l. 8544--><p class="indent" > <span class="cmtt-10">gcc -o t4ht t4ht.c -DENVFILE=&#8217;"gold/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"&#8217;</span>
+</p>
</body></html>