MHonArc v2.3 -- Resources

# Resources

All the behavior of MHonArc is controlled by resources. Resources may be set via environment variables (envariables for short), command-line options, and/or elements in a resource file. For information on the syntax of a MHonArc resource file, see the RCFILE resource.

## Resource Types

There are four basic types of resources:

boolean

  Boolean resources are resources that are either on or off; active or deactive; or true or false. They basically work as flags for controlling MHonArc behavior.

string

  The resource represents a string value. How the string value is used depends on the resource.

list

  The resource is a list of values. How the list is used depends on the resource.

one-shot

  One-shot resources are resources that apply only to the current MHonArc process. You can tell if a resource is a one-shot by checking if the resource cannot be defined by a resource file element. One-shot resources are set only by command-line options or envariables.

A resource's type can be determined by reading the description for the resource.

All resources, except one-shots, are stored with the archive in a simple database. Therefore, after the first time you run MHonArc on an archive, you do not need to respecify the resources. MHonArc will remember your settings so subsequent archive updates are faster to execute.

## Resource Index

Each resource is described on its own page. Each resource page uses the following template:

> Syntax

>   Brief synopsis on how the resource can be defined. Command-line options take precedence over resource file elements. Resource file elements take precedence over environment variables ("envariables" for short). See RCFILE for more information on how resources are defined in a resource file. See your system's documentation on how to define envariables.

> Description

>   Description of the resource.

> Default Setting

>   The default value of the resource, if applicable.

> Resource Variables

>   Applicable resource variables that can be used for the resource.

> Examples

>   Example uses of the resource.

> Version

>   The version of MHonArc the resource became available. Note, the actual description of the resource may not be applicable for the version number listed. I.e. The behavior of the resource may have changed in later releases. Therefore, the description of the resource may be applicable for a later version of MHonArc than from the version of MHonArc the resource first came available.

> See Also

>   Links to any related resources.

### Resource list

Resource Name | Description
ADD | Add messages to the archive.
AFS | Skip archive directory permission check.
ANNOTATE | Add/set annotation for message(s).
ARCHIVE | Create archive.
AUTHORBEGIN | Markup at the start of a author group.
AUTHOREND | Markup at the end of a author group.
AUTHSORT | Sort main index by author.
BOTLINKS | Links markup at the bottom of message pages.
CHARSETCONVERTERS | Charater set filter functions.
CONLEN | Use Content-Length value.
DATEFIELDS | List of fields to extract date of message.
DAYBEGIN | Markup at the start of a day group.
DAYEND | Markup at the end of a day group.
DBFILE | Name of archive database file.
DECODEHEADS | Store "decode-only" characters sets in raw form.
DEFINEDERIVED | Define extra file(s) to generate for each message page.
DEFINEVAR | Define a custom resource variable.
DEFRCFILE | Pathname of default resource file.
DEFRCNAME | Name of default resource file.
DOC | Add link to documentation.
DOCURL | URL to documentation
EDITIDX | Modify archive with new resource settings.
EXCS | List of header fields to exclude.
EXPIREAGE | Length of time to keep a message in an archive.
EXPIREDATE | Expiration of date of message.
FIELDORDER | Order to display message header fields.
FIELDSBEG | Beginning markup of message header.
FIELDSEND | Ending markup of message header.
FIELDSTYLES | Define HTML elements that wrap field text of message headers.
FLDBEG | Markup before field text.
FLDEND | Markup after field text.
FOLREFS | Print links links to explicit follow-ups and references.
FOLUPBEGIN | Beginning markup of follow-up links in message pages.
FOLUPEND | Ending markup of follow-up links in message pages.
FOLUPLITXT | Markup for a follow-up link.
FOOTER | File to include at the foot of main index pages.
FORCE | Force archive operation even if lock cannot be obtained.
FROMFIELDS | List of fields to extract author of a message.
GENIDX | Generate a message index to standard output.
GMTDATEFMT | Conversion specification for GMT dates.
GZIPEXE | Pathname to gzip executable.
GZIPFILES | Gzip files.
GZIPLINKS | Assume files are gzipped when creating links.
HEADBODYSEP | Markup separating the message head from the body.
HEADER | File to include at the top of main index pages.
HTMLEXT | Extension to use for HTML files.
ICONS | Content-type to icon mapping.
IDXFNAME | Filename for main (first) index page.
IDXLABEL | Label for main index.
IDXPGBEGIN | Beginning markup for main index pages.
IDXPGEND | Ending markup for main index pages.
IDXPREFIX | Filename prefix for multi-page main index.
IDXSIZE | Size of each index page.
INCLUDE | Include a resource file.
LABELBEG | Beginning markup of the label text of a message field.
LABELEND | End markup of the label text of a message field.
LABELSTYLES | Define HTML elements to wrap message header field labels.
LISTBEGIN | Markup to begin main index message listing.
LISTEND | Markup to end main index message listing.
LITEMPLATE | Markup for an entry in the main index message list.
LOCALDATEFMT | Conversion specification for printing local date.
LOCK | Perform a lock on the archive.
LOCKDELAY | Wait time between lock attempts.
LOCKFILE | Name of the lock file.
LOCKTRIES | Total number of time to attempt a lock before failing.
MAILTO | Convert email addresses in message headers to hyperlinks.
MAILTOURL | URL template to use when MAILTO is set.
MAIN | Create main index.
MAXSIZE | Maximum number of messages in an archive.
MHPATTERN | Regex for matching message files in an MH folder (directory).
MIMEARGS | Arguments to MIME filters.
MIMEFILTERS | Mapping of MIME filters to content-types.
MODTIME | Set modification time on message files to message dates.
MONTHS | Month names.
MONTHSABR | Abbreviated month names.
MSGBODYEND | Markup after the message body.
MSGFOOT | Markup at the foot of each message page.
MSGGMTDATEFMT | GMT conversion specification for message dates.
MSGHEAD | Markup at the head of each message page.
MSGIDLINK | Hyperlink markup for embedded message-ids in message pages.
MSGLOCALDATEFMT | Local conversion specification for message dates.
MSGPGBEGIN | Starting markup for each message page.
MSGPGEND | Ending markup for each message page.
MSGPGS | Print message pages.
MSGPREFIX | Prefix for message page filenames.
MSGSEP | Regex for matching message separator in mailbox files.
MULTIPG | Create multi-page indexes.
NEWS | Hyperlink newsgroups in message headers.
NEXTBUTTON | Button markup for next message by main index.
NEXTBUTTONIA | Inactive button markup for next message by main index.
NEXTLINK | Link markup for next message by main index.
NEXTLINKIA | Inactive link markup for next message by main index.
NEXTPGLINK | Link markup for next page of main index.
NEXTPGLINKIA | Inactive link markup for next page of main index.
NOTE | Markup for representing the annotation of a message.
NOTEDIR | Directory to store annotations.
NOTEIA | Markup when no annotation is available for a message.
NOTETEXT | Annotation text.
OTHERINDEXES | List of alternate indexes to create for an archive.
OUTDIR | Location of archive.
PERLINC | Additional Perl include paths.
PREVBUTTON | Button markup for previous message by main index.
PREVBUTTONIA | Inactive button markup for previous message by main index.
PREVLINK | Link markup for previous message by main index.
PREVLINKIA | Inactive link markup for previous message by main index.
PREVPGLINK | Link markup for previous page of main index.
PREVPGLINKIA | Inactive link markup for previous page of main index.
QUIET | Do not output status.
RCFILE | Resource file to read before processing input.
REFSBEGIN | Beginning markup for explicit reference links in message pages.
REFSEND | Ending markup for explicit reference links in message pages.
REFSLITXT | Markup representing a reference entry in explicit reference links.
REVERSE | Reverse the listing order in the main index.
RMM | Remove specified messages from an archive.
SCAN | List archive messages to standard output.
SINGLE | Process a single message.
SORT | List messages by date in main index.
SUBJECTARTICLERXP | Regex for matching leading articles in message subjects.
SUBJECTBEGIN | Beginning markup for a subject group in the main index.
SUBJECTEND | Ending markup for a subject group in the main index.
SUBJECTHEADER | Main subject line markup above message header.
SUBJECTREPLYRXP | Regex for matching subject text denoting a reply message.
SUBJECTSTRIPCODE | Perl expressions to strip subject text while reading messages.
SUBSORT | List messages by subjext in main index.
TCONTBEGIN | Markup before the continuation of a broken thread.
TCONTEND | Markup after the continuation of a broken thread.
TFOOT | Footer markup for thread index page.
THEAD | Header markup for thread index page.
THREAD | Create thread index.
TIDXFNAME | Filename of first thread index page.
TIDXLABEL | Label string for the thread index.
TIDXPGBEGIN | Beginning markup for the thread index pages.
TIDXPGEND | Ending markup for the thread index pages.
TIDXPREFIX | Filename prefix for thread index pages beyond the first page.
TIMEZONES | Hour offsets for timezones.
TINDENTBEGIN | Markup for opening a level when continuing a broken thread.
TINDENTEND | Markup for closing a level when continuing a broken thread.
TITLE | Title for main index.
TLEVELS | Maximum number of levels to indent in thread index.
TLIEND | Ending markup for a thread index message listing.
TLINONE | Markup for a missing message in thread index.
TLINONEEND | Ending markup for a missing message in thread index.
TLITXT | Markup for a thread index message listing.
TNEXTBUTTON | Button markup for next message by thread.
TNEXTBUTTONIA | Inactive button markup for next message by thread.
TNEXTLINK | Link markup for next message by thread.
TNEXTLINKIA | Inactive link markup for next message by thread.
TNEXTPGLINK | Link markup for next page in thread index.
TNEXTPGLINKIA | Inactive link markup for next page in thread index.
TOPLINKS | Markup for top navigational links of a message page.
TPREVBUTTON | Button markup for previous message by thread.
TPREVBUTTONIA | Inactive button markup for previous message by thread.
TPREVLINK | Link markup for previous message by thread.
TPREVLINKIA | Inactive link markup for previous message by thread.
TPREVPGLINK | Link markup for previous page in thread index.
TPREVPGLINKIA | Inactive link markup for previous page in thread index.
TREVERSE | List thread in reverse order.
TSINGLETXT | Markup for a thread listing with no follow-ups.
TSLICE | Size of thread listing slice for message pages.
TSLICEBEG | Markup for the start of a thread slice.
TSLICEEND | Markup for the end of a thread slice.
TSORT | List threads by date.
TSUBJECTBEG | Markup before a subject based thread listing.
TSUBJECTEND | Markup after a subject based thread listing.
TSUBLISTBEG | Markup for starting a sub-thread.
TSUBLISTEND | Markup for ending a sub-thread.
TSUBSORT | List threads by subject.
TTITLE | Title of thread index.
TTOPBEGIN | Markup for the root/start of a thread.
TTOPEND | Markup for the end of a thread.
UMASK | Umask value for the MHonArc process.
USELOCALTIME | Use local time to determine day groups in main index listing.
USINGLASTPG | $LASTPG$ is used in resource values.
WEEKDAYS | Weekday names.
WEEKDAYSABR | Abbreviated weekday names.