MHonArc Resources: ADD

MHonArc Resource List | TOC

# ADD

## Syntax

Envariable

  N/A

Element

  N/A

Command-line Option

  `-add` folder1 ...
  `-add <` single-message

## Description

The ADD resource instructs MHonArc to add messages to an existing archive. The archive specified does not exist, MHonArc will automatically create the archive. If input is coming from standard in, then the input is treated as a single message to add to the archive.

CAUTION | If ADD is specified, and no archive currently exists, make sure there is no `maillist.html` file (or the filename specified by IDXFNAME resource) in the destination directory. This can may cause the main index to be incorrect. If this happens, remove `maillist.html` and use EDITIDX to regenerate archive pages.

When adding, MHonArc will skip any messages that already exists in the archive. This allows one to have MHonArc rescan a mail folder only add any new messages found.

NOTE | MHonArc determines duplicate messages by message-ids.

## Default Setting

Off

## Resource Variables

N/A

## Examples

The following example shows adding a mail folder:

        % mhonarc -outdir /home/ehood/mailarch -add inbox

The following shows how a single message can be added. The message comes from the output of the MH show program:

        % show -noshow -noheader | mhonarc -add

## Version

1.0

## See Also

OUTDIR