<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: 2002/12/10 04:08:03 $ <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@mhonarc.org">mhonarc@mhonarc.org</a><br> </address> </body> </html>