/usr/share/doc/mhonarc/resources/otherindexes.html is in mhonarc 2.6.19-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 | <html>
<head>
<title>MHonArc Resources: OTHERINDEXES</title>
<link rel="stylesheet" type="text/css" href="../docstyles.css">
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev: <a href="notetext.html">NOTETEXT</a>]</td><td><nobr>[<a href="../resources.html#otherindexes">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="outdir.html">OUTDIR</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>OTHERINDEXES</h1>
<!--X-TOC-Start-->
<ul>
<li><a href="#syntax">Syntax</a>
<li><a href="#description">Description</a>
<li><a href="#default">Default Setting</a>
<li><a href="#rcvars">Resource Variables</a>
<li><a href="#examples">Examples</a>
<li><a href="#version">Version</a>
<li><a href="#seealso">See Also</a>
</ul>
<!--X-TOC-End-->
<!-- *************************************************************** -->
<hr>
<h2><a name="syntax">Syntax</a></h2>
<dl>
<dt><strong>Envariable</strong></dt>
<dd><p>
<code>M2H_OTHERINDEXES=</code><var>rcfile1</var><code>:</code><var
>rcfile2</var><code>:</code><var>...</var><code>:</code><var
>rcfileN</var>
</p>
</dd>
<dt><strong>Element</strong></dt>
<dd><p>
<code><OTHERINDEXES><br></code>
<var>rcfile1</var><code>:</code><var>rcfile2</var><code>:</code><var
>...</var><br>
<var>rcfilei</var><code>:</code><var>...</var><code>:</code><var
>rcfileN</var><br>
<code></OTHERINDEXES><br></code>
</p>
</dd>
<dt><strong>Command-line Option</strong></dt>
<dd><p>
<code>-otherindexes </code><var>rcfile1</var><code>:</code><var
>rcfile2</var><code>:</code><var>...</var><code>:</code><var
>rcfileN</var>
</p>
</dd>
</dl>
<!-- *************************************************************** -->
<hr>
<h2><a name="description">Description</a></h2>
<p>OTHERINDEXES defines a list of resource files that
define other index pages
to generate when creating, or updating, an archive. When setting
the OTHERINDEXES resource, the filenames are separated by colons
(or semicolons under MSDOS/Windows). Line-breaks can be used
to separate filenames if setting OTHERINDEXES via the
<code>OTHERINDEXES</code> element.
</p>
<table border=0 cellpadding=4>
<tr valign=top>
<td><strong>CAUTION</strong></td>
<td><P>It is very important that each resource file specified
defines the
<a href="main.html">MAIN</a> or
<a href="thread.html">THREAD</a> resource to determine the
type of index to create. Also, the
<A HREF="idxfname.html">IDXFNAME</A> or
<A HREF="tidxfname.html">TIDXFNAME</A> resource
(and <A HREF="idxprefix.html">IDXPREFIX</a> or
<A HREF="tidxprefix.html">TIDXPREFIX</a> resource if
<A HREF="multipg.html">MULTIPG</a> is active)
must be defined
to prevent overwriting of the default index pages.
</P>
</td>
</tr>
</table>
<table border=0 cellpadding=4>
<tr valign=top>
<td><strong><font color=red>WARNING</font></strong></td>
<td><p>Make sure OTHERINDEXES does <strong>NOT</strong>
list the file OTHERINDEXES
is defined in. This will cause an infinite loop.
</td>
</tr>
</table>
<table border=0 cellpadding=4>
<tr valign=top>
<td><strong><font color=red>WARNING</font></strong></td>
<td><p>OTHERINDEXES resource file should <strong>NOT</strong>
define the OTHERINDEXES resource. Unpredictable results may
occur, possibly infinite recursion.
</td>
</tr>
</table>
<P>MHonArc will only store the name of the resource files
listed in the database. Therefore, for any subsequent updates of the
archive, the extra index resource files must exist inorder to generate
the extra index pages. </P>
<p>All filenames are treated relative to the current working
directory or the archive directory, except for absolute
pathnames. The following shows the search order MHonArc uses
to find resource files listed in OTHERINDEXES:
</p>
<ol>
<li>Current working directory.</li>
<li>Same directory that the first resource file was read as
specified by the RCFILE resource.</li>
<li>User's home directory.</li>
<li>Archive directory.</li>
<li>Perl's <tt><!--
-->@<!--
-->INC</tt> library search page.</li>
</ol>
<table border=0 cellpadding=4>
<tr valign=top>
<td><strong>NOTE</strong></td>
<td><P>When creating resource files for extra indexes, make sure to
explicitly set all resources desired since some resource settings may
no longer be set to the defaults due to database settings or from
a previously read resource file. Ie. MHonArc does not reset
to the default settings before reading the other resource files. </P>
</td>
</tr>
</table>
<table border=0 cellpadding=4>
<tr valign=top>
<td><strong>NOTE</strong></td>
<td><P>Archive navigational resources, like
<a href="listbegin.html">LISTBEGIN</a>,
<a href="thead.html">THEAD</a>,
<a href="toplinks.html">TOPLINKS</a>, and
<a href="botlinks.html">BOTLINKS</a>,
are <strong>NOT</strong> automatically modified to include
navigational links related to the other indexes created (even
if using the default settings). Therefore, you will have
to explicily define these resources if you want navigational
links for the other indexes.
</td>
</tr>
</table>
<!-- *************************************************************** -->
<hr>
<h2><a name="default">Default Setting</a></h2>
<p>Nil
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="rcvars">Resource Variables</a></h2>
<p>N/A
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="examples">Examples</a></h2>
<p>Since MHonArc only creates two indexes by default
(the main/date index and the thread index), you can use OTHERINDEXES
to define other index formats for navigating your archive. A
possible setting for OTHERINDEXES may look like this:
</p>
<pre>
<b><OtherIndexes></b>
reversedateidx.mrc
subjectidx.mrc
<b></OtherIndexes></b>
</pre>
<!-- *************************************************************** -->
<hr>
<h2><a name="version">Version</a></h2>
<p>1.2
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="seealso">See Also</a></h2>
<p>
<A HREF="idxfname.html">IDXFNAME</A>,
<A HREF="idxprefix.html">IDXPREFIX</a>,
<A HREF="multipg.html">MULTIPG</a>,
<A HREF="tidxfname.html">TIDXFNAME</A>,
<A HREF="tidxprefix.html">TIDXPREFIX</a>,
<a href="main.html">MAIN</a>,
<a href="thread.html">THREAD</a>
</p>
<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev: <a href="notetext.html">NOTETEXT</a>]</td><td><nobr>[<a href="../resources.html#otherindexes">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="outdir.html">OUTDIR</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2003/10/06 22:04:19 $ <br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
Copyright © 1997-2001, <a href="http://www.earlhood.com/">Earl Hood</a>, <a href="mailto:mhonarc%40mhonarc.org">mhonarc<!--
-->@<!--
-->mhonarc.org</a><br>
</address>
</body>
</html>
|