diff --git a/ACKNOWLG b/ACKNOWLG index 59b2780..d173701 100644 --- a/ACKNOWLG +++ b/ACKNOWLG @@ -1,6 +1,6 @@ ACKNOWLEDGEMENTS for MHonArc - - http://www.oac.uci.edu/indiv/ehood/mhonarc.html +---------------------------- + I would like to thank everyone who has given feedback on MHonArc. Sorry for not listing everyone, but it has become too hard to keep @@ -51,4 +51,4 @@ the following: ISO-2022 encoded mail messages (ie. Japanese character set). --------------------------------------------------------------------------- -Earl Hood, earlhood@usa.net +Earl Hood, mhonarc@pobox.com diff --git a/BUGS b/BUGS index d785002..14411a5 100644 --- a/BUGS +++ b/BUGS @@ -1,7 +1,7 @@ Bug History for MHonArc ======================= - -@(#) BUGS 98/11/08 13:05:02 + +@(#) BUGS 01/06/10 18:10:37 Each bug listing has the following fields: @@ -16,6 +16,265 @@ Each bug listing has the following fields: Bug List ------------------------------------------------------------------------ +Version: 2.4.8, and earlier +Problem: Default CHARSETCONVERTERS values for latin[1-6] charsets + causing require error. +Solution: This was supposedly fixed in 2.4.8 in mhinit.pl, but + apparently was not. The def-mime.mrc file in the + example directory did have the correct mappings. +Version Fixed: 2.4.9 +------------------------------------------------------------------------ +Version: 2.4.8 +Problem: MHonArc aborts with Perl syntax errors if mhnull.pl + filter is loaded. +Solution: Dump typo errors that should have been caught before + release. Syntax errors fixed in mhnull.pl. +Version Fixed: 2.4.9 +------------------------------------------------------------------------ +Version: 2.4.7, and earlier +Problem: Message with HTML content can cause perl to crash. + Other symptom would be that a stale .mhonarc.lck + directory would exist preventing further archive + updates. +Solution: There appears to be a bug in perl's regex engine. + The fix was to change mhtxthtml.pl comment declaration + removal expression into a simplier one that just + munges (removes parts) to avoid crashes. +Version Fixed: 2.4.8 +------------------------------------------------------------------------ +Version: 2.4.7, and earlier +Problem: Prefixing second argument to $PGLINKLIST()$ with + a 'T' cause no thread page links to be rendered after + current thread index page. +Solution: Fixed in mhrcvars.pl: Make sure to strip 'T' from + both arguments before evaluating numeric values. +Version Fixed: 2.4.8 +------------------------------------------------------------------------ +Version: 2.4.7, and earlier +Problem: Default CHARSETCONVERTERS values for latin[1-6] charsets + causing require error. +Solution: Fixed in mhinit.pl (typo in library filename). +Version Fixed: 2.4.8 +------------------------------------------------------------------------ +Version: 2.4.6, and earlier +Problem: ADDRESSMODIFYCODE not stored in database. +Solution: Fixed in mhdb.pl (a dumb typo) +Version Fixed: 2.4.7 +------------------------------------------------------------------------ +Version: 2.4.6, and earlier +Problem: TPARENT message specifier for applicable resource + variables will cause a resource variable to expand + to the empty string if there is no parent message + to the current message. +Solution: If there is no parent message, TPARENT resolves to + to the current message. +Version Fixed: 2.4.7 +------------------------------------------------------------------------ +Version: 2.4.5, maybe earlier +Problem: Using message-ids with -rmm does not remove messages. +Solution: Fixed in mhrmm.pl +Version Fixed: 2.4.6 +------------------------------------------------------------------------ +Version: 2.4.5 +Problem: Japanese text messages not wrapped in PRE element. +Solution: Fixed in mhtxtplain.pl +Version Fixed: 2.4.6 +------------------------------------------------------------------------ +Version: 2.4.4 +Problem: $PGLINKLIST$ for threads did not work. +Solution: Fixed in mhrcvars.pl. +Version Fixed: 2.4.5 +------------------------------------------------------------------------ +Version: 2.4.4, and earlier +Problem: -afs had no effect. +Solution: Fixed in mhopt.pl: Option was not checked. +Version Fixed: 2.4.5 +------------------------------------------------------------------------ +Version: 2.4.4, and earlier +Problem: %y print 3 digits in time format strings if year 2000 + or later. +Solution: Fixed in mhtime.pl +Version Fixed: 2.4.5 +------------------------------------------------------------------------ +Version: 2.4.0-4 +Problem: 
 tags are printed when decoding ISO-2022-JP
+		encoded header text.
+Solution:	Fixed in iso2022jp.pl
+Version Fixed:	2.4.5
+------------------------------------------------------------------------
+Version:	2.4.3, and earlier
+Problem:   	Text/html filter died with a "Modification of
+		non-creatable array" error when a relative URL
+		exists in body data, but no base URL defined for
+		the html data.
+Solution:	Fixed in mhtxthtml.pl
+Version Fixed:	2.4.4
+------------------------------------------------------------------------
+Version:	2.4.0 - 2.4.3
+Problem:   	Error "Can't modify keys in scalar assignment" occurs
+		when using older version of Perl 5.
+Solution:	Later Perl 5 releases support keys operator as an
+		lvalue to preallocate a hash.  Assignment put in
+		an eval block to avoid program termination.
+Version Fixed:	2.4.4
+------------------------------------------------------------------------
+Version:	2.3.0 - 2.4.3
+Problem:   	Setting IDXSIZE < MAXSIZE for a single page index
+		causes the generation of incorrect list entries and
+		null list entries.
+Solution:	Fixed in mhindex.pl
+Version Fixed:	2.4.4
+------------------------------------------------------------------------
+Version:	2.4.3, and earlier
+Problem:   	Using entity references within MONTHS, WEEKDAYS, et al,
+		not supported and caused names to be incorrect.
+Solution:	The semi-colon, ';', was treated as an undocumented
+		list separator in resource files.  "Feature" removed.
+Version Fixed:	2.4.4
+------------------------------------------------------------------------
+Version:	2.4.2
+Problem:   	$*GMTDATE$ and $*LOCALDATE$ expand to the empty string
+		if using default time format string settings.
+Solution:	Fixed in mhtime.pl
+Version Fixed:	2.4.3
+------------------------------------------------------------------------
+Version:	2.4.2, and earlier
+Problem:   	Multipart processing is done inproperly if nested
+		multiparts exist and "outer" multipart entity has a
+		boundary which is a substring prefix of an "inner"
+		multipart entity.
+Solution:	Fixed in readmail.pl
+Version Fixed:	2.4.3
+------------------------------------------------------------------------
+Version:	2.4.2, and earlier
+Problem:   	Cid URL in multipart/related is not resolved if message
+		part being referenced is at a higher "level" (due to
+		nested multiparts) than the referrer.
+Solution:	Fixed in readmail.pl
+Version Fixed:	2.4.3
+------------------------------------------------------------------------
+Version:	2.4.2, and earlier
+Problem:   	-tnosort and -tnosubsort should be -notsort and
+		-notsubsort.  Also, bogus -tnoreverse and -notgziplinks
+		options listed in -help message.
+Solution:	Fixed.
+Version Fixed:	2.4.3
+------------------------------------------------------------------------
+Version:	2.4.2, and earlier
+Problem:   	Charset parameter value not properly extracted when
+		no space after value and next parameter
+		(Example: charset=us-ascii;name="file.txt").
+Solution:	Fixed in mhtxtplain.pl
+Version Fixed:	2.4.3
+------------------------------------------------------------------------
+Version:	2.4.1, and earlier
+Problem:   	M2H_URL envariable does not properly affect the URL
+		resource.  M2H_SORT does affect it.
+Solution:	Fixed (typo).
+Version Fixed:	2.4.2
+------------------------------------------------------------------------
+Version:	2.4.1, and earlier
+Problem:   	%c does not work in time format resources.
+Solution:	Fixed.
+Version Fixed:	2.4.2
+------------------------------------------------------------------------
+Version:	2.4.1
+Problem:   	When invoking mha-dbrecover, Perl errors occur for
+		mhmsgfile.pl.
+Solution:	Fixed.
+Version Fixed:	2.4.2
+------------------------------------------------------------------------
+Version:	2.4.0, and earlier
+Problem:   	DOC resource setting not stored in database.
+Solution:	Fixed.
+Version Fixed:	2.4.1
+------------------------------------------------------------------------
+Version:	2.4.0
+Problem:   	Default filehandle changed to STDERR after call to
+		get_resources().  Can cause problems for Perl apps
+		calling MHonArc via API.
+Solution:	Fixed.
+Version Fixed:	2.4.1
+------------------------------------------------------------------------
+Version:	2.4.0
+Problem:   	MHonArc under BSD OS would go into Win/MS-DOS mode.
+Solution:	Make check for "dos" platform stricter in osinit.pl.
+Version Fixed:	2.4.1
+------------------------------------------------------------------------
+Version:	2.3.3
+Problem:   	Duplicate message-ids in a message's reference list
+		were not removed.
+Solution:	Array changed to my() scope caused remove_dups()
+		to not do anything (it takes a typeglob).  Array
+		changed back to local().
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.0-3
+Problem:   	TFIRST, TLAST, and PARENT arguments to resource
+		variables always produced null values.
+Solution:	Fixed.  Note, PARENT is now TPARENT to be consistent
+		with other thread-related arguments.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.0-3
+Problem:   	SUBJECTHEADER resource not printed when -savemem is
+		used.
+Solution:	Problem is due to the new resource variable handling
+		in 2.3.  The solution is to support the editing of
+		SUBJECTHEADER (and HEADBODYSEP) in existing message
+		pages.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.3, and earlier versions
+Problem:   	Multipart processing not done properly if boundary
+		parameter not enclosed in quotes and is terminated
+		by a semi-colon.
+Solution:	Fixed in readmail.pl.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.3, and earlier versions
+Problem:   	%h not recognized in time format strings.
+Solution:	Fixed.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.3
+Problem:   	Use of $ICON$ will generate defective tag like
+		`ALT="[text/plain]">'.
+Solution:	Fixed typo in join() call in mhrcvars.pl.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.3, and earlier versions
+Problem:   	Some messages with specified inline images are not
+		having images inlined.
+Solution:	Content-Disposition parsing fixed.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.3, and earlier versions
+Problem:   	Clip length not handled properly in resource variables.
+		Ie.  Characters that are translated into entity
+		references are not handled properly when computing clip
+		adjustment.  Incorrect clipping can occur.
+Solution:	Fixed.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.3, and some possible earlier versions
+Problem:   	MHonArc checking for writable OUTDIR in SINGLE mode.
+Solution:	Fixed.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.3, and earlier
+Problem:   	Default resource file not read if located in MHonArc
+		lib directory.
+Solution:	Fixed improper assumption of @INC setting.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
+Version:	2.3.3, and earlier
+Problem:   	TLIEND not generated at proper times when thread level
+		goes beyond TLEVELS.
+Solution:	A check is made in thread index printing to generate a
+		TLIEND properly for TLITXT when deeper than TLEVELS.
+Version Fixed:	2.4.0
+------------------------------------------------------------------------
 Version:	2.3.0-2.3.2
 Problem:   	-otherindex and -perlinc command-line options do not
 		work.  Using them has no affect.
diff --git a/CHANGES b/CHANGES
index 7761861..ce601d6 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,34 +1,423 @@
-		    Version History for MHonArc
-		    ===========================
-	
+		     Change History for MHonArc
+		     ==========================
+		     
 
-Version history for MHonArc.  Changes listed are brief.  Consult
-the documentation for further information/clarification.  It is
-possible that not all changes are documented here.
+Change history for MHonArc.  Changes listed are brief.  Consult the
+documentation for further information/clarification.  It is possible
+that not all changes are documented here.
 
 MM/DD/YYYY
 =======================================================================
 #######################################################################
+=======================================================================
+06/10/2001	(2.4.9)
+
+    o	Added the following resources:
+
+	    MIMEEXCS		List of content-types to exclude
+				from processing.  Exclusion occurs
+				before data is passed to filters.
+
+    o	mhtxtplain.pl: If decoding uuencoded data, the data will
+	be excluded if application/octet-stream is listed the
+	MIMEEXCS resource.
+
+    o	mhtxthtml.pl: If a CID URL is not available, the CID URL
+	is no longer preserved in the converted output.  The CID
+	URL is stripped.
+
+    o	Added the following to mhmimetypes.pl content-type table:
+
+	  application/ms-excel		=> xls:MS-Excel spreadsheet
+	  application/ms-powerpoint	=> ppt:MS-Powerpoint presentation
+	  application/ms-project	=> mpp:MS-Project file
+
+	The "vnd." official versions are already present, but
+	some application use the above.
+
+    o	TODO list added to distribution.
+
+    Bug Fixes
+    ---------
+    See BUGS.
+
+=======================================================================
+04/13/2001	(2.4.8)
+
+    o	Added the following resources:
+
+	    KEEPONRMM   	Do not remove message files from disk
+				when messages are removed from the
+				archive.
+
+    o	m2h_text_plain::filter now uses CHARSETCONVERTERS for
+	translating text data with a specified charset parameter.
+	The only exception is iso-2022-jp, which is handled directly
+	to properly support nourl flag.
+
+    o	m2h_external::filter new arguments:
+
+	excludeexts=ext1,...
+		  A comma separated list of message specified filename
+		  extensions to exclude.  I.e.	If the filename
+		  extension matches an extension in excludeexts, the
+		  content will not be written.	The return markup
+		  will contain the name of the attachment, but no
+		  link to the data.  This option is best used with
+		  application/octet-stream to exclude unwanted data
+		  that is not tagged with the proper content-type.
+		  The m2h_null::filter can be used to exclude content
+		  by content-type.
+
+    o	m2h_null::filter will now output a one line description
+	of the excluded content.  This is so the reader knows that
+	there was message content not saved within the archive.
+
+    o	m2h_text_plain::filter new arguments:
+
+	usename		If extracting uuencoded data, the filename
+			specified should be used.
+
+    o	m2h_text_html::filter new arguments:
+
+ 	allowcomments	Preserve any comment declarations.  Normally
+ 			Comment declarations are munged to prevent
+ 			SSI attacks or comments that can conflict
+ 			with MHonArc processing.  Use this option
+ 			with care.
+
+	(NOTE: Comment declarations were completely stripped before,
+	 but the regex used was known to crash perl on large comment
+	 declarations, so a simplier expression is now used to
+	 modify comment declarations to prevent possible attacks.)
+
+
+    Bug Fixes
+    ---------
+    See BUGS.
+
+=======================================================================
+10/28/2000	(2.4.7)
+
+    o	Added the following options to m2h_text_plain::filter:
+
+	attachcheck	Honor attachment disposition.  By default,
+			all text/plain data is displayed inline on
+			the message page.  If attachcheck is specified
+			and Content-Disposition specifies the data as
+			an attachment, the data is saved to a file
+			with a link to it from the message page.
+	htmlcheck	Check if message is actually an HTML message
+			(to get around abhorrent MUAs).  The message
+			is treated as HTML if the first non-whitespace
+			data looks like the start of an HTML document.
+
+    o	FROMFIELD resource default value is now:
+
+	  from:mail-reply-to:reply-to:return-path:apparently-from:
+	  sender:resent-sender
+
+	The change is the addition of "mail-reply-to."
+
+    o	Added the following resource variables:
+
+	    $MSGTORDNUM$	Ordinal number of message in current
+				thread.
+
+    o	Added the following resource variable message specificiers:
+
+	    TEND		Last message of current discussion
+				thread.
+	    TTOP		Top/root message of current discussion
+				thread.
+
+    o	Changes to readmail.pl:
+	-   %Cid hash keys are now URLs.  Content-Ids are denoted
+	    as "cid:..."  Hash also contains Content-Location values
+	    of message parts.  This allows filters (like the HTML
+	    filter) to check for external URL references where
+	    the data for the reference is included with the message.
+	-   More robust handling of malformed multipart messages.
+
+    o	The null filter is applied to application/ms-tnef by default.
+
+    o	Lowercase tag names are now used in default resource values
+	that contain HTML markup.
+
+    o	Bug fixes to the documentation.
+
+
+    Bug Fixes
+    ---------
+    See BUGS.
+
+=======================================================================
+04/24/2000	(2.4.6)
+
+    o	Stricter check is made when decoded quoted-printable data.
+	An escape sequence is only converted to a raw character if
+	a it is a valid escape sequence.  I.e.  Any '=' not followed
+	by two hexadecimal characters is left as-is.
+
+    o	Call to Digest::MD5::md5_hex() wrapped in eval block in
+	case of bad installations of Digest::MD5 module.
+
+    Bug Fixes
+    ---------
+    See BUGS.
+
+=======================================================================
+02/14/2000	(2.4.5)
+
+    Enhancements/Changes
+    --------------------
+    o	Following changes to m2h_text_html::filter:
+	-   All comment declarations are removed.  This avoid
+	    potential SSI attacks and declarations that may conflict
+	    with MHonArc.
+	-   Additional tags have been added to the to-strip list
+	    to avoid potential client-side scripting attacks.  See
+	    MIMEFILTERS docs for list.
+	-   Added "nofont" option to strip out any  tags.
+
+    o	Added application/x-bzip2 to known mime types (mhmimetypes.pl).
+
+    o	Simple modification to get_time_from_date() in mhutil.pl to
+	handle abhorrent case of message date using a 2 digit year.
+
+    o	Under VMS, the default lock file name has been changed to
+	"mhonarc_lck" for directory based locking will work.
+
+    o	mhonarc::htmlize/entify now translates the double-quote
+	character (") to ".
+
+    o	Added VARREGEX resource to allow customization of resource
+	variable matching.  Mainly for use with resource files written
+	on multibyte charsets like SJIS.  Use with caution.
+
+    Bug Fixes
+    ---------
+    See BUGS.
+
+=======================================================================
+10/01/1999	(2.4.4)
+
+    Enhancements/Changes
+    --------------------
+    o	Added the following resources:
+    
+	    MIMEDECODERS	Content-Transfer-Encoding decoding
+				functions.
+
+    o	Added the following resource variables:
+
+	    $PGLINKLIST$	Print out a list of index page links.
+
+    o	New content filter for message/external-body.
+
+    o	Message/delivery-status content handled by mhtxtplain.pl
+
+    o	Support for "Zone[+-]DDDD" timezone specification.
+
+    o	MAILparse_parameter_str() function added to readmail.pl.
+	Function supports parsing parameter value strings with support
+	for RFC 2184 extensions.  Function added to provide
+	support for message/external-body filter.
+
+    Bug Fixes
+    ---------
+    See BUGS.
+
+=======================================================================
+08/15/1999	(2.4.3)
+
+    Enhancements/Changes
+    --------------------
+    o	Added the following resources:
+
+	    POSIXSTRFTIME	Use POSIX::strftime() or not for
+				processing time format strings
+
+    o	The "latin[1-6]" character sets defined in the default
+	value of CHARSETCONVERTERS.   iso8859::str2sgml modified
+	to use proper iso8859 map for specified latin[1-6]
+	specification.
+
+    o	The text/html filter now strips out scripting markup by
+	default.  To allow scripting markup to be preserved, the
+	"allowscript" option can be used.
+
+    o	Unknown media-types are now treated as application/octet-stream,
+	which will invoke the application/octet-stream filter.
+	Because of this, an explicit entry for application/octet-stream
+	has been added to the default value of MIMEFILTERS.
+
+    o	If in a multipart/alternative entity, and no known media-types
+	exists, the last part is treated as application/octet-stream.
+
+    Bug Fixes
+    ---------
+    See BUGS.
+
+=======================================================================
+08/11/1999	(2.4.2)
+
+    Enhancements/Changes
+    --------------------
+    o	Added the following resources:
+
+	    STDIN		Source for standard input
+
+    o	Added the following resource variables:
+
+	    $ENV$		Print an environment variable
+
+    o	Added support for decoding uuencoded data within text
+	messages in mhtxtplain.pl.  Decoding activated via the
+	"uudecode" option.
+
+    o	For processing time format strings, POSIX::strftime() is
+	used, if available.  If not, MHonArc implementation is
+	used.
+
+    o	The default value of FROMFIELDS now includes "return-path".
+
+    o	Description section moved before Options section in -help
+	message.
+
+    Bug Fixes
+    ---------
+    See BUGS.
+
+=======================================================================
+07/25/1999	(2.4.1)
+
+    Enhancements/Changes
+    --------------------
+    o	Added the following resources:
+
+	    MSGEXCFILTER	Perl expressions for excluding
+				messages from archive.
+	    SAVERESOURCES	Flag if resource values should be
+				saved in database.
+
+    o	Added the following resource variables:
+
+	    $HTMLEXT$		Value of HTMLEXT resource.
+
+    o	Documentation corrections an additions.
+
+    o	Use of typeglobs removed from mhdb.pl.
+
+    o	mhtime.pl explicitly defined in mhonarc package.
+
+    Bug Fixes
+    ---------
+    See BUGS.
+
+=======================================================================
+06/25/1999	(2.4.0)
+
+    Enhancements/Changes
+    --------------------
+    o	Added the following resources:
+
+	    ADDRESSMODIFYCODE	Perl expressions to apply to addresses
+				during message header conversion.
+	    CHECKNOARCHIVE	Check "no archive" flag in messages.
+	    LOCKMETHOD		The type of archive locking performed.
+	    SPAMMODE		Perform actions to deter email address
+				harvesters.
+	    SSMARKUP		Markup at the *very* beginning of any
+				generated page.
+	    STDOUT		Destination of stdout messages/data.
+	    STDERR		Destination of stderr messages/data.
+	    SUBJECTTHREADS	To check, or not to check, subjects when
+				computing threads.
+
+    o	Added the following resource variables:
+
+	    $FROMADDRNAME$	Username portion of From email address.
+	    $FROMADDRDOMAIN$	Domain portion of From email address.
+	    $TOADDRNAME$	Username portion of an email address
+				(applicable in MAILTOURL only).
+	    $TOADDRDOMAIN$	Domain portion of an email address
+				(applicable in MAILTOURL only).
+
+    o	A new utility program: mha-decode.  The program functions
+	as a MIME message decoder.  Can be used against mail folders
+	or single messages.
+
+    o	The "PARENT" argument to applicable resource variables is now
+	called "TPARENT".  This change should not affect anyone since
+	the "PARENT" argument did not work properly in previous
+	releases.
+
+    o	SUBJECTHEADER and HEADBODYSEP resource changes will now affect
+	existing messages that are edited during normal operations or
+	via EDITIDX.  Note, messages created from old versions of
+	MHonArc may not be affected.
+
+    o	The default TIMEZONES settings now has a more complete list.
+
+    o	Timezone acronym settings now support [+-]HHMM specifications.
+
+    o	Support for ISO-2022-JP encoded strings in message headers
+	is now supported.  It does assume that HTML viewer supports
+	ISO-2022-JP.
+
+    o	If Digest::MD5 is installed, md5_hex() will be used to create
+	message-ids for messages without message-ids.  This allows
+	MHonArc to ignore non-message-id archived messages in ADD mode.
+	The MD5 digest is computed only on message header for efficieny.
+	If Digest::MD5 is not installed, a message-id will still be
+	assigned if none present, but MHonArc will not be able to
+	detect if message has already been archived in subsequent ADD
+	operations.
+
+    o	Text/html filter supports the "noscript" option.  If
+	specified, any script-related markup will be removed.
+	This provides added security to avoid sites being compromised
+	with foreign client-side scripting.
+
+    o	Added the following options to mhexternal.pl (the save-to-file
+	filter): forceattach, forceinline, and inlineexts.
+
+    o	Recognize mailing list headers as defined by RFC 2369 and
+	hyperlink URLs listed.
+
+    o	If no boundaries exist in a multipart message (even though
+	a boundary is defined in the header), MHonArc will treat
+	the entire body as the first part.  This prevents "unable
+	to process" warnings.
+
+    o	The "/;
+	if (/^/) {
+	    push(@field, $1);
+	    push(@{$field{$1}}, mhonarc::entify(mhonarc::uncommentize($2)));
+	}
+    }
+
+    my $atitle = $Rc->{archive}{$arch}[0];
+    print <
+
+$atitle: $msgnum
+
+EOT
+
+    my %printed = ();
+    foreach $field (@field) {
+	next  if $printed{$field};
+	$printed{$field} = 1;
+	print qq(\n),
+	      qq($field \n),
+	      qq();
+	print join(",
", @{$field{$field}});
+	print qq(\n);
+    }
+    print "\n";
+
+    ## Just extract the message header and body part of the page.  Adjust
+    ## relative URLs so links to derived files will work.
+    my $replsub = sub {
+	my $url = shift;
+	unless ($url =~ /^[\w]+:/ or $url =~ /^\// or $url =~ /^#/) {
+	    return $base . $url;
+	}
+	$url;
+    };
+    while () {
+	next  unless /^/i;
+	while () {
+	    last  if /^/i;
+	    s/(href\s*=\s*["'])([^"']+)(["'])
+	     /join("",$1,&$replsub($2),$3)
+	     /xgei;
+	    s/(src\s*=\s*["'])([^"']+)(["'])
+	     /join("",$1,&$replsub($2),$3)
+	     /xgei;
+	    print;
+	}
+	last;
+    }
+    close MHAMESG;
+
+    ## Done
+    1;
+}
+
+##---------------------------------------------------------------------------##
+
+sub set_resources {
+    my $cgiurl = $query->url() . "?archive=$archive";
+
+    $mhonarc::NOTE	=<<'EOT';
+
+
+
$NOTETEXT$

+EOT
+    $mhonarc::NOTEIA	= "";
+    $mhonarc::NOTEICON	=<
+EOT
+    $mhonarc::NOTEICONIA='';
+}
+
+##---------------------------------------------------------------------------##
+
+sub set_main_idx_resources {
+    my $sort = shift;
+    my $cgiurl = $query->url() . "?archive=$archive";
+
+    $mhonarc::IDXPGBEG	 = '';
+    $mhonarc::IDXPGEND	 = '';
+
+    $mhonarc::LIBEG =<
+
+
+

+\$IDXTITLE\$
+

+
+
+
+
+
+
+
\$NUMOFIDXMSG\$/\$NUMOFMSG\$
+by \$SORTTYPE\$
+
+
+Page \$PAGENUM\$/\$NUMOFPAGES\$

+
+
+
+EOT
+
+    $mhonarc::LIEND =<<'EOT';
+
+
+EOT
+
+    my $colheads, $colcnt;
+    my @col = ();
+
+    $col[0] =<
+
+EOT
+
+    if ($sort eq 'authsort') {
+	$colheads = '';
+	$col[1] = '';
+	$col[2] = '';
+    } elsif ($sort eq 'subsort') {
+	$colheads = '';
+	$col[1] = '';
+	$col[2] = '';
+    } elsif ($sort eq 'nosort') {
+	$colheads = '';
+	$col[1] = '';
+	$col[2] = '';
+	$col[3] = '';
+    } else {
+	$colheads = '';
+	$col[1] = '';
+	$col[2] = '';
+	$col[3] = '';
+    }
+    $colcnt = scalar(@col);
+    $mhonarc::LIBEG .= $colheads;
+    $mhonarc::LIEND .= $colheads;
+
+    $mhonarc::LIEND .=<<'EOT';
+
Number
Number
+    
+    
+    
+    
+    
+    
+    
\$NOTEICON\$\$MSGNUM\$

+		DateSubject
$YYYYMMDD$$SUBJECTNA$DateFrom
$YYYYMMDD$$FROMNAME$DateFromSubject
$YYYYMMDD$$FROMNAME$$SUBJECTNA$DateFromSubject
$MSGLOCALDATE(;%H:%M)$$FROMNAME$$SUBJECTNA$

+
+
+
+
+
+
+
$NUMOFIDXMSG$/$NUMOFMSG$
+by $SORTTYPE$
+
+
+Page $PAGENUM$/$NUMOFPAGES$

+
+EOT
+
+    $mhonarc::LITMPL = join("", @col);
+
+    $mhonarc::NOTEICONIA='   ';
+
+    $mhonarc::AUTHBEG	 =<
+
+\$FROMNAME\$
+EOT
+    $mhonarc::AUTHEND	 =<
+EOT
+
+    $mhonarc::DAYBEG	 =<
+
+\$MSGLOCALDATE(;%B %d, %Y)\$
+EOT
+    $mhonarc::DAYEND	 =<
+EOT
+
+    $mhonarc::SUBJECTBEG =<
+
+\$SUBJECTNA\$
+EOT
+    $mhonarc::SUBJECTEND =<
+EOT
+
+
+}
+
+##---------------------------------------------------------------------------##
+
+sub set_thread_idx_resources {
+    my $cgiurl = $query->url() . "?archive=$archive";
+
+    $mhonarc::TIDXPGBEG = '';
+    $mhonarc::TIDXPGEND = '';
+
+    $mhonarc::THEAD	=<
+
+
+

+\$TIDXTITLE\$
+

+
+
+
+
+
+
+
\$NUMOFIDXMSG\$/\$NUMOFMSG\$
+by \$SORTTYPE\$
+
+
+Page \$PAGENUM\$/\$NUMOFPAGES\$

+EOT
+    $mhonarc::TFOOT	=<<'EOT';
+
+
+
+
+
+
+
$NUMOFIDXMSG$/$NUMOFMSG$
+by $SORTTYPE$
+
+
+Page $PAGENUM$/$NUMOFPAGES$

+EOT
+
+    $mhonarc::TSINGLETXT =<
+
+\$NOTEICON\$\$MSGNUM\$,
+\$SUBJECTNA\$, \$FROMNAME\$
+
+EOT
+    $mhonarc::TTOPBEG	=<
+
+
+\$SUBJECTNA\$
+
+

+

+\$NOTEICON\$\$MSGNUM\$,
+\$FROMNAME\$
+EOT
+    $mhonarc::TTOPEND	=<<'EOT';
+

+
+EOT
+    $mhonarc::TLITXT	=<
+\$NOTEICON\$\$MSGNUM\$,
+\$FROMNAME\$
+EOT
+    $mhonarc::TLIEND	=<<'EOT';
+
+EOT
+    $mhonarc::TSUBLISTBEG =<<'EOT';
+

+EOT
+    $mhonarc::TSUBLISTEND =<<'EOT';
+

+EOT
+    $mhonarc::TSUBJECTBEG =<<'EOT';
+Possible follow-ups
+EOT
+    $mhonarc::TSUBJECTEND =<<'EOT';
+EOT
+    $mhonarc::TLINONE =<<'EOT';
+
Message not available
+EOT
+    $mhonarc::TLINONEEND =<<'EOT';
+

+EOT
+    $mhonarc::TINDENTBEG =<<'EOT';
+

+EOT
+    $mhonarc::TINDENTEND =<<'EOT';
+

+EOT
+    $mhonarc::TCONTBEG =<<'EOT';
+
+
+
+
+
+

+$SUBJECTNA$ (continued)

+EOT
+    $mhonarc::TCONTEND =<<'EOT';
+

+
+EOT
+
+}
+
+##---------------------------------------------------------------------------##
+
+sub print_main_menus {
+    print <
+
+MHonArc 
+
+ 
+
+ 
+
+ 
+
+
+
+EOT
+
+}
+
+##---------------------------------------------------------------------------##
+
+sub html_error {
+    print <<'EOT';
+

+
+
+
+
Note

+EOT;
+    print $query->p(@_);
+    print <<'EOT';
+

+

+EOT
+}
+
+##---------------------------------------------------------------------------##
+##	JavaScript Code
+##---------------------------------------------------------------------------##
+
+sub jscript_define {
+
+    ## JavaScript for main index page
+    ##-----------------------------------------------------------------------##
+    $JSMenuBar =<<'EOJS';
+
+// Set the selection of all messages
+function checkAll (form, val) {
+    var i;
+    for (i=0; i < form.elements.length; ++i) {
+	if (form.elements[i].name == 'msgnum') {
+	    form.elements[i].checked = val;
+	}
+    }
+}
+
+// Process Archive menu selection
+function process_file_menu (menu) {
+    var choice	  = menu.options[menu.selectedIndex].value;
+    var text 	  = menu.options[menu.selectedIndex].text;
+    var list_form = parent.mhaWorkArea.document.listForm;
+    var type	  = choice.substr(0,4);
+    var val	  = choice.substr(5);
+
+    if (choice != "title") {
+	list_form.archive.value = val;
+	parent.defaultStatus = text;
+	parent.status = text;
+	list_form.action.value = 'index';
+	list_form.submit();
+    }
+    menu.options[menu.selectedIndex].selected = false;
+    menu.options[0].selected = true;
+}
+
+// Process Edit menu selection
+function process_edit_menu (menu) {
+    var choice = menu.options[menu.selectedIndex].value;
+    var list_form = parent.mhaWorkArea.document.listForm;
+
+    menu.options[menu.selectedIndex].selected = false;
+    menu.options[0].selected = true;
+
+    if (choice == "selectAll") {
+        checkAll(list_form, true);
+
+    } else if (choice == "unselectAll") {
+        checkAll(list_form, false);
+
+    } else if (choice == "reset") {
+        list_form.reset();
+
+    } else if (choice == "show") {
+	list_form.action.value = 'show';
+	window.open('javascript:void(0)',
+		    'mhaMesgView',
+		    'menubar=0,resizable=1,toolbar=0,scrollbars=1');
+	list_form.submit();
+
+    } else if (choice == "delete") {
+	if (window.confirm("Delete selected messages?")) {
+	    list_form.action.value = 'delete';
+	    list_form.submit();
+	}
+    }
+}
+
+// Process View menu selection
+function process_view_menu (menu) {
+    var choice = menu.options[menu.selectedIndex].value;
+    var list_form = parent.mhaWorkArea.document.listForm;
+    var type = choice.substr(0,4);
+    var val = choice.substr(5);
+    var n;
+
+    menu.options[menu.selectedIndex].selected = false;
+    menu.options[0].selected = true;
+
+    if (type == "sort") {
+	list_form.sort.value = val;
+	list_form.action.value = 'index';
+        list_form.submit();
+
+    } else if (type == "rfsh") {
+	list_form.action.value = 'index';
+        list_form.submit();
+
+    } else if (type == "pgsz") {
+	n = parseInt(
+		window.prompt(
+		    "Maximum number of message listed per page:",
+		    list_form.pagesize.value));
+	if ((!isNaN(n)) && (n >= 0) && (n != list_form.pagesize.value)) {
+	    list_form.pagesize.value = n;
+	    list_form.action.value = 'index';
+	    list_form.submit();
+	}
+
+    } else if (type == "page") {
+	list_form.page.value = val;
+	list_form.action.value = 'index';
+	list_form.submit();
+    }
+}
+EOJS
+
+    ## JavaScript for main index page
+    ##-----------------------------------------------------------------------##
+    $JSIndexPage =<<'EOJS';
+
+// Handle button navigation
+function changePage (f, val) {
+    f.page.value = val;
+    f.action.value = 'index';
+    f.submit();
+}
+
+// Set the selection of all messages in a group
+function checkGroup (topmesg) {
+    var val   = topmesg.checked;
+    var i;
+    for (i=0; i < topmesg.form.elements.length; ++i) {
+	if (topmesg.form.elements[i] == topmesg) {
+	    break;
+	}
+    }
+    ++i;
+    if (i >= topmesg.form.elements.length) {
+	return;
+    }
+    while (topmesg.form.elements[i].name == 'msgnum') {
+	topmesg.form.elements[i].checked = val;
+	++i;
+    }
+}
+
+// Open a message view window for a message
+function open_mesg_view (cgiurl) {
+    window.open(cgiurl,
+	'mhaMesgView',
+	'menubar=0,resizable=1,toolbar=0,scrollbars=1');
+}
+
+EOJS
+
+}
diff --git a/admin/mhaadmin.html b/admin/mhaadmin.html
new file mode 100644
index 0000000..b7bc732
--- /dev/null
+++ b/admin/mhaadmin.html
@@ -0,0 +1,12 @@
+
+
+
+MHonArc Archive Admin
+
+
+    
+    
+
+
diff --git a/admin/mhaadmin.rc b/admin/mhaadmin.rc
new file mode 100644
index 0000000..0a35668
--- /dev/null
+++ b/admin/mhaadmin.rc
@@ -0,0 +1,33 @@
+#!/usr/local/bin/perl
+## mhaadmin.cgi resource file
+
+## The syntax of this file is Perl.  mhaadmin.cgi will require this file
+## at start-up.  This file should be in the same directory as mhaadmin.cgi.
+
+## Location of MHonArc libraries
+use lib qw( /home/ehood/work/perl/MHonArc/lib );
+
++{
+    ## Type of archive locking performed
+    ## ---------------------------------
+    'lockmethod' => 'directory',	# Directory file method (default)
+    #'lockmethod' => 'flock',		# Flock() method (use it if you can)
+
+    ## Hash of archives to manage
+    ## --------------------------
+    'archive' 	=> {
+	## 'full/pathname/to/archive' =>
+	    ## [ "Label to appear in admin program", "Base URL to archive"],
+
+	'/home/ehood/work/perl/MHonArc/work/cgitest' =>
+	    [ 'Cgi Test', 'http://localhost/mha-bin/cgitest/' ],
+
+	'/home/ehood/work/perl/MHonArc/work/out' =>
+	    [ 'MIME Test', 'http://localhost/mha-bin/out/' ],
+    },
+
+    ## Image URL: Where icons are located
+    ## ----------------------------------
+    'iconurl'	=> 'images',
+};
+## NOTHING GOES BELOW THIS LINE
diff --git a/bat/README b/bat/README
deleted file mode 100644
index 2e574b0..0000000
--- a/bat/README
+++ /dev/null
@@ -1,19 +0,0 @@
-README for MHonArc/bat
-
----------------------------------------------------------------------------
-CONTENTS of directory:
-
-README		  The file you are reading
-
-mhonarc.bat	  Batch file to invoke MHonArc as mhonarc.
-
----------------------------------------------------------------------------
-NOTES
-
-The batch files are for your use if you are running MHonArc under
-MS-DOS.  Edit the paths in the files to reflect where you have
-installed MHonArc via the install.me program.  Then copy the batch
-files to a location in your executable search path.
-
----------------------------------------------------------------------------
-Copyright (C) 1997,	Earl Hood, ehood@medusa.acs.uci.edu
diff --git a/bat/mhonarc.bat b/bat/mhonarc.bat
deleted file mode 100644
index 4066373..0000000
--- a/bat/mhonarc.bat
+++ /dev/null
@@ -1,2 +0,0 @@
-@echo off
-perl c:/bin/mhonarc %1 %2 %3 %4 %5 %6 %7 %8 %9
diff --git a/doc/app-bugs.html b/doc/app-bugs.html
index 3e463d6..51a46ba 100644
--- a/doc/app-bugs.html
+++ b/doc/app-bugs.html
@@ -1,27 +1,37 @@
 
 
 
-
-MHonArc v2.3 -- Appendix: Bugs
-
+MHonArc v2.4 -- Appendix: Bugs
 
 
 
 

-[Prev][Next][TOC][FAQ][Bugs][Home]
+[Prev][Next][TOC][FAQ][Bugs][Home]
 

 
 

 
 
Appendix: Bugs

 
+
+
+
+
 

 
Reporting Bugs

 
-
To report a bug against MHonArc, send mail to
-mhonarc@ncsa.uiuc.edu and
-please include the following information:
+
To report a bug against MHonArc, send mail to the MHonArc
+mailing list,
+mhonarc@ncsa.uiuc.edu.  The list
+is closed to subscribers, so if you are not subscribed, you can
+send mail to mhonarc@mhonarc.org.
+

+
+
Please include the following information in your message:
 

 
 
    
@@ -49,7 +59,7 @@ 
    Reporting Bugs
    
 in the
 documentation to see if the bug has already been reported (and maybe
 fixed).  You may need to go the
-MHonArc
+MHonArc
 home page
 to check the bug list in case you are not using the latest version
 of MHonArc.
@@ -74,6 +84,811 @@ 
    Bug List
    
 
 
 Version
+2.4.8, and earlier
+
+
+Problem
+Default CHARSETCONVERTERS values for latin[1-6] charsets causing require error.
+
+
+
+Solution
+This was supposedly fixed in 2.4.8 in mhinit.pl, but apparently was not.  The def-mime.mrc file in the
+ example directory did have the correct mappings.
+
+
+
+Fixed
+2.4.9
+
+
+
    
+
+
+Version
+2.4.8
+
+
+Problem
+MHonArc aborts with Perl syntax errors if mhnull.pl filter is loaded.
+
+
+
+Solution
+Dump typo errors that should have been caught before release.  Syntax errors fixed in mhnull.pl.
+
+
+
+Fixed
+2.4.9
+
+
+
    
+
+
+Version
+2.4.7, and earlier
+
+
+Problem
+Message with HTML content can cause perl to crash. Other symptom would be that a stale .mhonarc.lck
+ directory would exist preventing further archive
+ updates.
+
+
+
+Solution
+There appears to be a bug in perl's regex engine. The fix was to change mhtxthtml.pl comment declaration
+ removal expression into a simplier one that just
+ munges (removes parts) to avoid crashes.
+
+
+
+Fixed
+2.4.8
+
+
+
    
+
+
+Version
+2.4.7, and earlier
+
+
+Problem
+Prefixing second argument to $PGLINKLIST()$ with a 'T' cause no thread page links to be rendered after
+ current thread index page.
+
+
+
+Solution
+Fixed in mhrcvars.pl: Make sure to strip 'T' from both arguments before evaluating numeric values.
+
+
+
+Fixed
+2.4.8
+
+
+
    
+
+
+Version
+2.4.7, and earlier
+
+
+Problem
+Default CHARSETCONVERTERS values for latin[1-6] charsets causing require error.
+
+
+
+Solution
+Fixed in mhinit.pl (typo in library filename).
+
+
+Fixed
+2.4.8
+
+
+
    
+
+
+Version
+2.4.6, and earlier
+
+
+Problem
+ADDRESSMODIFYCODE not stored in database.
+
+
+Solution
+Fixed in mhdb.pl (a dumb typo)
+
+
+Fixed
+2.4.7
+
+
+
    
+
+
+Version
+2.4.6, and earlier
+
+
+Problem
+TPARENT message specifier for applicable resource variables will cause a resource variable to expand
+ to the empty string if there is no parent message
+ to the current message.
+
+
+
+Solution
+If there is no parent message, TPARENT resolves to to the current message.
+
+
+
+Fixed
+2.4.7
+
+
+
    
+
+
+Version
+2.4.5, maybe earlier
+
+
+Problem
+Using message-ids with -rmm does not remove messages.
+
+
+Solution
+Fixed in mhrmm.pl
+
+
+Fixed
+2.4.6
+
+
+
    
+
+
+Version
+2.4.5
+
+
+Problem
+Japanese text messages not wrapped in PRE element.
+
+
+Solution
+Fixed in mhtxtplain.pl
+
+
+Fixed
+2.4.6
+
+
+
    
+
+
+Version
+2.4.4
+
+
+Problem
+$PGLINKLIST$ for threads did not work.
+
+
+Solution
+Fixed in mhrcvars.pl.
+
+
+Fixed
+2.4.5
+
+
+
    
+
+
+Version
+2.4.4, and earlier
+
+
+Problem
+-afs had no effect.
+
+
+Solution
+Fixed in mhopt.pl: Option was not checked.
+
+
+Fixed
+2.4.5
+
+
+
    
+
+
+Version
+2.4.4, and earlier
+
+
+Problem
+%y print 3 digits in time format strings if year 2000 or later.
+
+
+
+Solution
+Fixed in mhtime.pl
+
+
+Fixed
+2.4.5
+
+
+
    
+
+
+Version
+2.4.0-4
+
+
+Problem
+<PRE> tags are printed when decoding ISO-2022-JP encoded header text.
+
+
+
+Solution
+Fixed in iso2022jp.pl
+
+
+Fixed
+2.4.5
+
+
+
    
+
+
+Version
+2.4.3, and earlier
+
+
+Problem
+Text/html filter died with a "Modification of non-creatable array" error when a relative URL
+ exists in body data, but no base URL defined for
+ the html data.
+
+
+
+Solution
+Fixed in mhtxthtml.pl
+
+
+Fixed
+2.4.4
+
+
+
    
+
+
+Version
+2.4.0 - 2.4.3
+
+
+Problem
+Error "Can't modify keys in scalar assignment" occurs when using older version of Perl 5.
+
+
+
+Solution
+Later Perl 5 releases support keys operator as an lvalue to preallocate a hash.  Assignment put in
+ an eval block to avoid program termination.
+
+
+
+Fixed
+2.4.4
+
+
+
    
+
+
+Version
+2.3.0 - 2.4.3
+
+
+Problem
+Setting IDXSIZE < MAXSIZE for a single page index causes the generation of incorrect list entries and
+ null list entries.
+
+
+
+Solution
+Fixed in mhindex.pl
+
+
+Fixed
+2.4.4
+
+
+
    
+
+
+Version
+2.4.3, and earlier
+
+
+Problem
+Using entity references within MONTHS, WEEKDAYS, et al, not supported and caused names to be incorrect.
+
+
+
+Solution
+The semi-colon, ';', was treated as an undocumented list separator in resource files.  "Feature" removed.
+
+
+
+Fixed
+2.4.4
+
+
+
    
+
+
+Version
+2.4.2
+
+
+Problem
+$*GMTDATE$ and $*LOCALDATE$ expand to the empty string if using default time format string settings.
+
+
+
+Solution
+Fixed in mhtime.pl
+
+
+Fixed
+2.4.3
+
+
+
    
+
+
+Version
+2.4.2, and earlier
+
+
+Problem
+Multipart processing is done inproperly if nested multiparts exist and "outer" multipart entity has a
+ boundary which is a substring prefix of an "inner"
+ multipart entity.
+
+
+
+Solution
+Fixed in readmail.pl
+
+
+Fixed
+2.4.3
+
+
+
    
+
+
+Version
+2.4.2, and earlier
+
+
+Problem
+Cid URL in multipart/related is not resolved if message part being referenced is at a higher "level" (due to
+ nested multiparts) than the referrer.
+
+
+
+Solution
+Fixed in readmail.pl
+
+
+Fixed
+2.4.3
+
+
+
    
+
+
+Version
+2.4.2, and earlier
+
+
+Problem
+-tnosort and -tnosubsort should be -notsort and -notsubsort.  Also, bogus -tnoreverse and -notgziplinks
+ options listed in -help message.
+
+
+
+Solution
+Fixed.
+
+
+Fixed
+2.4.3
+
+
+
    
+
+
+Version
+2.4.2, and earlier
+
+
+Problem
+Charset parameter value not properly extracted when no space after value and next parameter
+ (Example: charset=us-ascii;name="file.txt").
+
+
+
+Solution
+Fixed in mhtxtplain.pl
+
+
+Fixed
+2.4.3
+
+
+
    
+
+
+Version
+2.4.1, and earlier
+
+
+Problem
+M2H_URL envariable does not properly affect the URL resource.  M2H_SORT does affect it.
+
+
+
+Solution
+Fixed (typo).
+
+
+Fixed
+2.4.2
+
+
+
    
+
+
+Version
+2.4.1, and earlier
+
+
+Problem
+%c does not work in time format resources.
+
+
+Solution
+Fixed.
+
+
+Fixed
+2.4.2
+
+
+
    
+
+
+Version
+2.4.1
+
+
+Problem
+When invoking mha-dbrecover, Perl errors occur for mhmsgfile.pl.
+
+
+
+Solution
+Fixed.
+
+
+Fixed
+2.4.2
+
+
+
    
+
+
+Version
+2.4.0, and earlier
+
+
+Problem
+DOC resource setting not stored in database.
+
+
+Solution
+Fixed.
+
+
+Fixed
+2.4.1
+
+
+
    
+
+
+Version
+2.4.0
+
+
+Problem
+Default filehandle changed to STDERR after call to get_resources().  Can cause problems for Perl apps
+ calling MHonArc via API.
+
+
+
+Solution
+Fixed.
+
+
+Fixed
+2.4.1
+
+
+
    
+
+
+Version
+2.4.0
+
+
+Problem
+MHonArc under BSD OS would go into Win/MS-DOS mode.
+
+
+Solution
+Make check for "dos" platform stricter in osinit.pl.
+
+
+Fixed
+2.4.1
+
+
+
    
+
+
+Version
+2.3.3
+
+
+Problem
+Duplicate message-ids in a message's reference list were not removed.
+
+
+
+Solution
+Array changed to my() scope caused remove_dups() to not do anything (it takes a typeglob).  Array
+ changed back to local().
+
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.0-3
+
+
+Problem
+TFIRST, TLAST, and PARENT arguments to resource variables always produced null values.
+
+
+
+Solution
+Fixed.  Note, PARENT is now TPARENT to be consistent with other thread-related arguments.
+
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.0-3
+
+
+Problem
+SUBJECTHEADER resource not printed when -savemem is used.
+
+
+
+Solution
+Problem is due to the new resource variable handling in 2.3.  The solution is to support the editing of
+ SUBJECTHEADER (and HEADBODYSEP) in existing message
+ pages.
+
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.3, and earlier versions
+
+
+Problem
+Multipart processing not done properly if boundary parameter not enclosed in quotes and is terminated
+ by a semi-colon.
+
+
+
+Solution
+Fixed in readmail.pl.
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.3, and earlier versions
+
+
+Problem
+%h not recognized in time format strings.
+
+
+Solution
+Fixed.
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.3
+
+
+Problem
+Use of $ICON$ will generate defective tag like `ALT="[text/plain]">'.
+
+
+
+Solution
+Fixed typo in join() call in mhrcvars.pl.
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.3, and earlier versions
+
+
+Problem
+Some messages with specified inline images are not having images inlined.
+
+
+
+Solution
+Content-Disposition parsing fixed.
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.3, and earlier versions
+
+
+Problem
+Clip length not handled properly in resource variables. Ie.  Characters that are translated into entity
+ references are not handled properly when computing clip
+ adjustment.  Incorrect clipping can occur.
+
+
+
+Solution
+Fixed.
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.3, and some possible earlier versions
+
+
+Problem
+MHonArc checking for writable OUTDIR in SINGLE mode.
+
+
+Solution
+Fixed.
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.3, and earlier
+
+
+Problem
+Default resource file not read if located in MHonArc lib directory.
+
+
+
+Solution
+Fixed improper assumption of @INC setting.
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
+2.3.3, and earlier
+
+
+Problem
+TLIEND not generated at proper times when thread level goes beyond TLEVELS.
+
+
+
+Solution
+A check is made in thread index printing to generate a TLIEND properly for TLITXT when deeper than TLEVELS.
+
+
+
+Fixed
+2.4.0
+
+
+
    
+
+
+Version
 2.3.0-2.3.2
 
 
@@ -1486,20 +2301,20 @@ 
    Bug List
    
 
    
 
 
    
-[Prev][Next][TOC][FAQ][Bugs][Home]
+[Prev][Next][TOC][FAQ][Bugs][Home]
 
    
 
 
 
 
    
 
    
-98/11/08 12:24:47
    
+01/06/10 17:47:38
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    
 
    
 
 
diff --git a/doc/app-diagnos.html b/doc/app-diagnos.html
index 3a21a96..82cfceb 100644
--- a/doc/app-diagnos.html
+++ b/doc/app-diagnos.html
@@ -1,13 +1,13 @@
 
 
-MHonArc v2.3 -- Appendix: Diagnostics
+MHonArc v2.4 -- Appendix: Diagnostics
 
 
 
 
 
    
-[Prev][Next][TOC][FAQ][Bugs][Home]
+[Prev][Next][TOC][FAQ][Bugs][Home]
 
    
 
 
@@ -15,21 +15,30 @@
 
 
    Appendix: Diagnostics
    
 
-
    Three types of messages exist in MHonArc:
+
    Three types of messages exist in MHonArc:
 Informative messages, Warnings, and
 Errors. Informative messages give you the
-current status of MHonArc's execution.  Warnings
+current status of MHonArc's execution.  Warnings
 signify undesired conditions, but are not critical in
-MHonArc's exection.  Errors signify critical
-conditions that inhibit MHonArc from finishing its task.  
    
+MHonArc's exection.  Errors signify critical
+conditions that inhibit MHonArc from finishing its task.  
    
 
 
    Another set of messages exists that are generated from the Perl
-interpreter itself.  MHonArc tries its best to catch any
+interpreter itself.  MHonArc tries its best to catch any
 conditions that may cause Perl to abnormally abort, but conditions
 may arise where this is not possible.  
     
    This section describes
-the various diagnostics MHonArc may produce and messages
+the various diagnostics MHonArc may produce and messages
 Perl may produce.  
    
 
+
+
+
+
 
    
 
    Informative messages
    
 
@@ -41,24 +50,44 @@ 
    No new messages
    
 
 
    No new mail messages exist when performing an add operation to an
 archive. This can occur if an empty MH mail folder, or empty
-mailbox file, is passed to MHonArci; or the folder
+mailbox file, is passed to MHonArc; or the folder
 contains messages already in the archive.
 
    
 
 
    Trying to lock mail archive ...
    
 
 
    The statement means that a lock file is in place for the archive
-you are trying to update. Normally, an existing lock file implies
-that another MHonArc process is currently using the archive,
-and other MHonArc processes will wait awhile to see if the
-archive will be unlocked.  
    
-
-
    However, there are times when a lock file exists, but no
-MHonArc process is modifying the archive. This can occur
-if MHonArc is abnormally terminated. If you know that no
-other MHonArc process is editting the archive you are
+you are trying to update.  Normally, an existing lock file implies
+that another MHonArc process is currently using the archive,
+and other MHonArc processes will wait awhile to see if the
+archive will be unlocked.
+The time MHonArc waits can be modified
+by the LOCKTRIES and
+LOCKDELAY resources.
+
    
+
+
    There are times when a lock file exists, but no
+MHonArc process is modifying the archive. This can occur
+if MHonArc is abnormally terminated.  If you know that no
+other MHonArc process is editing the archive you are
 try to modify, then manually remove the lock file or use the
-FORCE resource.  
    
+FORCE resource.
+
    
+
+
+
+
+
+
    WARNING
    If LOCKMETHOD
+is set to flock, then the lock file should never be
+manually deleted.  When MHonArc abnormally terminates, then the
+lock will be automatically released when the flock method
+is used.  A stale lock can still occur under the flock
+method if for some reason a MHonArc
+process hangs.  In this case, just kill the offending process and
+the lock will automatically be released.
+
    
+
    
 
 
    
 
    Warnings
    
@@ -68,7 +97,7 @@ 
    Warnings
    
 
 
    Warning: Could not find date for message
    
 
-
    MHonArc was unable to find a date for a
+
    MHonArc was unable to find a date for a
 mail message, or could not parse the date if the date is not
 in a common format.  The message is given the current date
 if no date is found.
@@ -77,19 +106,19 @@ 
    Warning: Could not find date for message
    
 
    Warning: Database (dbversion)
 != program (prgversion) version
    
 
-
    Indicates that the version of MHonArc updating an archive
-is different from the version of MHonArc that created the
+
    Indicates that the version of MHonArc updating an archive
+is different from the version of MHonArc that created the
 database file. Problems can arise if the database file changes in
-format from different version of MHonArc. See the release
-notes of the MHonArc distribution if changes in the databse
+format from different version of MHonArc. See the release
+notes of the MHonArc distribution if changes in the databse
 format will effect older archives.  
    
 
 
    Warning: Unable to create outdir/dbfile
    
 
-
    Indicates MHonArc was unable to create the
+
    Indicates MHonArc was unable to create the
 database file dbfile for the mail archive
 created/modified in outdir. This message can occur if
-outdir permissions changed during MHonArc
+outdir permissions changed during MHonArc
 execution, the existing dbfile is read-only, or the
 file system is full.  
    
 
@@ -98,43 +127,43 @@ 
    Warning: Unable to create outdir/dbfile
    
 
 
    Warning: Unable to open footer: footer
    
 
-
    MHonArc was unable to open the footer file,
+
    MHonArc was unable to open the footer file,
 footer, for inclusion into the index page. Make sure
 footer exists, and is readable by you.  
    
 
 
    Warning: Unable to open header: header
 
    
 
-
    MHonArc was unable to open the header file,
+
    MHonArc was unable to open the header file,
 header, for inclusion into the index page. Make sure
 header exists, and is readable by you.  
    
 
 
    Warning: Unable to open folder
    
 
-
    MHonArc was unable to open the specified mail
+
    MHonArc was unable to open the specified mail
 folder for reading. Make sure folder
 exists and is readable (and executable if a directory) by you.  
    
 
 
    Warning: Unable to open message: folder/message
 
    
 
-
    MHonArc was unable to open the specified MH
+
    MHonArc was unable to open the specified MH
 mail message folder/message for reading. Make sure
 folder/message exists and is readable by you.  
    
 
 
    Warning: Unable to open resource file: file
 
    
 
-
    MHonArc was unable to open the resource file,
+
    MHonArc was unable to open the resource file,
 file, for reading. Make sure file exists, and
 is readable by you.  
    
 
 
    Warning: Undefined time zone: "timezone"
 
    
 
-
    MHonArc has found an unrecognized timezone
+
    MHonArc has found an unrecognized timezone
 acronym, timezone, in a mail
-message. You can tell MHonArc about other timezone
+message. You can tell MHonArc about other timezone
 acronyms, and their hour offset to UTC, by using the TIMEZONES resource
 
    
@@ -145,11 +174,11 @@ 
    Warning: Undefined time zone: "timezone"
 
    
 
    Errors
    
 
-
    Errors denote conditions that cause MHonArc to abort
+
    Errors denote conditions that cause MHonArc to abort
 execution.  
    
 
-
    Some error conditions may cause the MHonArc archive to
-become corrupted. If the error occurs when MHonArc is writing
+
    Some error conditions may cause the MHonArc archive to
+become corrupted. If the error occurs when MHonArc is writing
 files, you may have to recreate the archive from the original messages.
 
    
 
@@ -161,7 +190,7 @@ 
    ERROR: Database read error of dbfile
    
 
 
    ERROR: Unable to create file
    
 
-
    MHonArc was unable to create file. This
+
    MHonArc was unable to create file. This
 message can occur if the directory being written to is not writable, a
 read-only file with the same name exists, or the file system is full.
 
    
@@ -169,24 +198,44 @@ 
    ERROR: Unable to create file
    
 
    ERROR: Unable to create lockfile after # tries
 
    
 
-
    The statement means that a lock file is in place for the archive
-you are trying to update.  
    
+
    The statement means that MHonArc timed-out trying to obtain a
+lock on the archive.  You may be able to avoid time-out problems
+by modifying the LOCKTRIES and
+LOCKDELAY resources.
+
    
 
-
    Sometimes a lock file exists, but no MHonArc
+
    Sometimes a lock file exists, but no MHonArc
 process is modifying the archive. This can occur if
-MHonArc is abnormally terminated. If you know that no
-other MHonArc process is editting the archive you are
-try to modify, then manually remove the lock file or use the FORCE resource.  
    
+MHonArc is abnormally terminated.  If you know that no
+other MHonArc process is editting the archive you are
+try to modify, then manually remove the lock file or use the
+FORCE resource.
+
    
+
+
+
+
+
+
+
    WARNING
    If LOCKMETHOD
+is set to flock, then the lock file should never be
+manually deleted.  When MHonArc abnormally terminates, then the
+lock will be automatically released when the flock method
+is used.  A stale lock can still occur under the flock
+method if for some reason a MHonArc
+process hangs.  In this case, just kill the offending process and
+the lock will automatically be released.
+
    
+
    
 
 
    ERROR: Unable to open file
    
 
-
    MHonArc was unable to open file for reading. Make
+
    MHonArc was unable to open file for reading. Make
 sure file exists, and is readable by you.  
    
 
 
    ERROR: Unable to require perl-library
    
 
-
    Make sure you properly installed MHonArc.  Also
+
    Make sure you properly installed MHonArc.  Also
 make sure Perl is installed properly if the library is a standard
 Perl library.
 
    
@@ -196,38 +245,38 @@ 
    Perl Messages
    
 
 
    Generally, if execution is aborted and the following error messages
 appear, then you will have to manually delete the lock file since
-MHonArc will not have the chance to delete the file.  
    
+MHonArc will not have the chance to delete the file.  
    
 
 
    Can't locate file in @INC at file line number.
 
    
 
-
    A library that MHonArc tried to load was not found
+
    A library that MHonArc tried to load was not found
 in the Perl include search paths. This error usually implies
-that MHonArc was not installed correctly. Make sure that
-MHonArc was installed via the install.me program
-that is provided in the MHonArc distribution.  
    
+that MHonArc was not installed correctly. Make sure that
+MHonArc was installed via the install.me program
+that is provided in the MHonArc distribution.  
    
 
 
    file did not return a true value at file line number.
    
 
-
    If you are using your own MIME filters with MHonArc, make
-sure the library files return 1.  
    
+
    If you are using your own MIME filters with MHonArc, make
+sure the library files return a true value, like 1.  
    
 
 
    
 
 
    
-[Prev][Next][TOC][FAQ][Bugs][Home]
+[Prev][Next][TOC][FAQ][Bugs][Home]
 
    
 
 
 
    
 
    
-98/10/24 17:31:02
    
+01/06/10 17:47:39
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+Copyright © 1997-2000, Earl Hood, mhonarc@mhonarc.org
    
 
    
 
 
diff --git a/doc/app-mimeconf.html b/doc/app-mimeconf.html
new file mode 100644
index 0000000..35b330f
--- /dev/null
+++ b/doc/app-mimeconf.html
@@ -0,0 +1,545 @@
+
+
+
+MHonArc v2.4 -- Appendix: MIME Conformance
+
+
+
+
+
+
    
+[Prev][Next][TOC][FAQ][Bugs][Home]
+
    
+
+
    
+
+
    Appendix: MIME Conformance
    
+
+
    This appendix describes how well MHonArc implements
+MIME-conformance as defined in
+
+RFC 2049: (MIME) Part Five: Conformance Criteria and Examples.
+Also, additional MIME-related features are summarized.
+
    
+
+
+
+
+
+
    
+
    MIME-Conformance
    
+
+
    MIME-conformance is defined in section 2 of
+
+RFC 2049: (MIME) Part Five: Conformance Criteria and Examples.
+Following is the text extracted from section 2 of RFC 2049 with
+annotations added on how MHonArc conforms to each criteria listed.
+It should be noted that the criteria listed in RFC 2049 is geared
+towards interactive MUAs; therefore, some criteria may not be
+applicable to MHonArc.
+
    
+
+
+
+
+
+
    NOTE
    All notes about conformance is based upon the default MIME-related
+resource settings:
+MIMEFILTERS, 
+CHARSETCONVERTERS, 
+MIMEARGS 
+
    
+
    
+
+
      
+
    1. 
+Always generate a "MIME-Version: 1.0" header field in
+          any message it creates.
+
      
+
+
+
+
+
+
      MHonArc
      Not applicable.
+
      
+
      
+
      
+
      2. 
+
    2. 
+Recognize the Content-Transfer-Encoding header field
+          and decode all received data encoded by either quoted-printable or base64 implementations.  The identity
+          transformations 7bit, 8bit, and binary must also be
+          recognized.
+
      
+
+
+
+
+
+
      MHonArc
      Base64, quoted-printable, 7bit, 8bit, and binary are supported.
+Also, uuencode is supported: uuencode, x-uuencode, and
+x-uue.
+
      
+
      
+
      
+
      
+          Any non-7bit data that is sent without encoding must be
+          properly labelled with a content-transfer-encoding of
+          8bit or binary, as appropriate.  If the underlying
+          transport does not support 8bit or binary (as SMTP
+          [RFC-821] does not), the sender is required to both
+          encode and label data using an appropriate Content-Transfer-Encoding such as quoted-printable or base64.
+
      
+
+
+
+
+
+
      MHonArc
      Not applicable.
+
      
+
      
+
      
+
      3. 
+
    3. 
+Must treat any unrecognized Content-Transfer-Encoding
+          as if it had a Content-Type of "application/octet-stream", regardless of whether or not the actual
+          Content-Type is recognized.
+
      
+
+
+
+
+
+
      MHonArc
      Currently, MHonArc will still call the registered
+content-type filter for the specified
+Content-Type, but the $isdecoded will be set to a false
+value.  With the default set of filters, the $isdecoded
+flag is ignored.  Therefore, behavior could be considered undefined when
+MHonArc process a message with an unrecognized Content-Transfer-Encoding.
+
      
+
      
+
      
+
      4. 
+
    4. 
+Recognize and interpret the Content-Type header field,
+          and avoid showing users raw data with a Content-Type
+          field other than text.  Implementations  must be able
+          to send at least text/plain messages, with the
+          character set specified with the charset parameter if
+          it is not US-ASCII.
+
      
+
+
+
+
+
+
      MHonArc
      MHonArc conforms to the first sentence of the paragraph
+The second sentence is not applicable.
+
      
+
      
+
      
+
      5. 
+
    5. 
+Ignore any content type parameters whose names they do
+          not recognize.
+
      
+
+
+
+
+
+
      MHonArc
      Yes.
+
      
+
      
+
      
+
      6. 
+
    6. 
+Explicitly handle the following media type values, to
+          at least the following extents:
+
      
+
      
+          Text:
+
      
+
        
+
      • Recognize and display "text" mail with the
+            character set "US-ASCII."
+
        
+
+
+
+
+
+
        MHonArc
        Yes.
+
        
+
        
+
        
+
      • Recognize other character sets at least to the
+            extent of being able to inform the user about what
+            character set the message uses.
+
        
+
+
+
+
+
+
        MHonArc
        Not really applicable.  Warnings are generated during processing
+if a character set is encountered that is not recognized.
+
        
+
        
+
        
+
      • Recognize the "ISO-8859-*" character sets to the
+            extent of being able to display those characters that
+            are common to ISO-8859-* and US-ASCII, namely all
+            characters represented by octet values 1-127.
+
        
+
+
+
+
+
+
        MHonArc
        Yes.
+
        
+
        
+
        
+
      • For unrecognized subtypes in a known character
+            set, show or offer to show the user the "raw" version
+            of the data after conversion of the content from
+            canonical form to local form.
+
        
+
+
+
+
+
+
        MHonArc
        MHonArc will treat the data as text/plain and convert.
+
        
+
        
+
        
+
      • Treat material in an unknown character set as if
+            it were "application/octet-stream".
+
        
+
+
+
+
+
+
        MHonArc
        No.  A warning is generated for unknown character sets.  The
+data will be shown in raw form, with HTML special characters converted
+to entity references.  This behavior is the default because some MUAs
+are known to give incorrect charset parameters.
+
        
+
        
+
        
+
      
+
      
+  Image, audio, and video:
+
      
+
        
+    
      • At a minumum provide facilities to treat any
+    unrecognized subtypes as if they were
+    "application/octet-stream".
+
        
+
+
+
+
+
+
        MHonArc
        All image, audio, and video types are saved to an external file
+with a link to the file created in the HTML.  For applicable image types, they
+are inlined unless the image has an attachment content-disposition.
+
        
+
        
+
        
+
      
+
      
+  Application:
+
      
+
        
+    
      • Offer the ability to remove either of the quoted-printable or base64 encodings defined in this
+    document if they were used and put the resulting
+    information in a user file.
+
        
+
+
+
+
+
+
        MHonArc
        Most application types are decoded and saved to an external file
+with a link to the file created in the HTML.  Some application types
+can be converted directly to HTML.
+
        
+
        
+
      
+
      
+  Multipart:
+
      
+
        
+    
      • Recognize the mixed subtype.  Display all relevant
+    information on the message level and the body part
+    header level and then display or offer to display
+    each of the body parts individually.
+
        
+
+
+
+
+
+
        MHonArc
        Yes.  Each part is automatically processed according to its
+media-type.
+
        
+
        
+
        
+    
      • Recognize the "alternative" subtype, and avoid
+    showing the user redundant parts of
+    multipart/alternative mail.
+
        
+
+
+
+
+
+
        MHonArc
        Yes.
+
        
+
        
+
        
+    
      • Recognize the "multipart/digest" subtype,
+    specifically using "message/rfc822" rather than
+    "text/plain" as the default media type for body parts
+    inside "multipart/digest" entities.
+
        
+
+
+
+
+
+
        MHonArc
        Yes.
+
        
+
        
+
        
+    
      • Treat any unrecognized subtypes as if they were
+    "mixed".
+
        
+
+
+
+
+
+
        MHonArc
        Yes.
+
        
+
        
+
        
+
      
+
      
+  Message:
+
      
+
        
+    
      • Recognize and display at least the RFC822 message
+    encapsulation (message/rfc822) in such a way as to
+    preserve any recursive structure, that is, displaying
+    or offering to display the encapsulated data in
+    accordance with its media type.
+
        
+
+
+
+
+
+
        MHonArc
        Yes.
+
        
+
        
+
        
+    
      • Treat any unrecognized subtypes as if they were
+    "application/octet-stream".
+
        
+
+
+
+
+
+
        MHonArc
        Yes.
+
        
+
        
+
        
+
      
+
    7. Upon encountering any unrecognized Content-Type field,
+          an implementation must treat it as if it had a media
+          type of "application/octet-stream" with no parameter
+          sub-arguments.  How such data are handled is up to an
+          implementation, but likely options for handling such
+          unrecognized data include offering the user to write it
+          into a file (decoded from its mail transport format) or
+          offering the user to name a program to which the
+          decoded data should be passed as input.
+
      
+
+
+
+
+
+
      MHonArc
      Yes.  The data is passed to the
+m2h_external::filter
+to be saved to an external file.
+
      
+
      
+
      
+
    8. Conformant user agents are required, if they provide
+        non-standard support for non-MIME messages employing
+        character sets other than US-ASCII, to do so on
+        received messages only. Conforming user agents must not
+        send non-MIME messages containing anything other than
+        US-ASCII text.
+
      
+
      In particular, the use of non-US-ASCII text in mail
+        messages without a MIME-Version field is strongly
+        discouraged as it impedes interoperability when sending
+        messages between regions with different localization
+        conventions. Conforming user agents MUST include proper
+        MIME labelling when sending anything other than plain
+        text in the US-ASCII character set.
+
      
+
+
+
+
+
+
      MHonArc
      The
+m2h_text_plain::filter
+supports an option to specify what character set to use if no character
+set is specified.  By default, ISO-8859-1 is assumed.
+
      
+
      
+
      
+
      In addition, non-MIME user agents should be upgraded if
+        at all possible to include appropriate MIME header
+        information in the messages they send even if nothing
+        else in MIME is supported.  This upgrade will have
+        little, if any, effect on non-MIME recipients and will
+        aid MIME in correctly displaying such messages.  It
+        also provides a smooth transition path to eventual
+        adoption of other MIME capabilities.
+
      
+
+
+
+
+
+
      MHonArc
      Not applicable.
+
      
+
      
+
      
+
    9. Conforming user agents must ensure that any string of
+        non-white-space printable US-ASCII characters within a
+        "*text" or "*ctext" that begins with "=?" and ends with
+        "?=" be a valid encoded-word.  ("begins" means: At the
+        start of the field-body or immediately following
+        linear-white-space; "ends" means: At the end of the
+        field-body or immediately preceding linear-white-space.) In addition, any "word" within a "phrase" that
+        begins with "=?" and ends with "?=" must be a valid
+        encoded-word.
+
      
+
+
+
+
+
+
      MHonArc
      Yes.
+
      
+
      
+
      
+
    10. Conforming user agents must be able to distinguish
+        encoded-words from "text", "ctext", or "word"s,
+        according to the rules in section 4, anytime they
+        appear in appropriate places in message headers.  It
+        must support both the "B" and "Q" encodings for any
+        character set which it supports.  The program must be
+        able to display the unencoded text if the character set
+        is "US-ASCII".  For the ISO-8859-* character sets, the
+        mail reading program must at least be able to display
+        the characters which are also in the US-ASCII set.
+
      
+
+
+
+
+
+
      MHonArc
      MHonArc supports non-ASCII encoding of text in message headers,
+including the "B" and "Q" encodings.  By default, US-ASCII,
+ISO-8859-[1-10], and ISO-2022-JP are supported.  For encoded
+words with an unrecognized character set, the word is left in
+encoded form.  Additional character set support can be added via the
+CHARSETCONVERTERS resource.
+
      
+
      
+
      
+
    
+
+
+
    
+
    Other Stuff Supported
    
+
+
    The following lists other MIME-related features supported
+by MHonArc:
    
+
+
      
+
+
    • Support for uuencoding as a Content-Transfer-Encoding.
+
      
+
      • 
+
+
    • Support for many media-types (including the ability to extend
+that support).  For a complete list, along with more
+information, see the
+MIMEFILTERS resource.
+Note, many media-types cannot be directly converted into HTML.  For
+these types, they are saved to a separate file with a link to the
+file inserted in the converted HTML message data.
+
      
+
      • 
+
+
    • Support for multipart/related by allowing
+filters to access other
+message parts via content-ids.
+
      
+
      • 
+
+
    • Support for cid: URLs in text/html
+data.  The provides support for things like MHTML:
+MIME E-mail Encapsulation of Aggregate Documents,
+RFC 2110.
+
      
+
      • 
+
+
    • Support for
+RFC 2369,
+The Use of URLs as Meta-Syntax for Core Mail List Commands
+and their Transport through Message Header Fields.  The
+URLs in list header fields will be converted into hypertext links.
+
      
+
      • 
+
+
    
+
+
    
+
+
    
+[Prev][Next][TOC][FAQ][Bugs][Home]
+
    
+
+
+
    
+
    
+01/06/10 17:47:39
    
+
+MHonArc
    
+Copyright © 1999, Earl Hood, mhonarc@mhonarc.org
    
+
    
+
+
+
diff --git a/doc/app-rcfileexs.html b/doc/app-rcfileexs.html
new file mode 100644
index 0000000..bc8ea08
--- /dev/null
+++ b/doc/app-rcfileexs.html
@@ -0,0 +1,66 @@
+
+
+
+MHonArc v2.4 -- Appendix: Resource File Examples
+
+
+
+
    
+[Prev][Next][TOC][FAQ][Bugs][Home]
+
    
+
+
    
+
+
    Appendix: Resource File Examples
    
+
+
    This appendix provides several
+resource file examples.
+
    
+
+
+
      
+
    
+
+
+
    
+
    Day Grouping
    
+
    This resource file utilizes the day grouping feature of MHonArc
+to format the main index.
+
    
+
    Default MIME Settings
    
+
    Default resource settings related to MIME processing.
+
    
+
    Frame Navigation
    
+
    This is an example of using HTML frames for archive navigation.
+
    
+
    Icons
    
+
    This example file makes use of the icons feature.
+
    
+
    Subject Grouping
    
+
    This resource file utilizes the subject grouping feature of MHonArc
+to format the main index.
+
    
+
    
+
+
+
    
+
+
    
+[Prev][Next][TOC][FAQ][Bugs][Home]
+
    
+
+
+
+
    
+
    
+01/06/10 17:47:40
    
+
+MHonArc
    
+Copyright © 1999, Earl Hood, mhonarc@mhonarc.org
    
+
    
+
+
+
diff --git a/doc/app-rcidx.html b/doc/app-rcidx.html
new file mode 100644
index 0000000..44aa088
--- /dev/null
+++ b/doc/app-rcidx.html
@@ -0,0 +1,425 @@
+
+
+
+MHonArc v2.4 -- Appendix: Resource Indexes
+
+
+
+
    
+[Prev][Next][TOC][FAQ][Bugs][Home]
+
    
+
+
    
+
+
    Appendix: Resource Indexes
    
+
+
    This appendix list
+resources
+by envariables, resource file elements,
+and command-line options.
+
    
+
+
+
+
+
+
+
    
+
    Environment Variables
    
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
    EnvariableDescription
    M2H_ADDRESSMODIFYCODE Perl expressions modifying displayed addresses in headers.
    M2H_AFS Skip archive directory permission check.
    M2H_ANNOTATE Add/set annotation for message(s).
    M2H_ARCHIVE Create archive.
    M2H_AUTHSORT Sort main index by author.
    M2H_CHECKNOARCHIVE Honor "no archive" flag in messages.
    M2H_CONLEN Use Content-Length value.
    M2H_DATEFIELDS List of fields to extract date of message.
    M2H_DBFILE Name of archive database file.
    M2H_DECODEHEADS Store "decode-only" characters sets in raw form.
    M2H_DEFRCFILE Pathname of default resource file.
    M2H_DEFRCNAME Name of default resource file.
    M2H_DOC Add link to documentation.
    M2H_DOCURL URL to documentation
    M2H_EXPIREAGE Length of time to keep a message in an archive.
    M2H_EXPIREDATE Expiration of date of message.
    M2H_FOLREFS Print links links to explicit follow-ups and references.
    M2H_FOOTER File to include at the foot of main index pages.
    M2H_FROMFIELDS List of fields to extract author of a message.
    M2H_GMTDATEFMT Conversion specification for GMT dates.
    M2H_GZIPEXE Pathname to gzip executable.
    M2H_GZIPFILES Gzip files.
    M2H_GZIPLINKS Assume files are gzipped when creating links.
    M2H_HEADER File to include at the top of main index pages.
    M2H_HTMLEXT Extension to use for HTML files.
    M2H_IDXFNAME Filename for main (first) index page.
    M2H_IDXPREFIX Filename prefix for multi-page main index.
    M2H_IDXSIZE Size of each index page.
    M2H_LOCALDATEFMT Conversion specification for printing local date.
    M2H_LOCKDELAY Wait time between lock attempts.
    M2H_LOCKFILE Name of the lock file.
    M2H_LOCKMETHOD How archive locks are done.
    M2H_LOCKTRIES Total number of time to attempt a lock before failing.
    M2H_MAILTO Convert email addresses in message headers to hyperlinks.
    M2H_MAILTOURL URL template to use when MAILTO is set.
    M2H_MAIN Create main index.
    M2H_MAXSIZE Maximum number of messages in an archive.
    M2H_MHPATTERN Regex for matching message files in an MH folder (directory).
    M2H_MODTIME Set modification time on message files to message dates.
    M2H_MONTHS Month names.
    M2H_MONTHSABR Abbreviated month names.
    M2H_MSGEXCFILTER Perl expression(s) to selectively exclude messages.
    M2H_MSGGMTDATEFMT GMT conversion specification for message dates.
    M2H_MSGLOCALDATEFMT Local conversion specification for message dates.
    M2H_MSGPGS Print message pages.
    M2H_MSGPREFIX Prefix for message page filenames.
    M2H_MSGSEP Regex for matching message separator in mailbox files.
    M2H_MULTIPG Create multi-page indexes.
    M2H_NEWS Hyperlink newsgroups in message headers.
    M2H_NOTEDIR Directory to store annotations.
    M2H_OTHERINDEXES List of alternate indexes to create for an archive.
    M2H_OUTDIR Location of archive.
    M2H_PERLINC Additional Perl include paths.
    M2H_POSIXSTRFTIME Use POSIX's strftime() for converted time format strings.
    M2H_RCFILE Resource file to read before processing input.
    M2H_REVERSE Reverse the listing order in the main index.
    M2H_SAVERESOURCES Save resource values in database.
    M2H_SORT List messages by date in main index.
    M2H_SPAMMODE Perform actions to deter email address harvesters.
    M2H_SUBJECTARTICLERXP Regex for matching leading articles in message subjects.
    M2H_SUBJECTREPLYRXP Regex for matching subject text denoting a reply message.
    M2H_SUBJECTSTRIPCODE Perl expressions to strip subject text while reading messages.
    M2H_SUBJECTTHREADS Check subjects when computing message threads.
    M2H_SUBSORT List messages by subjext in main index.
    M2H_THREAD Create thread index.
    M2H_TIDXFNAME Filename of first thread index page.
    M2H_TIDXPREFIX Filename prefix for thread index pages beyond the first page.
    M2H_TITLE Title for main index.
    M2H_TLEVELS Maximum number of levels to indent in thread index.
    M2H_TREVERSE List thread in reverse order.
    M2H_TSLICE Size of thread listing slice for message pages.
    M2H_TSORT List threads by date.
    M2H_TSUBSORT List threads by subject.
    M2H_TTITLE Title of thread index.
    M2H_UMASK Umask value for the MHonArc process.
    M2H_USELOCALTIME Use local time to determine day groups in main index listing.
    M2H_USINGLASTPG $LASTPG$ is used in resource values.
    M2H_VARREGEX Perl regular expression matching a resource variable.
    M2H_WEEKDAYS Weekday names.
    M2H_WEEKDAYSABR Abbreviated weekday names.
    
+
+
+
+
    
+
    Resource Elements
    
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
    ElementDescription
    <ADDRESSMODIFYCODE> Perl expressions modifying displayed addresses in headers.
    <AUTHORBEGIN> Markup at the start of a author group.
    <AUTHOREND> Markup at the end of a author group.
    <AUTHSORT>
    <NOAUTHSORT>    		 Sort main index by author.
    <BOTLINKS> Links markup at the bottom of message pages.
    <CHARSETCONVERTERS> Charater set filter functions.
    <CHECKNOARCHIVE>
    <NOCHECKNOARCHIVE>    		 Honor "no archive" flag in messages.
    <CONLEN>
    <NOCONLEN>    		 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>
    <NODECODEHEADS>    		 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.
    <DOC>
    <NODOC>    		 Add link to documentation.
    <DOCURL> URL to documentation
    <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>
    <NOFOLREFS>    		 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.
    <FROMFIELDS> List of fields to extract author of a message.
    <GMTDATEFMT> Conversion specification for GMT dates.
    <GZIPEXE> Pathname to gzip executable.
    <GZIPFILES>
    <NOGZIPFILES>    		 Gzip files.
    <GZIPLINKS>
    <NOGZIPLINKS>    		 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.
    <LOCKMETHOD> How archive locks are done.
    <MAILTO>
    <NOMAILTO>    		 Convert email addresses in message headers to hyperlinks.
    <MAILTOURL> URL template to use when MAILTO is set.
    <MAIN>
    <NOMAIN>    		 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.
    <MIMEDECODERS> Content-Transfer-Encoding decoding functions.
    <MIMEEXCS> Content-types to exclude.
    <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.
    <MSGEXCFILTER> Perl expression(s) to selectively exclude messages.
    <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>
    <NOMSGPGS>    		 Print message pages.
    <MSGPREFIX> Prefix for message page filenames.
    <MSGSEP> Regex for matching message separator in mailbox files.
    <MULTIPG> Create multi-page indexes.
    <NEWS>
    <NONEWS>    		 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.
    <OTHERINDEXES> List of alternate indexes to create for an archive.
    <PERLINC> Additional Perl include paths.
    <POSIXSTRFTIME> Use POSIX's strftime() for converted time format strings.
    <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.
    <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>
    <NOREVERSE>    		 Reverse the listing order in the main index.
    <SAVERESOURCES>
    <NOSAVERESOURCES>    		 Save resource values in database.
    <SORT>
    <NOSORT>    		 List messages by date in main index.
    <SPAMMODE>
    <NOSPAMMODE>    		 Perform actions to deter email address harvesters.
    <SSMARKUP> Markup at the beginning of all generated pages.
    <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.
    <SUBJECTTHREADS>
    <NOSUBJECTTHREADS>    		 Check subjects when computing message threads.
    <SUBSORT>
    <NOSUBSORT>    		 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>
    <NOTHREAD>    		 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>
    <NOTREVERSE>    		 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>
    <NOTSORT>    		 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>
    <NOTSUBSORT>    		 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>
    <NOUSELOCALTIME>    		 Use local time to determine day groups in main index listing.
    <USINGLASTPG>
    <NOUSINGLASTPG>    		 $LASTPG$ is used in resource values.
    <WEEKDAYS> Weekday names.
    <WEEKDAYSABR> Abbreviated weekday names.
    
+
+
+
+
    
+
    Command-Line Options
    
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
    OptionDescription
    -add Add messages to the archive.
    -addressmodifycode Perl expressions modifying displayed addresses in headers.
    -afs Skip archive directory permission check.
    -annotate Add/set annotation for message(s).
    -archive
    -noarchive    		 Create archive.
    -authsort
    -noauthsort    		 Sort main index by author.
    -checknoarchive
    -nochecknoarchive    		 Honor "no archive" flag in messages.
    -conlen
    -noconlen    		 Use Content-Length value.
    -datefields List of fields to extract date of message.
    -dbfile Name of archive database file.
    -decodeheads
    -nodecodeheads    		 Store "decode-only" characters sets in raw form.
    -definevar Define a custom resource variable.
    -doc
    -nodoc    		 Add link to documentation.
    -docurl URL to documentation
    -editidx Modify archive with new resource settings.
    -expireage Length of time to keep a message in an archive.
    -expiredate Expiration of date of message.
    -folrefs
    -nofolrefs    		 Print links links to explicit follow-ups and references.
    -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
    -nogzipfiles    		 Gzip files.
    -gziplinks
    -nogziplinks    		 Assume files are gzipped when creating links.
    -header File to include at the top of main index pages.
    -htmlext Extension to use for HTML files.
    -idxfname Filename for main (first) index page.
    -idxprefix Filename prefix for multi-page main index.
    -idxsize Size of each index page.
    -keeponrmm Do not physically delete message files when message removed from archive.
    -localdatefmt Conversion specification for printing local date.
    -lock
    -nolock    		 Perform a lock on the archive.
    -lockdelay Wait time between lock attempts.
    -lockfile Name of the lock file.
    -lockmethod How archive locks are done.
    -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).
    -modtime Set modification time on message files to message dates.
    -months Month names.
    -monthsabr Abbreviated month names.
    -msgexcfilter Perl expression(s) to selectively exclude messages.
    -msggmtdatefmt GMT conversion specification for message dates.
    -msglocaldatefmt Local conversion specification for message dates.
    -msgpgs
    -nomsgpgs    		 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.
    -notedir Directory to store annotations.
    -notetext Annotation text.
    -otherindexes List of alternate indexes to create for an archive.
    -outdir Location of archive.
    -perlinc Additional Perl include paths.
    -posixstrftime Use POSIX's strftime() for converted time format strings.
    -quiet Do not output status.
    -rcfile Resource file to read before processing input.
    -reverse Reverse the listing order in the main index.
    -rmm Remove specified messages from an archive.
    -saveresources
    -nosaveresources    		 Save resource values in database.
    -scan List archive messages to standard output.
    -single Process a single message.
    -sort List messages by date in main index.
    -spammode
    -nospammode    		 Perform actions to deter email address harvesters.
    -stderr File for standard error messages.
    -stdin File to treat as standard input.
    -stdout File for standard output messages.
    -subjectarticlerxp Regex for matching leading articles in message subjects.
    -subjectreplyrxp Regex for matching subject text denoting a reply message.
    -subjectstripcode Perl expressions to strip subject text while reading messages.
    -subjectthreads
    -nosubjectthreads    		 Check subjects when computing message threads.
    -subsort List messages by subjext in main index.
    -thread Create thread index.
    -tidxfname Filename of first thread index page.
    -tidxprefix Filename prefix for thread index pages beyond the first page.
    -title Title for main index.
    -tlevels Maximum number of levels to indent in thread index.
    -treverse List thread in reverse order.
    -tslice Size of thread listing slice for message pages.
    -tsort
    -notsort    		 List threads by date.
    -tsubsort
    -notsubsort    		 List threads by subject.
    -ttitle Title of thread index.
    -umask Umask value for the MHonArc process.
    -varregex Perl regular expression matching a resource variable.
    -weekdays Weekday names.
    -weekdaysabr Abbreviated weekday names.
    
+
+
+
+
+
    
+
+
    
+[Prev][Next][TOC][FAQ][Bugs][Home]
+
    
+
+
+
+
    
+
    
+01/06/10 17:47:40
    
+
+MHonArc
    
+Copyright © 1999, Earl Hood, mhonarc@mhonarc.org
    
+
    
+
+
+
diff --git a/doc/app-utilsprg.html b/doc/app-utilsprg.html
index 7ce8383..05d33ce 100644
--- a/doc/app-utilsprg.html
+++ b/doc/app-utilsprg.html
@@ -1,7 +1,7 @@
 
 
 
-MHonArc v2.3 -- Appendix: Utility Programs
+<TITLE>MHonArc v2.4 -- Appendix: Utility Programs
 
 
 
 
    
-[Prev][Next][TOC][FAQ][Bugs][Home]
+[Prev][Next][TOC][FAQ][Bugs][Home]
 
    
 
 
    
 
 
    Appendix: Utility Programs
    
 
-
    This appendix describes the adiitional utility programs that
+
    This appendix describes the additional utility programs that
 are included in the MHonArc distribution.  The utility programs
 are installed with mhonarc during the installation process.
 
    
 
+
+
+
+
 
    
 
    mha-dbedit
    
 
@@ -31,7 +39,7 @@ 
    mha-dbedit
    
 
    Typical usage:
 
    
 
    -    % mha-dbedit -rcfile res.mrc -outdir /path/to/archive
+    shell> mha-dbedit -rcfile res.mrc -outdir /path/to/archive
 
    
 
 
    
@@ -45,17 +53,17 @@ 
    mha-dbrecover
    
 
    Typical usage:
 
    
 
    -    % mha-dbrecover -outdir /path/to/archive
+    shell> mha-dbrecover -outdir /path/to/archive
 
    
 
 
    If the archive used different resource settings from the defaults
 for controling filenames, then you must specify those settings when
 invoking mha-dbrecover.  For example, if you are using
-"shtml" for HTMLEXT, then you should invoke mha-dbrecover
-like as follows:
+"shtml" for HTMLEXT,
+then you should invoke mha-dbrecover like the following:
 
    
 
    -    % mha-dbrecover -htmlext shtml -outdir /path/to/archive
+    shell> mha-dbrecover -htmlext shtml -outdir /path/to/archive
 
    
 
 
    mha-dbrecover will only recreate non-layout message related data.
@@ -64,26 +72,74 @@ 
    mha-dbrecover
    
 invoking mha-dbrecover.  For example:
 
    
 
    -    % mha-dbrecover -rcfile res.mrc -outdir /path/to/archive
+    shell> mha-dbrecover -rcfile res.mrc -outdir /path/to/archive
 
    
 
+
    
+
    mha-decode
    
+
+
    mha-decode is a utility program unrelated to MHonArc archives.
+mha-decode provides basic MIME decoding capabilites for
+messages.
+
    
+
    If given mail folders as input, all messages within in the mail
+folders will be decoded.  All message parts are written to files.  If a
+filename is specified for a message part, that filename will be used
+when writing the part to a file.  If no filename is specified in the
+message, a unique name will be used based upon the content-type of
+the message part.
+
    
+
    A single message can be decoded by using the -single option.
+
    
+
+Only MHonArc options that affect parsing of mail folders are applicable
+for mha-decode.  The following options are applicable:
+-conlen,
+-mhpattern,
+-msgsep,
+-noconlen,
+-outdir,
+-perlinc,
+-rcfile,
+-single,
+-umask.
+
+
    Example usage:
+
    
+
    +    shell> mha-decode inbox
+
    
+
    Use -outdir to have all decoded data placed into a
+separate directory:
+
    
+
    +    shell> mha-decode -outdir /var/tmp inbox
+
    
+
    And to decode a single message:
    
+
    +    shell> mha-decode -single msg.822
+
    
+
    or from standard input:
    
+
    +    shell> some_program | mha-decode -single
+
    
 
 
    
 
 
    
-[Prev][Next][TOC][FAQ][Bugs][Home]
+[Prev][Next][TOC][FAQ][Bugs][Home]
 
    
 
 
 
    
 
    
-98/10/24 17:31:02
    
+01/06/10 17:47:40
    
 
-MHonArc
    
-Copyright © 1998, Earl Hood, earlhood@usa.net
    
+Copyright © 1998-1999, Earl Hood, mhonarc@mhonarc.org
    
 
    
 
 
diff --git a/doc/commontasks.html b/doc/commontasks.html
new file mode 100644
index 0000000..a2fe08a
--- /dev/null
+++ b/doc/commontasks.html
@@ -0,0 +1,252 @@
+
+
+
+MHonArc v2.4 -- Common Tasks
+
+
+
+
+
    
+[Prev][Next][TOC][FAQ][Bugs][Home]
+
    
+
+
+
+
    
+
    Common Tasks
    
+
+
    The following section describes how to perform some common tasks with
+MHonArc archives beyond those mentioned in
+Quick Start.  To get a complete picture
+of what you can do with MHonArc, see the section
+on Resources.
+
    
+
+
+
+
+
+
+
    
+
    Setting the Index Title
    
+
+
    If you read the Quick Start
+section and ran MHonArc on some of your mail, 
+you have may have noticed that the titles of the main (date)
+and thread index pages are not very descriptive: "Mail Index"
+and "Mail Thread Index".  It would be much nicer if the the
+titles reflect what type of mail is in the archive.  For example,
+if the archive contains messages from a mailing list, the name
+of the list should probably be in the title.
+
    
+
    MHonArc allows you to change the titles via the
+-title and
+-ttitle options.
+The -title option sets
+main index title, and the
+-ttitle option sets
+the thread index title.  Example:
+
    
+
    +    shell> mhonarc -title "The Widget List Archive" \
+                   -ttitle "The Widget List Thread Archive" ...
+
    
+
+
+
    
+
    Changing Index Listing Order
    
+
+
    By default, messages get listed in chronological order on
+the main/non-thread and thread index pages.
+
    
+
+
+
+
+
+
    NOTE
    The chronological order in the thread index is based on
+the root messages of each thread.
+
    
+
    
+
    For many, the default listing order is
+not what is desired.  A common desire is to have
+messages in the main index listed in reverse chronological order;
+ie. the most recent messages are listed first while the oldest
+are listed last.  Or, one may want to list messages by author
+since the target audience is more interested in looking up messages
+by certain authors than by date.
+
    
+
    Following is the list options available for changing the
+listing order on index pages:
+
    
+
+
+
+
+
+
+
+
+
+
+
+
+
    Option Description
    -authsort Sort main index by author.
    -reverse Reverse the listing order in the main index.
    -sort List messages by date in main index.
    -subsort List messages by subjext in main index.
    -treverse List thread in reverse order.
    -tsort List threads by date.
    -tsubsort List threads by subject.
    
+
+
    For example, to get a reverse chronological listing,
+do something like the following:
+
    
+
    +    shell> mhonarc -sort -reverse ...
+
    
+
+
+
    
+
    Removing Messages
    
+
+
    There are two ways to delete messages from an archive:
+automatic and manual.
+
    
+
+
    Automatic Removal
    
+
+
    MHonArc supports the ability to automatically remove archive messages
+that are older than a specified time period, are older than
+a specified date/time, or the number of messages have reached the maximum
+number specified.
+
    
+
+
    For example, if you want an archive to only
+contain messages that are less than a month, you can do something
+like the following:
+
    
+
    +    shell> mhonarc -expireage 2635200 -add -outdir /path/to/archive mailbox
+
    
+
    Here, we used the -expireage
+option
+to tell MHonArc to remove messages older than 2635200 seconds (30.5 days) when
+adding new messages.
+I know, having to use seconds to specify the expiration age seems cumbersome.
+A table is provided in the EXPIREAGE
+reference page listing common time periods to their equivalence in seconds.
+
    
+
+
    A less used option that will cause automatic deletion is the
+-expiredate option.
+This allows
+you to specify an exact date/time where any messages older than the
+given date/time, will be automatically removed.  For example:
+
    
+
    +    shell> mhonarc -expiredate "1 Jan 1999 00:00:00" -add -outdir /path/to/archive mailbox
+
    
+
    In this example, before MHonArc adds any new messages, it will delete
+any messages with a date earlier than January 1, 1999.  See the
+EXPIREDATE reference page for
+more information and for the correct expiration date syntax.
+
    
+
+
    An archive can also have a maximum number of messages limit.
+When the maximum number is reached, the oldest messages are automatically
+removed.  The following is an example of setting the maximum size
+of an archive:
+
    
+
    +    shell> mhonarc -maxsize 500 -add -outdir /path/to/archive mailbox
+
    
+
+
    Manual Removal
    
+
+
    Sometimes it becomes necessary to remove specific messages from archive.
+For example, their may be some spam messages and you do not want them
+cluttering your archive (and providing free advertising).  Or, there
+may be archived messages that you believe are not appropriate for
+the archive's intended audience.
+
    
+
    To remove specific messages, use the
+-rmm option.  For example:
+
    
+
    +    shell> mhonarc -rmm 24 28 39 48
+
    
+
    will delete messages 24, 28, 39, and 48.
+
    
+
    You are now asking, "How do I know what a message's number is?".  One
+way is to look at the number in the message's filename.  I.e.  Each
+converted message is writting to a filename containing the number of
+message.  For example, msg00024.html,
+msg00028.html, msg00039.html, and msg00048.html
+denote messages 24, 28, 39, and 48.
+
    
+
    Checking filenames can be awkward, so one alternative is to use
+the -scan option.  For example:
+
    
+
    +    shell> mhonarc -scan -outdir /home/ehood/html/archive
+    Reading database ...
+    117 messages in /home/ehood/html/archive:
+     
+    Msg #  YYYY/MM/DD  From             Subject                                    
+    -----  ----------  ---------------  -------------------------------------------
+       62  1996/07/30  Kwin Kramer      Reading STDIN not from keyboard -- or, Syst
+       23  1996/07/31  Christopher M.   Re: Setting @INC to include my own modules 
+	9  1996/08/01  Dan Kirkwood     object as hash key loses methods           
+	2  1996/08/01  James F'jord Ly  Re: We're HIRING hot hackers!              
+	1  1996/08/01  Christopher Cha  Curious Multi-Dimensional array behavior   
+       14  1996/08/01  I R A Aggie      Re: Patch for arithmetic bug in 5.003 ?    
+	3  1996/08/01  Bernard Bellon   Re: How do you grab a URL in perl?         
+       38  1996/08/01  Mohammed Dewan   Help needed badly win3.1 and perl.         
+       59  1996/08/01  Mohammed Dewan   Using file in perl.                        
+	4  1996/08/01  Dan Gildor       Re: Threaded Discusion groups embeded in We
+	5  1996/08/01  kendall shaw     addicted to emacs lisp                     
+	6  1996/08/01  Ye He            Q: Sybase extension to Perl                
+       83  1996/08/01  I R A Aggie      Re: Browser/Page matching CGI script       
+	7  1996/08/01  Chris Schleiche  Re: Simple program looks good, but gives er
+       13  1996/08/01  Steve McCullagh  Perl 5.002 and $| errors                   
+    ...
+
    
+
+
    With -scan, you can get a listing
+of an archive to your terminal.  The listing can be used to determine
+the message number for a message if you know the message's subject and
+author.
+
    
+
+
    The -rmm also supports
+the ability to specify message number ranges and message-ids.  See
+the RMM reference page for
+more information and examples.
+
    
+
+
+
+
    
+
+
    
+[Prev][Next][TOC][FAQ][Bugs][Home]
+
    
+
+
+
+
    
+
    
+01/06/10 17:47:40
    
+
+MHonArc
    
+Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    
+
    
+
+
+
diff --git a/doc/contacts.html b/doc/contacts.html
index daf3b47..3e802e3 100644
--- a/doc/contacts.html
+++ b/doc/contacts.html
@@ -1,14 +1,14 @@
 
 
 
-MHonArc v2.3 -- Contacts
+MHonArc v2.4 -- Contacts
 
 
 
 
 
    
-[Prev][Next][TOC][FAQ][Bugs][Home]
+[Prev][Next][TOC][FAQ][Bugs][Home]
 
    
 
 
@@ -16,6 +16,13 @@
 
 
    Contacts
    
 
+
+
+
+
 
    
 
    Mailing List
    
 
@@ -26,15 +33,11 @@ 
    Mailing List
    
 MHonArc. Appropriate topics for the list include: usage
 questions, bug reports, behavioral enhancements, documentation bugs,
 and general help.  
    
-
 
    To subscribe to the mailing list, send mail to
 mhonarc-request@ncsa.uiuc.edu with the command, 
    
-
 
    -subscribe
-
    
-
+subscribe

as the message body.

@@ -71,18 +74,21 @@

Mailing List

with from the address you sent the subscribe request.

-

The mailing list is archived by Majordomo. You -can use the WWW to access the archive (with -full text search using glimpse) at -<URL:http://www.xray.mpe.mpg.de/mailing-lists/mhonarc/> -

+

Web archives of the mailing list are available at the following +URLs: +

+

People

The people listed here are those responsible for development -and support of MHonArc. +and support of MHonArc:

Achim Bohnet
@@ -92,7 +98,7 @@

People

Earl Hood
-earlhood@usa.net +mhonarc@mhonarc.org

Creator and developer of MHonArc. Also author of the documention, for what it is worth.

@@ -121,19 +127,17 @@

People

-[Prev][Next][TOC][FAQ][Bugs][Home] +[Prev][Next][TOC][FAQ][Bugs][Home]

-98/10/24 17:31:03
+01/06/10 17:47:40
-MHonArc
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
+MHonArc
+Copyright © 1997-2001, Earl Hood, mhonarc@mhonarc.org
diff --git a/doc/faq/about.html b/doc/faq/about.html index 75a2619..a72a0d9 100644 --- a/doc/faq/about.html +++ b/doc/faq/about.html @@ -35,7 +35,7 @@

Summary

asked question on MHonArc. MHonArc is a Perl program for converting e-mail messages as specified in RFC 822 and MIME to MIME to HTML. MHonArc has the ability to maintain an archive of converted messages, or it can be used as a basic e-mail->HTML converter.

@@ -120,8 +120,8 @@

Version

Location

-

<URL:http://www.oac.uci.edu/indiv/ehood/MHonArc/doc/faq/faq.html> +

<http://www.mhonarc.org/MHonArc/doc/faq/faq.html>

@@ -131,8 +131,8 @@

Location

Author

-

Earl Hood, -earlhood@usa.net

+

Earl Hood, +mhonarc@mhonarc.org

@@ -145,13 +145,12 @@

Author

-98/09/30 23:02:02
+01/06/10 17:47:20
-MHonArc
-Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
+MHonArc
+Copyright © 1997-2001, Earl Hood, mhonarc@mhonarc.org
diff --git a/doc/faq/archives.html b/doc/faq/archives.html index 5a4cf5f..b185499 100644 --- a/doc/faq/archives.html +++ b/doc/faq/archives.html @@ -57,11 +57,25 @@

Why does a message get split into mulitple messages with separator. The following MSGSEP resource setting is known to work well:

-
+
 <MsgSep>
 ^From \S+\s+\S+\s+\S+\s+\d+\s+\d+:\d+:\d+\s+\d+
 </MsgSep>
-

+
+ +

In case you have message separates with quoted local parts in +the address part of the separator, you can use the following: +

+ +
+<MsgSep>
+^From\s+(?:"[^"]+"@\S+|\S+)\s+\S+\s+\S+\s+\d+\s+\d+:\d+:\d+\s+\d+
+</MsgSep>
+
+ +

Make sure to test things out before using in production +environments. +

If this fails, you can try the CONLEN resource available in v2.0 and later. The CONLEN resource, when set, tells @@ -131,7 +145,7 @@

So it is safe. How do I do it??

Many users use Procmail <URL:http://www.ii.com/internet/robots/procmail/> to call MHonArc +><http://www.ii.com/internet/robots/procmail/> to call MHonArc to archive messages. Procmail provides the ability to preprocess mail as it arrives to do selective processing and automated tasks with your mail. @@ -223,12 +237,35 @@

How can I do it with Majordomo lists?

owner-xxxx: list-admin-address xxxx-owner: list-admin-address -xxxx-mhonarc: "|/usr/lib/majordomo/wrapper mhonarc -add -quiet -outdir /home/httpd/html/yyyyyyy -rcfile rcs.mrc" +xxxx-mhonarc: "|/usr/lib/majordomo/wrapper mhonarc -add -quiet -outdir /home/httpd/html/yyyyyyy -rcfile rcs.mrc -stderr /var/log/mhonarc"

Replace text that is rendered like this with what is appropriate for your configuration.

+

In order to run MHonArc with Majordomo's wrapper, the program has to +be in the same directory where the Majordomo programs are located. +An easy way to insure this is to create a symbolic link to in Majordomo's +program directory to where MHonArc is installed. For example: +

+
+    shell> ln -s /usr/bin/mhonarc /usr/lib/majordomo/mhonarc
+
+

Make sure /usr/bin/mhonarc is readable and executable +by the majordomo user. Something like the following can be done +to insure this: +

+
+    shell> chmod 755 /usr/bin/mhonarc
+
+

If you redirect stderr to a logfile, the logfile must +be owned by the majordomo user and be writable by the majordomo user. +The directory for that logfile must exist. +

+

The MHonArc-archive directory must be owned by the majordomo user +and must have the minimum access permission 755. Group ownership does not +matter. +

@@ -244,7 +281,7 @@

Can I get MHonArc to filter messages to different arc Or. you can use a tool like Procmail <URL:http://www.ii.com/internet/robots/procmail/>. +><http://www.ii.com/internet/robots/procmail/>. Here are a some messages from users about using Procmail:

@@ -426,7 +463,11 @@

Can I get MHonArc to filter messages to different arc

Does MHonArc support the "no archive" flag in messages?

-

No. However, you can use a pre-processor like Procmail +

Version 2.4, or later, does via the CHECKNOARCHIVE resource. +

+ +

If using an earlier version, or if you are already doing some preprocessing, +you can use a pre-processor like Procmail to do the filtering. Here is a message sent to the MHonArc mailing list:

@@ -539,6 +580,18 @@

Why do some messages get re-added each time MHonArc proces MHonArc does not read them again.

+ + + + + +
NOTE

In MHonArc v2.4 and later, and if you have +the Digest::MD5 module installed, MHonArc will compute +the MD5 digest of message headers without message-ids. This +allows MHonArc to skip the message in subsequent add operations. +

+
+

A related problem is messages showing up again in the archive after you deleted them with RMM. MHonArc does not keep track of delete message-ids. Therefore, if want to make sure that @@ -555,7 +608,7 @@

How do I remove messages from an archive?

Automatic removal can be done via the EXPIREAGE or EXPIREDATE resources (available in v2.0 beta 2, -or later). +or later) or the MAXSIZE resource.

Explicit message removal can be done with the RMM resource. Please read the RMM resource page for more information @@ -573,13 +626,13 @@

How do I remove messages from an archive?

-98/11/08 12:21:29
+01/06/10 17:47:20
MHonArc
-Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
+Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
diff --git a/doc/faq/envs.html b/doc/faq/envs.html index 207bd89..8e6e35a 100644 --- a/doc/faq/envs.html +++ b/doc/faq/envs.html @@ -22,7 +22,10 @@

Supported Environments

  • What version of Perl is required to run MHonArc?
  • What mail user agents (MUA's) does MHonarc support?
  • Can MHonArc process Majordomo digests?
    • -
  • Can MHonArc process Listproc, Majordomo, or Listserv archives?
    • +
  • Can MHonArc process Listprocessor archives?
    • +
  • Can MHonArc process ezmlm archives?
    • +
  • Can MHonArc process qmail's maildir style mail folders?
    • +
  • Can MHonArc process Netscape Messenger folders?
  • Can MHonArc process Compuserve messages?
  • What about other mailbox/folder formats?
  • Can MHonArc create non-English archives?
    • @@ -226,7 +229,7 @@

    Can MHonArc process Majordomo digests?

    -

    Can MHonArc process Listproc, Majordomo, or Listserv archives?

    +

    Can MHonArc process Listprocessor archives?

    An answer from a MHonArc user: @@ -302,6 +305,100 @@

    Can MHonArc process Listproc, Majordomo, or Lists + +
    + +
    +

    Can MHonArc process ezmlm archives?

    +
    + +

    From what I read from the ezmlm(5) manpage, the following example +command will process all messages of list: +

    +
    +    shell> mhonarc /list/archive/[0-9]*
+
    +

    Replace "/list/archive/" to what is appropriate for your +configuration. +

    +

    Basically, each numeric subdirectory in the "archive" directory +follows the same format as MH mail directories. +

    +

    If you are using a shell that cannot handle "[0-9]*", the following +should work: +

    +
    +    shell> mhonarc `find /list/archive/ -type d -name '[0-9]*' -print`
+
    +

    Note, make sure to add any additional options to mhonarc as needed +to get the effects you desire. +

    + + +
    + +
    +

    Can MHonArc process qmail's maildir style mail folders?

    +
    + +

    For simplicity, let "MAILDIR" represent the pathname +to your qmail mail directory. +

    +

    To have mhonarc process MAILDIR, +you pass "MAILDIR/cur" and/or +"MAILDIR/new" as the mail folder arguments. +Which subdirectory you choose to use depends on your needs. +

    +

    Also, you will need to define the MHPATTERN resource to process +all non-dotfiles. Example: +

    +
    +    shell> mhonarc -mhpattern '^[^\.]' MAILDIR/cur
+
    +

    If all you will ever do is process qmail maildir folders, it may be best +to set the M2H_MHPATTERN environment variable so you do not have +to respecify each time you invoke mhonarc. Examples: +

    +
    +
    csh: +
    setenv M2H_MHPATTERN '^[^\.]' +
    sh: +
    M2H_MHPATTERN='^[^\.]'; export M2H_MHPATTERN +
    + + +
    + +
    +

    Can MHonArc process Netscape Messenger folders?

    +
    + +

    Yes. Each Netscape Messenger folder has a corresponding mailbox file +that stores the raw mail messages for the folder. The location +of the mailbox file will be in your mail directory. Under Unix, this +is normally $HOME/nsmail. For Windows, this is +typically +C:\Program Files\Netscape\Users\<username>\Mail. +

    + +

    For each Netscape folder, there are two files: +<folder-name> and +<folder-name>.summary (or +<folder-name>.snm under Windows). +The .summary can be ignored with respect to MHonArc. +The other file contains the raw mail messages and can be passed +directly to MHonArc for processing. For example, to process all the +mail in your Inbox, do something like the following: +

    +
    +    shell> mhonarc $HOME/nsmail/Inbox
+
    + +

    Note, you may need to compress/compact folders in Netscape before +running MHonArc. If not, messages you have deleted from a folder may +show up in the archive create by MHonArc. +

    +
    @@ -377,7 +474,7 @@

    What about other mailbox/folder formats?

    A potential source for help is <URL:http://mango.human.cornell.edu/kens/MoreFAQ.html#Convert>. The +><http://mango.human.cornell.edu/kens/MoreFAQ.html#Convert>. The URL is part of the Eudora FAQ. However, Eudora does uses UUCP-style mailbox format to store its messagse. Hence, the information provided from the URL can be applicable to MHonArc. @@ -439,13 +536,13 @@

    Can I create bilingual archives?

    -98/11/08 12:21:27
    +01/06/10 17:47:21
    MHonArc
    -Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
    +Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    diff --git a/doc/faq/faq.html b/doc/faq/faq.html index afdbfb3..81dc99b 100644 --- a/doc/faq/faq.html +++ b/doc/faq/faq.html @@ -13,7 +13,7 @@

    This documents contains answers to some of the frequently asked question on MHonArc. MHonArc is -a Perl program +a Perl program for converting e-mail messages as specified in RFC 822 and MIME to HTML. @@ -46,6 +46,7 @@

    Table of Contents

  • How does MHonArc compare to other email archivers, like Hypermail?
  • Why I should use MHonArc over some of the Internet-based mailing list archive services?
  • Are their "real-world" examples of MHonArc usage?
    • +
  • Why are list archives about Perl-related topics not maintained with a Perl-based program, like MHonArc?
  • Is MHonArc Y2K (Year 2000) compliant?
    • @@ -58,7 +59,10 @@

    Table of Contents

  • What version of Perl is required to run MHonArc?
  • What mail user agents (MUA's) does MHonarc support?
  • Can MHonArc process Majordomo digests?
    • -
  • Can MHonArc process Listproc, Majordomo, or Listserv archives?
    • +
  • Can MHonArc process Listprocessor archives?
    • +
  • Can MHonArc process ezmlm archives?
    • +
  • Can MHonArc process qmail's maildir style mail folders?
    • +
  • Can MHonArc process Netscape Messenger folders?
  • Can MHonArc process Compuserve messages?
  • What about other mailbox/folder formats?
  • Can MHonArc create non-English archives?
    • @@ -150,13 +154,13 @@

    Table of Contents

    -98/11/08 12:21:28
    +01/06/10 17:47:21
    MHonArc
    -Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
    +Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    diff --git a/doc/faq/general.html b/doc/faq/general.html index a0fce97..538aa38 100644 --- a/doc/faq/general.html +++ b/doc/faq/general.html @@ -24,6 +24,7 @@

    General

  • How does MHonArc compare to other email archivers, like Hypermail?
  • Why I should use MHonArc over some of the Internet-based mailing list archive services?
  • Are their "real-world" examples of MHonArc usage?
    • +
  • Why are list archives about Perl-related topics not maintained with a Perl-based program, like MHonArc?
  • Is MHonArc Y2K (Year 2000) compliant?
    • @@ -69,7 +70,7 @@

    What is MHonArc?

    What's the latest version of MhonArc?

     -

    2.3.3 +

    2.4.9

    @@ -82,12 +83,12 @@

    Where can I get MHonArc?

    The latest information on MHonArc, and its availability, may be obtained at <URL:http://www.oac.uci.edu/indiv/ehood/mhonarc.html>. +><http://www.mhonarc.org/>.

    MHonArc requires Perl to run. If you do not have Perl, it can be obtained from -<URL:http://www.perl.com/>. +<http://www.perl.com/>.

    @@ -100,10 +101,10 @@

    What restrictions are there on MHonArc usage?

    MHonArc is free software. MHonArc is distributed under the GNU General Public License (GPL). A copy of the license is included in the distribution. Please read it for more information, or go -to <URL:http://www.gnu.org/>. +to <http://www.gnu.org/>. Note, that the word "free" means something different than "no cost". See the GPL and -<URL:http://www.gnu.org/> for more +<http://www.gnu.org/> for more information.

    @@ -112,7 +113,8 @@

    What restrictions are there on MHonArc usage?

    If you do not feel comfortable with the current licensing -of MHonArc, GPL, then contact the developer of MHonArc if you +of MHonArc, GPL, then contact the +developer of MHonArc if you want to make alternate licensing arrangements.

    @@ -190,10 +192,10 @@

    Where can I get help on MHonArc?

    the archive (with full text search using Glimpse) at <URL:http://www.xray.mpe.mpg.de/mailing-lists/>. +><http://www.xray.mpe.mpg.de/mailing-lists/>. An alternative web archive of the mailing list is at <URL:http://www.mail-archive.com/mhonarc@ncsa.uiuc.edu/>. +><http://www.mail-archive.com/mhonarc@ncsa.uiuc.edu/>.

    @@ -232,8 +234,10 @@

    How does MHonArc compare to other email archivers, like UUCP-style mailboxes.

    -

  • MHonArc provides the ability to extend the type of -MIME content-types supported. +

  • MHonArc has fairly robust MIME support, including the ability to +extend the list of media-types supported. +Hypermail is supposed to have some +some support for MIME, but it still appears to be a work in progress.

  • Page customization. MHonArc gives you complete control @@ -272,7 +276,7 @@

    How does MHonArc compare to other email archivers, like currently a maintainer. Information about Hypermail can be obtained from <URL:http://www.landfield.com/hypermail/>. +><http://www.landfield.com/hypermail/>.

    @@ -308,7 +312,7 @@

    Why I should use MHonArc over some of the Internet that is available at no charge, and it uses MHonArc and the htDig search engine. See <URL:http://www.mail-archive.com/> for more information. +><http://www.mail-archive.com/> for more information.

    @@ -323,27 +327,49 @@

    Are their "real-world" examples of MHonArc usage?
  • WWW Mailing List Archives & References:
    <URL:http://www.xray.mpe.mpg.de/mailing-lists/> +><http://www.xray.mpe.mpg.de/mailing-lists/>
  • The Mail Archive:
    <URL:http://www.mail-archive.com/> +><http://www.mail-archive.com/>
  • Mallorn Archived Email Lists:
    <URL:http://www.mallorn.com/lists/> +><http://www.mallorn.com/lists/> +
  • FreeLists:
    +<http://www.freelists.org/>
  • Majordomo Users Mailing List Interface:
    <URL:http://www.hpc.uh.edu/majordomo-users> +><http://www.hpc.uh.edu/majordomo-users> +
  • Sourceware.cygnus.com Mailing Lists:
    +<http://sourceware.cygnus.com/ml/>
  • Liblicense-L List Archives:
    <URL:http://www.library.yale.edu/~llicense/ListArchives/> -
  • Lyx Mailing List Archives:
    -<URL:http://www.via.ecp.fr/lyx/archive/> +><http://www.library.yale.edu/~llicense/ListArchives/>
  • FVWM Archives:
    <URL:http://www.hpc.uh.edu/fvwm/archive/> +><http://www.hpc.uh.edu/fvwm/archive/> +
  • Lists Archived at Kanga.Nu:
    +<http://www.kanga.nu/archives/> +
  • Apsfilter Archives:
    +<http://www.apsfilter.org/Lists-Archives/> +
  • Giant Java Tree Archives:
    +<http://www.git.org/servlets/MailingLists/ListOfLists.html> + +
    + +
    +

    Why are list archives about Perl-related topics not maintained with a Perl-based program, like MHonArc?

    +
    + +

    The answer is something I would like to know myself. +

    +
    @@ -364,7 +390,7 @@

    Is MHonArc Y2K (Year 2000) compliant?

    You may want to check <URL:http://language.perl.com/news/y2k.html> about Y2K +><http://language.perl.com/news/y2k.html> about Y2K from a Perl point-of-view.

    @@ -379,13 +405,12 @@

    Is MHonArc Y2K (Year 2000) compliant?

    -98/11/08 12:21:28
    +01/06/10 17:47:21
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
    +MHonArc
    +Copyright © 1997-2001, Earl Hood, mhonarc@mhonarc.org
    diff --git a/doc/faq/indexpgs.html b/doc/faq/indexpgs.html index 140faf2..7cc9062 100644 --- a/doc/faq/indexpgs.html +++ b/doc/faq/indexpgs.html @@ -114,17 +114,17 @@

    How does the OTHERINDEXES resource work?I am going to describe a basic example on how OTHERINDEXES can be used.

    -

    First, lets have the top resource file (call it "top.rc") that +

    First, lets have the top resource file (call it "top.mrc") that defines the formatting of the default 2 indexes (a main and a thread). Example:

    -
    *** snip "top.rc" ***
+
    *** snip "top.mrc" ***
 <MAIN>
 <THREAD>
 <SORT>
 <NOTREVERSE>
 <NOREVERSE>
-*** snip "top.rc" ***
+*** snip "top.mrc" ***
 
    
 
    I may have a bunch of layout stuff, but that is not important
 for this discussion.
@@ -135,14 +135,14 @@ 
    How does the OTHERINDEXES resource work?
 
    Now, I would like to also create subject and author indexes.
-In "top.rc" I would add the following:
+In "top.mrc" I would add the following:
 
    
-
    *** snip "top.rc" ***
+
    *** snip "top.mrc" ***
 <OTHERINDEXES>
-subject.rc
-author.rc
+subject.mrc
+author.mrc
 </OTHERINDEXES>
-*** snip "top.rc" ***
+*** snip "top.mrc" ***
 
    
 
    The filenames listed are arbitrary, but it is useful if they
 imply their purpose.  Since absolute pathnames were not used,
@@ -153,7 +153,7 @@ 
    How does the OTHERINDEXES resource work?
 
    The following now shows the important settings for each file:
 
    
-
    *** snip "subject.rc" ***
+
    *** snip "subject.mrc" ***
 <MAIN>
 <NOTHREAD>
 <SUBSORT>
@@ -164,9 +164,9 @@ 
    How does the OTHERINDEXES resource work?
-
    *** snip "author.rc" ***
+
    *** snip "author.mrc" ***
 <MAIN>
 <NOTHREAD>
 <AUTHSORT>
@@ -177,7 +177,7 @@ 
    How does the OTHERINDEXES resource work?
 
    Again, notice how I am being explicit.  MHonArc does not reset
 resources when reading the otherindexes resource files. with one
@@ -185,7 +185,7 @@ 
    How does the OTHERINDEXES resource work?
 
    NOTE:
@@ -246,13 +246,13 @@ 
    Can I include links to message attachments on index
 
 
    
 
    
-98/11/08 12:21:28
    
+01/06/10 17:47:21
    
 
     MHonArc
    
-Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
    
+Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    
 
    
 
 
diff --git a/doc/faq/mime.html b/doc/faq/mime.html
index fbe22e4..6dee2ca 100644
--- a/doc/faq/mime.html
+++ b/doc/faq/mime.html
@@ -160,15 +160,15 @@ 
    Can long lines be wrapped in converted messages?
 
 
-
    
+
    
 
    
-98/09/30 23:02:05
    
+01/06/10 17:47:21
    
 
 MHonArc
    
-Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
    
+Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    
 
    
 
 
diff --git a/doc/faq/msgpgs.html b/doc/faq/msgpgs.html
index a8f7b04..6280112 100644
--- a/doc/faq/msgpgs.html
+++ b/doc/faq/msgpgs.html
@@ -203,13 +203,13 @@ 
    Are those "<!--X-... -->" legal comments?
 
 
    
 
    
-98/09/30 23:02:05
    
+01/06/10 17:47:21
    
 
 MHonArc
    
-Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
    
+Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    
 
    
 
 
diff --git a/doc/faq/threads.html b/doc/faq/threads.html
index 341a61d..6152de5 100644
--- a/doc/faq/threads.html
+++ b/doc/faq/threads.html
@@ -96,15 +96,15 @@ 
    How can I get my MUA to define the References or In-R
 
    
 
 
-
    
+
    
 
    
-98/09/30 23:02:05
    
+01/06/10 17:47:21
    
 
     MHonArc
    
-Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
    
+Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    
 
    
-
-
+
+
diff --git a/doc/faq/usage.html b/doc/faq/usage.html
index 5681939..2040c31 100644
--- a/doc/faq/usage.html
+++ b/doc/faq/usage.html
@@ -59,7 +59,7 @@ 
    Is there a resource file editor?

    If you are Vim user, -<URL:http://www.vim.org/>, +<http://www.vim.org/>, a syntax file for MHonArc resource files is included in the examples directory (mhonarc.vim). To use it, copy mhonarc.vim to an appropriate location @@ -125,21 +125,23 @@

    I get an error that "newgetopt.pl" cannot be required

    Does MHonArc provide searching of archives?

    -

    No, but a searching can be provided by another utility. See -the MHonArc home page -<URL:http://www.oac.uci.edu/indiv/ehood/mhonarc.html> to -some links to contributed programs for searching MHonArc -archives. -Also, any standard search engine can be used. For example, the -MHonArc mailing list archive -<URL:http://www.rosat.mpe-garching.mpg.de/mailing-lists/mhonarc/> -provides a -Glimpse +

    No, but a searching can be provided by another utility. +The following list of search indexing tools have been used with +MHonArc archives: +

    + +

    For more information, see the respective documentation of the search engine software of interest.

    @@ -149,7 +151,7 @@

    Does MHonArc provide searching of archives?

    You may also want to check out Wilma at <URL:http://www.hpc.uh.edu/majordomo/#wilma>. +><http://www.hpc.uh.edu/majordomo/#wilma>. Wilma is the Web Interface to List Mail Archives, written by Dave Wolfe and Jason Tibbitts with nods to Achim Bohnet and Tom Christiansen. WIlma is a relatively simple bit of Perl which links together the @@ -169,8 +171,10 @@

    Is there a Web interface for MHonArc?

    No official ones. Several users have created home-grown interfaces -to perform various tasks. I recommend searching the -MHonArc mailing list archives. +to perform various tasks. An experimental web admin tool comes in +with the MHonArc distribution under the "admin" directory. +I recommend searching the +MHonArc mailing list archives for discussion about web interfaces.

    @@ -226,7 +230,7 @@

    Can I have MHonArc process a bunch of separate message called "messages". I'd do the following: 

    -    % mhonarc -mhpattern "^[^.]" messages
+    shell> mhonarc -mhpattern "^[^.]" messages

    MHPATTERN can be any Perl regular expression. The one in the example matches any file not beginning with ".". This @@ -237,8 +241,8 @@

    Can I have MHonArc process a bunch of separate message it one at a time. For example: 

    -    % mhonarc -add < file1.822
-    % mhonarc -add < file2.822
+    shell> mhonarc -add < file1.822
+    shell> mhonarc -add < file2.822
     ...
    @@ -253,7 +257,7 @@

    Can I tell MHonArc to read a mailbox from standard input? the capability). The syntax is something like the following: 

    -    % mhonarc [options-here] -- -
+    shell> mhonarc [options-here] -- -

    The "--" tells MHonArc to terminate all command-line option processing and treat all following arguments as mail @@ -267,7 +271,7 @@

    Can I tell MHonArc to read a mailbox from standard input? make it suitable for processing by MHonArc. For example: 

    -    % mypreproc | mhonarc -- -
+    shell> mypreproc | mhonarc -- -
    @@ -343,13 +347,13 @@

    Why is the number of messages reported by MHonArc less th
    -98/10/03 15:44:56
    +01/06/10 17:47:21
    MHonArc
    -Copyright © 1997-1998, Earl Hood, ehood@medusa.acs.uci.edu
    +Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    diff --git a/doc/install.html b/doc/install.html new file mode 100644 index 0000000..252305e --- /dev/null +++ b/doc/install.html @@ -0,0 +1,479 @@ + + + +MHonArc v2.4 -- Installation + + + + +

    +[Prev][Next][TOC][FAQ][Bugs][Home] +

    + +
    + +

    Installation

    + +

    The following section describes how to install MHonArc on your +system. +

    + + + + + + +
    +

    System Requirements

    + +

    The following is required inorder to use MHonArc: +

    +
      +

    • Perl 5 is installed. If you do not have Perl 5, goto +<http://language.perl.com/> for download information. +

      +
      • +

    • Getopt::Long and Time::Local modules are installed. +These modules are part of the standard Perl distribution. The +following command can be used to verify that the modules +are installed on your system: +

      +
      +shell> perl -MGetopt::Long -MTime::Local -e ';'
+
      +

      If you get any error messages, you either have an incomplete +installation of Perl, or Perl is misconfigured. +

      +
      • +

    • The following modules are optional: +

      +
        +

      • Digest::MD5: Used for creating IDs for messages without +message-ids. This module helps MHonArc detect already +archived messages for messages without message-ids. +

        +
        • +

      • Fcntl, Symbol: Used for flock() based archive locking +(if specified by the user). See LOCKMETHOD + resource for more information. +

        +
        • +
      +

      MHonArc will still function if the above listed modules are +not available. +

      +
      • +
    + + +
    +

    Downloading MHonArc

    + +

    The homepage for MHonArc is +<http://www.mhonarc.org/>. The homepage +list various sites that you can download MHonArc. If you are +familiar with +Comprehensive Perl Archive Network +(CPAN), MHonArc can be downloaded from +<http://www.perl.com/CPAN/authors/id/EHOOD/>. +

    + +

    MHonArc is distributed in either a tar/gzip file or a zip file. The +tar/gzip file will have a name like MHonArcX.X.X.tar.gz, +and the zip file have a name like MHonArcX.X.X.zip; +where X.X.X represents the version number. +

    +

    Alternate distribution formats for MHonArc may be available, like +Linux RPM. Alternate distribution formats are not covered in this +document. +

    + + +
    +

    Extracting the MHonArc Distribution

    + +

    After downloading MHonArc, it is best to move the file to a +temporary location for extraction. To extract a tar/gzip distribution, +use the following command: +

    +
    +    shell> gzip -dc MHonArcX.X.X.tar.gz | tar xvf -
+
    +

    To extract the zip distribution, you can use a program like WinZip, +or any other program that supports zip archives. When extracting, make +sure to preserve the directory structure. +

    + + + + + +
    NOTE

    WinZip does support tar/gzip files. +

    +
    +

    After extraction, the subdirectory MHonArcX.X.X will +have been created containing all the files comprising MHonArc. +

    + + + + + +
    IMPORTANT

    Please read the file RELNOTES included in the MHonArc +distribution before continuing for any news about compatibility +with previous versions and/or important usage information. +

    +
    +

    You +will now want to change your current directory to MHonArcX.X.X +for the next step. +

    + + +
    +

    Installing with install.me

    + +

    Provided in the MHonArc distribution is a Perl program, +install.me +that will install MHonArc on your system. To run the program, type +the following at your shell prompt: +

    +
    +    shell> perl install.me
+
    + + + + + +
    IMPORTANT

    You must be in the same directory as the install.me +program when you run it. +

    +
    + +

    The installation program will ask you a series of questions on where +the perl executable is and where to put MHonArc files. Just hit +<CR> to accept the default values listed in ()'s. Note, the default +values are determined by the configuration of perl on your system. +If you choose the defaults, you may need to possess root/admin privileges +to have a successful install. +

    + +

    install.me can take several options on the +command-line to affect what is done during installation. The following +is the list of options available: +

    +
    +  -afs                  : Skip permission checks (useful if AFS)
+  -batch                : Run in batch mode (do not ask questions)
+  -binpath <path>       : Directory path to install programs/scripts
+  -docpath <path>       : Directory path to install documentation
+  -help                 : A message summarizing options available
+  -libpath <path>       : Directory path to install library files
+  -filelist <file>      : List of files to install (def="FILELIST")
+  -manpath <path>       : Directory path to manpages
+  -nobin                : Do not install programs
+  -nodoc                : Do not install documentation
+  -nolib                : Do not install library files
+  -noman                : Do not install manpages
+  -perl <pathname>      : Pathname of perl interpreter
+  -prefix <path>        : Set prefix for installation directories
+
    + +

    For example, if you do not want to install the documentation, do +the following: +

    +
    +    shell> perl install.me -nodoc
+
    + +

    Later on, if you decide you want to install the documentation, but +not re-install the other files, do the following: +

    +
    +    shell> perl install.me -nobin -nolib -noman
+
    + +

    If you want to install files relative to your home directory, do the +following: +

    +
    +    shell> perl install.me -prefix $HOME
+
    +
    +

    install.me Notes

    +
      +

    • The "#!" line in the installed programs are set to point to +the perl executable specified in the installation process. +This is convienence for those using systems that support the +"#!" notation. +

      +
      • +

    • The installation lib directory is added to each program's +search path so each program can find the libaries needed for +proper execution. Therefore, you should NOT have to set your +PERL5LIB environment variable if you install the library files +in a location not in the default perl library search path. +

      +
      • +

    • If you specify paths that do not exist, the install.me +program will create the paths for you. If running in +interactive mode, you will be prompted before each path +is created. +

      +
      • +

    • install.me supports environment variable interpolation in +pathnames specified during interactive installation. +For example, if you want to install the program files into +your local bin directory, you can enter the following when +prompted for the location to install executables: $HOME/bin. +Also, if the '~' (tilde) character is the first character of the +pathname specified, it will be expanded to the value of the +HOME environment variable. Therefore, the following are +equivalent: $HOME/bin and ~/bin. +

      +
      • +

    • The -afs option should only be needed +if installing MHonArc onto AFS and using an older version of Perl 5. +It should not be needed for Perl 5.005 or later. +

      +
      • +

    • If you want to abort the installation, just enter the +termination character. For Unix systems, it is normally +Ctrl-C; for Win32 systems, it is normally Ctrl-Z. +

      +
      • +
    + + +
    +

    The Perl 5 Way

    + +

    Of course, you can install MHonArc the standard way under Perl 5: +

    +
    +    shell> perl Makefile.PL
+    shell> make
+    shell> make install
+
    +

    If you want to install in a specific directory, try: +

    +
    +    shell> perl Makefile.PL PREFIX=/tmp/myperl5
+    shell> make
+    shell> make install
+
    + + + + + + +
    NOTE

    install.me is actually called "behind the scenes" +to install the files. +

    +
    + + + +
    +

    Win32 Notes

    +
      +

    • The main programs will automatically be converted to DOS batch +files. Hence, if the path location of the main programs is +in your PATH, you should be able to invoke them like any other +program. Note, the path to the perl executable must be in +your PATH, also. +

      +
      • +

    • The main programs will also be copied to ".pl" files. +Therefore, if you have .pl associated with Perl in the registry, you +can invoke the programs directly (if the path location of the +main programs are in your search path). For example: +

      +    shell> mhonarc.pl ...
+
      +

      This is known to work under WinNT and under the Cygwin bash shell. +

      +

      This is better than going though the batch file mechanism since +I/O redirection does not work when invoking a batch file. +

      +
      • +

    • In the logo directory of the distribution is a BMP file +mhaicon.bmp. You can copy the image into your Windows Icon +directory. Then through the file types editor of the file +explorer, you can specify mhaicon.bmp as the icon for MHonArc +resource (.mrc) files. +

      +
      • +
    + + +
    +

    Alternate Operating Systems

    + +

    In many cases, the install.me program will work for other operating +systems. Please contact the author on any success stories for +other operating systems, and please send any patches, if required. +

    + + +
    +

    Manual Installation

    + +

    If install.me will not work properly for your system, here are the +steps to install MHonArc manually: +

    +
      + +

    • Copy files in the lib directory to the +library location you desire. +

      +
      • +

    • Copy the program files to the location you want them +installed. After copying, you must edit the each file +as follows: +

      +
        +

      • Edit the "#!/..." line (the first line of each file) +to be the complete pathname of your perl interpreter. +Note, this step is only required for systems (Unix) +that support "#!". +

        +
        • +

      • Add a new line right after the "#!/..." line to +contain the following: +

        +    use lib '/path/to/lib/files';
+
        +

        where "/path/to/lib/files/" is the path to where +copied the library files to. +

        +

        Note, if the location you copied the libraries are +already part of Perl's standard library search path, +you do not need to add the "use lib" statement. +

        +
        • +
      +
      • +
    + + +
    +

    Post Installation Configuration

    + +

    After installation, you may want to do some site-specific +configuration. +

    + +

    Default Resource File

    + +

    You have the ability to create a default +resource file +to make site-wide defaults for MHonArc. The name of the +resource file should be mhonarc.rc and should +be placed in the MHonArc library directory as specified during +installation. For more information on what can be put in +a resource file, see the +Resources section. +

    + + + + + +
    NOTE

    It is advisable to create some local documentation for +users describing +any settings you place in the site-wide resource file. +This will avoid confusion if site settings vary from default settings +described in the documentation, and it will help avoid invalid bug +reports. +

    +
    + +

    Site Initialization Library

    + +

    If you do not know Perl, ignore this section. +

    +

    When MHonArc opens an archive for processing, MHonArc +will attempt to execute the instructions in the file +mhasiteinit.pl. This file allows you +to make site customizations not possible through a +default resource file. +mhasiteinit.pl should be placed in the +MHonArc library directory as specified during installation. +A sample mhasiteinit.pl file is provied in the +examples directory of the distribution to get you +started. +

    + + +
    +

    Resource File Editing

    + +

    If you are a Vim user, +<http://www.vim.org/>, a syntax file +for MHonArc resource files is included in the examples directory: +mhonarc.vim. +Vim is known to run on a variety of operating systems, +and is free software. +

    + +

    To use mhonarc.vim, copy mhonarc.vim to an +appropriate location and +add something like the following to your .vimrc file: +

    +
    +au BufNewFile,BufRead *.mrc	so $HOME/share/vim/syntax/mhonarc.vim
+
    +

    Of course, change the pathname to mhonarc.vim to wherever +you copied it to. +

    + +

    Now, any file with .mrc extension will put Vim into +MHonArc resource file highlighting mode. The mode is best used with +color-capable terminals. +

    + +
    + +

    +[Prev][Next][TOC][FAQ][Bugs][Home] +

    + + + +
    +
    +01/06/10 17:47:40
    + +MHonArc
    +Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    +
    + + + diff --git a/doc/intro.html b/doc/intro.html index ea6f4de..ecd80b3 100644 --- a/doc/intro.html +++ b/doc/intro.html @@ -1,23 +1,35 @@ -MHonArc v2.3 -- Introduction +MHonArc v2.4 -- Introduction

    -[Prev][Next][TOC][FAQ][Bugs][Home] +[Prev][Next][TOC][FAQ][Bugs][Home]

    Introduction

    + + + + +
    +

    What is MHonArc?

    +

    MHonArc is a Perl program for converting e-mail messages as specified in RFC 822 and -the +the MIME standard to HTML. MHonArc can perform the following tasks:

    @@ -85,28 +97,27 @@

    Supported Platforms

    Availability

    The latest information on MHonArc, where to get more help, -and its availability, may be obtained at <URL:http://www.oac.uci.edu/indiv/ehood/mhonarc.html>. +and its availability, may be obtained at +<http://www.mhonarc.org/>.

    -[Prev][Next][TOC][FAQ][Bugs][Home] +[Prev][Next][TOC][FAQ][Bugs][Home]

    -98/10/24 17:31:04
    +01/06/10 17:47:40
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-2000, Earl Hood, mhonarc@mhonarc.org
    diff --git a/doc/layout.html b/doc/layout.html index aaac2f6..41e5af0 100644 --- a/doc/layout.html +++ b/doc/layout.html @@ -1,14 +1,14 @@ -MHonArc v2.3 -- Page Layout +MHonArc v2.4 -- Page Layout

    -[Prev][Next][TOC][FAQ][Bugs][Home] +[Prev][Next][TOC][FAQ][Bugs][Home]

    @@ -17,9 +17,36 @@

    Page Layout

    The section describes the layout of the pages created by -MHonArc. Each page's layout is controlled by resources -(see MHonArc Resources). -To simplify the description of each type of page created +MHonArc. Each page's layout is controled by +resources +(see Section Resources). Layout +resources can be changed as you see fit to achieve the +appearence you desire for your mail archives. + + +

    + + + + +
    +

    Notation

    + +

    To simplify the description of the various pages created by MHonArc, the following notation is used:

    @@ -52,12 +79,12 @@

    Main Index Page

    main index is commonly referred to as the date index.

    -

    Main index page resource layout

    +

    Main index page resource layout

     IDXPGBEGIN
     HEADER
-	LISTBEGIN
+    LISTBEGIN
 	(AUTHORBEGIN |
 	 DAYBEGIN |
 	 SUBJECTBEGIN)?
@@ -65,9 +92,9 @@ 
    Main index page resource layout
    
 	(AUTHOREND |
 	 DAYEND |
 	 SUBJECTEND)?
-         LISTEND
+     LISTEND
     FOOTER
-    DOC
+    DOC?
 IDXPGEND
    @@ -92,7 +119,7 @@

    Thread Index Page

    flexibility for customizing thread listing layout.

    -

    Thread index page resource layout

    +

    Thread index page resource layout

     TIDXPGBEGIN
@@ -118,7 +145,7 @@ 
    Thread index page resource layout
    
 	 |
 	 TSINGLETXT)* [message w/o references or follow-ups]
     TFOOT
-    DOC
+    DOC?
 TIDXPGEND
    @@ -142,7 +169,7 @@

    Message Page

    to HTML and archive navigational links.

    -

    Message page resource layout

    +

    Message page resource layout

     MSGPGBEGIN
@@ -192,20 +219,20 @@ 
    Message page resource layout
    
 
    
 
 
    
-[Prev][Next][TOC][FAQ][Bugs][Home]
+[Prev][Next][TOC][FAQ][Bugs][Home]
 
    
 
 
 
 
    
 
    
-98/10/24 17:31:04
    
+01/06/10 17:47:40
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    
 
    
 
 
diff --git a/doc/mhonarc.html b/doc/mhonarc.html
index 360038e..d4fd1e2 100644
--- a/doc/mhonarc.html
+++ b/doc/mhonarc.html
@@ -1,7 +1,7 @@
 
 
 
-MHonArc v2.3 Documentation
+MHonArc v2.4 Documentation
 
 
@@ -20,22 +20,47 @@ 
    Table of Contents
    
 
 
+
 
+

    • @@ -135,7 +142,7 @@

    Converting MH mail folders or Mailbox files

    -% mhonarc ~/mail/inbox
+shell> mhonarc ~/mail/inbox
 Converting messages to .
 Reading /mnt/ehood/mail/inbox ..........
 Writing mail ...
@@ -147,7 +154,7 @@ 
    Converting MH mail folders or Mailbox files

    By default, MHonArc prints out information about its progress. -This can be disable if you specify the +This can be disabled with the -quiet option.

    @@ -174,7 +181,7 @@

    Adding Messages to an Archive

    -% mhonarc -add <path>/mailfolder
+shell> mhonarc -add <path>/mailfolder
    @@ -202,14 +209,14 @@

    Adding Messages to an Archive

    -% mhonarc -add < single.msg 
+shell> mhonarc -add < single.msg

    Or, from a pipe: 

    -% cat single.msg | mhonarc -add 
+shell> cat single.msg | mhonarc -add
    @@ -229,13 +236,12 @@

    Converting a single message

    related specificly to archive processing, like index links and mail thread links.

    -

    Examples -

    +

    Examples

    Input from standard input: -

    % mhonarc -single < messagefile > file.html +

    shell> mhonarc -single < messagefile > file.html

    @@ -243,26 +249,26 @@

    Examples
    Filename on command-line:
    -

    % mhonarc -single messagefile > file.html +

    shell> mhonarc -single messagefile > file.html

    -[Prev][Next][TOC][FAQ][Bugs][Home] +[Prev][Next][TOC][FAQ][Bugs][Home]

    -98/10/24 17:31:05
    +01/06/10 17:47:40
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    diff --git a/doc/rcfileexs/date.mrc.html b/doc/rcfileexs/date.mrc.html new file mode 100644 index 0000000..913ffe1 --- /dev/null +++ b/doc/rcfileexs/date.mrc.html @@ -0,0 +1,72 @@ + + +
    +<!-- MHonArc Resource File -->
+<!-- @(#) date.mrc 99/06/25 13:25:39
+     Earl Hood <mhonarc@pobox.com>
+  -->
+<!-- This resource file utilizes the day grouping feature of MHonArc
+     to format the main index.
+  -->
+
+<!--	Specify date sorting.
+  -->
+<Sort>
+
+<!--	Set USELOCALTIME since local date formats are used when displaying
+	dates.
+  -->
+<UseLocalTime>
+
+<!--    Define message local date format to print day of the week, month,
+	month day, and year.  Format used for day group heading.
+  -->
+<MsgLocalDateFmt>
+%B %d, %y
+</MsgLocalDateFmt>
+
+<!--	Redefine LISTBEGIN since a table will be used for index listing.
+  -->
+<ListBegin>
+<UL>
+<LI><A HREF="$TIDXFNAME$">Thread Index</A></LI>
+</UL>
+<HR>
+<table border=0>
+</ListBegin>
+
+<!--	DAYBEGIN defines the markup to be printed when a new day group
+	is started.
+  -->
+<DayBegin>
+<tr><td colspan=4><strong>$MSGLOCALDATE$</strong></td></tr>
+</DayBegin>
+
+<!--	DAYBEND defines the markup to be printed when a day group
+	ends.  No markup is needed in this case, so we leave it blank.
+  -->
+<DayEnd>
+
+</DayEnd>
+
+<!--	Define LITEMPLATE to display the time of day the message was
+	sent, message subject, author, and any annotation for the
+	message.
+  -->
+<LiTemplate>
+<tr valign=top>
+<td>$MSGLOCALDATE(CUR;%H:%M)$</td>
+<td><b>$SUBJECT$</b></td>
+<td>$FROMNAME$</td>
+<td>$NOTE$</td>
+</tr>
+</LiTemplate>
+
+<!--	Define LISTEND to close table
+  -->
+<ListEnd>
+</table>
+</ListEnd>
+
    + + diff --git a/doc/rcfileexs/def-mime.mrc.html b/doc/rcfileexs/def-mime.mrc.html new file mode 100644 index 0000000..bf6c200 --- /dev/null +++ b/doc/rcfileexs/def-mime.mrc.html @@ -0,0 +1,82 @@ + + +
    +<!-- ================================================================== -->
+<!--    @(#) def-mime.mrc 1.8 00/10/28 11:14:10
+        Earl Hood <mhonarc@pobox.com>
+  -->
+<!--    MHonArc Resource File                                           --
+  --                                                                    --
+  --    Description:                                                    --
+  --	    Default resource settings related to MIME processing	--
+  --									-->
+<!-- ================================================================== -->
+
+<CharsetConverters>
+plain;          mhonarc::htmlize;
+us-ascii;       mhonarc::htmlize;
+iso-8859-1;     mhonarc::htmlize;
+iso-8859-2;     iso_8859::str2sgml;     iso8859.pl
+iso-8859-3;     iso_8859::str2sgml;     iso8859.pl
+iso-8859-4;     iso_8859::str2sgml;     iso8859.pl
+iso-8859-5;     iso_8859::str2sgml;     iso8859.pl
+iso-8859-6;     iso_8859::str2sgml;     iso8859.pl
+iso-8859-7;     iso_8859::str2sgml;     iso8859.pl
+iso-8859-8;     iso_8859::str2sgml;     iso8859.pl
+iso-8859-9;     iso_8859::str2sgml;     iso8859.pl
+iso-8859-10;    iso_8859::str2sgml;     iso8859.pl
+iso-2022-jp;    iso_2022_jp::str2html;  iso2022jp.pl
+latin1;         mhonarc::htmlize;
+latin2;         iso_8859::str2sgml;     iso8859.pl
+latin3;         iso_8859::str2sgml;     iso8859.pl
+latin4;         iso_8859::str2sgml;     iso8859.pl
+latin5;         iso_8859::str2sgml;     iso8859.pl
+latin6;         iso_8859::str2sgml;     iso8859.pl
+default;        -ignore-
+</CharsetConverters>
+
+<MIMEFilters>
+application/ms-tnef;       m2h_null::filter;            mhnull.pl
+application/octet-stream;  m2h_external::filter;        mhexternal.pl
+application/*;             m2h_external::filter;        mhexternal.pl
+application/x-patch;       m2h_text_plain::filter;      mhtxtplain.pl
+audio/*;                   m2h_external::filter;        mhexternal.pl
+chemical/*;                m2h_external::filter;        mhexternal.pl
+model/*;                   m2h_external::filter;        mhexternal.pl
+image/*;                   m2h_external::filter;        mhexternal.pl
+message/delivery-status;   m2h_text_plain::filter;      mhtxtplain.pl
+message/external-body;     m2h_msg_extbody::filter;     mhmsgextbody.pl
+message/partial;           m2h_text_plain::filter;      mhtxtplain.pl
+text/*;                    m2h_text_plain::filter;      mhtxtplain.pl
+text/enriched;             m2h_text_enriched::filter;   mhtxtenrich.pl
+text/html;                 m2h_text_html::filter;       mhtxthtml.pl
+text/plain;                m2h_text_plain::filter;      mhtxtplain.pl
+text/richtext;             m2h_text_enriched::filter;   mhtxtenrich.pl
+text/setext;               m2h_text_setext::filter;     mhtxtsetext.pl
+text/tab-separated-values; m2h_text_tsv::filter;        mhtxttsv.pl
+text/x-html;               m2h_text_html::filter;       mhtxthtml.pl
+text/x-setext;             m2h_text_setext::filter;     mhtxtsetext.pl
+video/*;                   m2h_external::filter;        mhexternal.pl
+x-sun-attachment;          m2h_text_plain::filter;      mhtxtplain.pl
+</MIMEFilters>
+
+<MIMEArgs>
+image/gif;       inline
+image/jpeg;      inline
+image/x-xbitmap; inline
+image/x-xbm;     inline
+</MIMEArgs>
+
+<MIMEDecoders>
+7bit;   	  as-is;
+8bit;   	  as-is;
+binary;   	  as-is;
+base64;   	  base64::b64decode;		base64.pl
+quoted-printable; quoted_printable::qprdecode;	qprint.pl
+x-uuencode;   	  base64::uudecode;		base64.pl
+xuue;   	  base64::uudecode;		base64.pl
+uuencode;   	  base64::uudecode;		base64.pl
+</MIMEDecoders>
+
    + + diff --git a/doc/rcfileexs/frames.mrc.html b/doc/rcfileexs/frames.mrc.html new file mode 100644 index 0000000..13e9d7e --- /dev/null +++ b/doc/rcfileexs/frames.mrc.html @@ -0,0 +1,613 @@ + + +
    +<!-- ================================================================== -->
+<!--	@(#) frames.mrc 1.8 99/07/25 01:01:43
+	Earl Hood <mhonarc@pobox.com>
+  -->
+<!--	MHonArc Resource File					--
+  --									--
+  --	Description:							--
+  --									--
+  --	    This is an example of using HTML frames for an archive.	--
+  --	    This resource file also illustrates how powerful the	--
+  --	    customization features of MHonArc are while giving		--
+  --	    explanations on the use of each resource.			--
+  --									--
+  --	    The document that defines the main frames is created	--
+  --	    outside of mhonarc.  The following is a sample document	--
+  --	    that can be used:						--
+  --									--
+  --	    <html>							--
+  --	    <head>							--
+  --	    <title>Mail Archive (by MHonArc)</title>			--
+  --	    </head>							--
+  --	    <frameset cols="275,*">					--
+  --	    <frame src="threads.html" name="INDEX">			--
+  --	    <frame src="start.html" name="MAIN">			--
+  --	    </frameset>							--
+  --	    </html>							--
+  --									--
+  --	    The frame names are important since they are used in	--
+  --	    this file.  The default message in the MAIN frame is	--
+  --	    start.html: a document containing information about the	--
+  --	    the archive.  A bogus null document can be used to		--
+  --	    have the MAIN frame come up blank.				--
+  --									--
+  --		NOTE: Netscape will not properly handle frame		--
+  --		      linking if the SRC attribute is not defined	--
+  --		      to a document.  Therefore, some document		--
+  --		      should be referenced.				--
+  --									--
+  --	    The title of the archive is controlled by the MAIN-TITLE	--
+  --	    resource variable.  This variable should be defined on	--
+  --	    the command-line.  Example:					--
+  --									--
+  --	        -definevars "MAIN-TITLE='Sample Frame Archive'" ...	--
+  --									--
+<!-- ================================================================== -->
+
+<!-- ================================================================== -->
+<!-- 	Variable definitions						-->
+<!-- ================================================================== -->
+<!--
+	User defined variables are defined by the DEFINEVAR element.
+	The first line is the name of the variable and subsequent
+	lines to the close tag are the value of the variable.
+
+	User defined variables are extremely useful when the same
+	layout information occurs in multiple places.  It also
+	help centralize information that maybe likely to change.
+	
+	User defined variables can reference other variables.
+  -->
+<!-- ================================================================== -->
+
+<!-- 	Variables for frame names
+  -->
+<DefineVar>
+FRAME-MAIN
+target="MAIN"
+</DefineVar>
+
+<DefineVar>
+FRAME-IDX
+target="INDEX"
+</DefineVar>
+
+<!--	Variable for navigational links.  This defines a table of
+	buttons to link to previous and next messages and to thread
+	and date indexes.
+  -->
+<DefineVar>
+NAV-LINKS
+<table cellpadding=0 cellspacing=0 border=1 width="100%">
+<tbody>
+<tr align="center">
+<th colspan=3><strong>Thread Links</strong></th>
+<th colspan=3><strong>Date Links</strong></th>
+</tr>
+<tr align="center">
+<td>$BUTTON(TPREV)$</td>
+<td>$BUTTON(TNEXT)$</td>
+<td><a $FRAME-IDX$ href="$TIDXFNAME$#$MSGNUM$">Index</a></td>
+<td>$BUTTON(PREV)$</td>
+<td>$BUTTON(NEXT)$</td>
+<td><a $FRAME-IDX$ href="$IDXFNAME$#$MSGNUM$">Index</a></td>
+</tr>
+</tbody>
+</table>
+</DefineVar>
+
+<!--	Variable for table attributes for page links on index pages.
+  -->
+<DefineVar>
+IDXPG-TBL-LINKS-ATTRS
+width="100%" border=0 cellpadding=0 cellspacing=0
+</DefineVar>
+
+<!-- ================================================================== -->
+<!-- 	Options			 					-->
+<!-- ================================================================== -->
+
+<!--	It is good to be explicit when possible since a default
+	resource file, and/or environment variables, may be in affect.
+  -->
+<Main>
+<Thread>
+<Sort>
+<NoReverse>
+<NoTReverse>
+
+<!--	Have mhonarc generate multipage indexes with a maximum of 50
+	messages listed per page.  MULITPG requires IDXSIZE to be
+	set to a finite value to be in effect.
+  -->
+<MultiPg>
+<IdxSize>
+50
+</IdxSize>
+
+<!--	Shut-off mhonarc's adding follow-up/ref links after message.
+	This resource file defines other mechanisms for a reader
+	to navigate the archive.
+  -->
+<NoFolRefs>
+
+<!-- ================================================================== -->
+<!-- 	Derived Files		 					-->
+<!-- ================================================================== -->
+<!--
+	Derived files are defined by the DEFINEDERIVED element.
+	Derived files are extra files that should be created with
+	each message added to an archive.  The first line is the name
+	of the file to create.  The filename may (should) contain
+	variables to uniquely name it for each message.
+
+	User defined derived files are automatically removed if
+	the message they are associated with is removed.
+  -->
+<!-- ================================================================== -->
+
+<!-- 	The following derived file is the main file the index pages
+	will link to.  It defines the subframe definitions for the
+	navigational links and the message data.
+  -->
+<DefineDerived>
+frm$MSGNUM$.html
+<html>
+<head>
+<title>Message View</title>
+</head>
+<frameset rows="60,*">
+<frame src="nav$MSGNUM$.html" name="NAV"
+       frameborder=1 scrolling=no marginheight=0 marginwidth=0>
+<frame src="msg$MSGNUM$.html" name="MESSAGE"
+       frameborder=0>
+</frameset>
+</html>
+</DefineDerived>
+
+<!-- 	The following derived file defines the navigational links
+	for a message.  The links will be displayed in a frame
+	above the converted message.
+  -->
+<DefineDerived>
+nav$MSGNUM$.html
+<html>
+<head>
+<title>Message Navigation</title>
+</head>
+<body>
+$NAV-LINKS$
+</body>
+</html>
+</DefineDerived>
+
+<!-- ================================================================== -->
+<!-- 	Thread index resources						-->
+<!-- ================================================================== -->
+
+<!--	The thread index is setup where a thread will have the subject
+	in bold at the top of the thread and the names of the authors
+	of the messages in the thread will be hyperlinked to the
+	actual message.  Nested unordered lists are used to provide a
+	visual cue of the depths of the thread.
+
+	Unique messages are show in normal text.
+  -->
+
+<!--	Set the title of the thread index.
+  -->
+<TTitle chop>
+$MAIN-TITLE$ (thread)
+</TTitle>
+
+<!--	Define the appearances of the prev/next page links.
+  -->
+<TNextPgLink chop>
+<A HREF="$PG(TNEXT)$">&gt;&gt;</A>
+</TNextPgLink>
+<TNextPgLinkIA chop>
+&gt;&gt;
+</TNextPgLinkIA>
+
+<TPrevPgLink chop>
+<A HREF="$PG(TPREV)$">&lt;&lt;</A>
+</TPrevPgLink>
+<TPrevPgLinkIA chop>
+&lt;&lt;
+</TPrevPgLinkIA>
+
+<!--	Before the thread list, we will have links to the date index,
+	previous page, first page, last page, and next page.  THEAD
+	is also responsible for beginning the message listing
+	(analagous to LISTBEGIN for the main index).
+  -->
+<THead>
+<ul>
+<li><a href="$IDXFNAME$">Date Index</a></li>
+</ul>
+<hr>
+<table $IDXPG-TBL-LINKS-ATTRS$>
+<tbody>
+<tr align="center">
+<th colspan=4><small>Page $PAGENUM$ of $NUMOFPAGES$</small></th>
+<tr>
+<td align="left"><a href="$PG(TFIRST)$">&lt;&lt;&lt;&lt;</a>
+<td align="right">$PGLINK(TPREV)$
+<td align="left">$PGLINK(TNEXT)$
+<td align="right"><a href="$PG(TLAST)$">&gt;&gt;&gt;&gt;</a>
+</tbody>
+</table>
+<hr noshade size=1>
+<small>
+<ul>
+</THead>
+
+<!--	TFOOT terminates the message listing.  We also include
+	page navigational links like in TFOOT for convenience.
+  -->
+<TFoot>
+</ul>
+</small>
+<hr noshade size=1>
+<table $IDXPG-TBL-LINKS-ATTRS$>
+<tbody>
+<tr>
+<td align="left"><a href="$PG(TFIRST)$">&lt;&lt;&lt;&lt;</a>
+<td align="right">$PGLINK(TPREV)$
+<td align="left">$PGLINK(TNEXT)$
+<td align="right"><a href="$PG(TLAST)$">&gt;&gt;&gt;&gt;</a>
+<tr align="center">
+<th colspan=4><small>Page $PAGENUM$ of $NUMOFPAGES$</small></th>
+</tbody>
+</table>
+</TFoot>
+
+<!--	TTOPBEGIN is the markup for the beginning of a thread, and the
+	first message in a thread.
+  -->
+<TTopBegin>
+<!-- Top of a thread -->
+<li><a $A_NAME$><strong>$SUBJECTNA$</strong></a><br>
+<a $FRAME-MAIN$ href="frm$MSGNUM$.html">$FROMNAME$</a>
+</TTopBegin>
+
+<!--	TTOPEND is the markup for closing a main thread.
+  -->
+<TTopEnd>
+</li>
+<!-- End of a thread -->
+</TTopEnd>
+
+<!--	TLITXT is the markup for a message *within* a thread
+  -->
+<TLiTxt>
+<li><a $A_NAME$ $FRAME-MAIN$ href="frm$MSGNUM$.html">$FROMNAME$</a>
+</TLiTxt>
+
+<TLiEnd>
+</li>
+</TLiEnd>
+
+<!--	TSINGLETXT is the markup for a message not in a thread.  I.e.
+	it does not start a thread or is part of a thread.
+  -->
+<TSingleTxt>
+<li><a $A_NAME$>$SUBJECTNA$</a>,
+<a $FRAME-MAIN$ href="frm$MSGNUM$.html">$FROMNAME$</a>
+</li>
+</TSingleTxt>
+
+<!--	TSUBJECTBEG is any markup at the beginning of a sub-thread that
+	is based on the subject of the message.
+  -->
+<TSubjectBeg>
+<LI><font size="-1">Possible follow-ups</font></LI>
+</TSubjectBeg>
+
+<!--	TCONTBEGIN is used to show the continuation of a thread
+	that has been split by a page boundary.  This resource
+	is only meant to provide some informative cue for the
+	reader.  Notice, no links are defined in the resource.
+  -->
+<TContBegin>
+<LI><STRONG>$SUBJECTNA$</STRONG>, <EM>(continued)</EM>
+</TContBegin>
+
+<!--	TCONTEND closes off any markup opened by TCONTBEGIN
+	(if required).
+  -->
+<TContEnd>
+</LI>
+</TContEnd>
+
+<!--	TINDENTBEGIN is used to open a level indent in a
+	thread listing.  It is used to restart a thread that
+	has been split by a page boundary.
+  -->
+<TIndentBegin>
+<UL>
+</TIndentBegin>
+
+<!--	TINDENTEND is used to close a level opened by TINDENTBEGIN.
+  -->
+<TIndentEnd>
+</UL>
+</TIndentEnd>
+
+<!-- ================================================================== -->
+<!-- 	Main index resources						-->
+<!-- ================================================================== -->
+
+<!--	The main index is the chronological index since we have
+	specified the <SORT> element (which is the default).
+  -->
+<Title chop>
+$MAIN-TITLE$ (date)
+</Title>
+
+<!--	NEXTPGLINK and NEXTPGLINKIA control how the link to the
+	next index page is formatted.  NEXTPGLINKIA is used for
+	the last page of the index.
+  -->
+<NextPgLink chop>
+<A HREF="$PG(NEXT)$">&gt;&gt;</A>
+</NextPgLink>
+<NextPgLinkIA chop>
+&gt;&gt;
+</NextPgLinkIA>
+
+<!--	PREVPGLINK and PREVPGLINKIA control how the link to the
+	previous index page is formatted.  PREVPGLINKIA is used for
+	the first page of the index.
+  -->
+<PrevPgLink chop>
+<A HREF="$PG(PREV)$">&lt;&lt;</A>
+</PrevPgLink>
+<PrevPgLinkIA chop>
+&lt;&lt;
+</PrevPgLinkIA>
+
+<!--	LISTBEGIN defines the markup for the start of the message
+	listing.  Traditionally, the resource also defines links
+	to any other indexes for the archive.  Here, we define
+	the resource to link to the thread index, navigational
+	links to next/prev/first/last pages, and the start of
+	the unordered list for the message list.
+  -->
+<ListBegin>
+<ul>
+<li><a href="$TIDXFNAME$">Thread Index</a></li>
+</ul>
+<hr>
+<table $IDXPG-TBL-LINKS-ATTRS$>
+<tbody>
+<tr align="center">
+<th colspan=4><small>Page $PAGENUM$ of $NUMOFPAGES$</small></th>
+<tr>
+<td align="left"><a href="$PG(FIRST)$">&lt;&lt;&lt;&lt;</a>
+<td align="right">$PGLINK(PREV)$
+<td align="left">$PGLINK(NEXT)$
+<td align="right"><a href="$PG(LAST)$">&gt;&gt;&gt;&gt;</a>
+</tbody>
+</table>
+<hr noshade size=1>
+<small>
+<ul>
+</ListBegin>
+
+<!--	LISTEND defines the markup for the end of the message
+	listing.
+  -->
+<ListEnd>
+</ul>
+</small>
+<hr noshade size=1>
+<table $IDXPG-TBL-LINKS-ATTRS$>
+<tbody>
+<tr>
+<td align="left"><a href="$PG(FIRST)$">&lt;&lt;&lt;&lt;</a>
+<td align="right">$PGLINK(PREV)$
+<td align="left">$PGLINK(NEXT)$
+<td align="right"><a href="$PG(LAST)$">&gt;&gt;&gt;&gt;</a>
+<tr align="center">
+<th colspan=4><small>Page $PAGENUM$ of $NUMOFPAGES$</small></th>
+</tbody>
+</table>
+</ListEnd>
+
+<!--	LITEMPLATE defines the markup for a message list entry
+	for the main index.  Since the main index has a simple
+	flat, linear listing, LITEMPLATE defines how all entries
+	will look.
+
+	Note how I include $A_NAME$ so links from a message to
+	the index will have the index scrolled to where the
+	message is listed.
+  -->
+<LiTemplate>
+<li><a $FRAME-MAIN$ $A_NAME$
+href="frm$MSGNUM$.html"><strong>$SUBJECTNA$</strong></a>
+<ul><li>$FROMNAME$</li></ul>
+</li>
+</LiTemplate>
+
+<!-- ================================================================== -->
+<!-- 	Message Page Resources						-->
+<!-- ================================================================== -->
+
+<!--	Have the main subject header centered.
+  -->
+<SubjectHeader>
+<h2 align="center">$SUBJECTNA$</h2>
+<hr>
+</SubjectHeader>
+
+<!--	Mail header formatting.  The default header formatting is
+	overridden to use a table for formatting.
+  -->
+
+<!-- Exclude some fields from messages heads -->
+<Excs>
+subject
+xref
+</Excs>
+
+<!-- Fields labels will be in HTML strong elements -->
+<LabelStyles override>
+-default-:strong
+</LabelStyles>
+
+<!-- Field values will be in normal text -->
+<FieldStyles override>
+-default-:
+</FieldStyles>
+
+<!-- Open table markup for message header -->
+<FieldsBeg>
+<table width="100%">
+<tbody>
+</FieldsBeg>
+
+<!-- Each label starts a new row in the table -->
+<LabelBeg>
+<tr>
+<td align="right" valign="top">
+</LabelBeg>
+
+<!-- Close table cell for field label -->
+<LabelEnd>
+</td>
+</LabelEnd>
+
+<!-- Field value starts a new table cell -->
+<FldBeg>
+<td align="left">
+</FldBeg>
+
+<!-- Close value table cell and row -->
+<FldEnd>
+</td>
+</tr>
+</FldEnd>
+
+<!-- Close table body and table -->
+<FieldsEnd>
+</tbody>
+</table>
+</FieldsEnd>
+
+<!--	Define markup between mail message header and body.
+  -->
+<HeadBodySep>
+<hr noshade size=1>
+</HeadBodySep>
+
+<!--	Define message-id link markup.  We redefine it so the message-id
+	links will link to the appropriate message frame document.  Note,
+	this applies to message data.  Therefore, once a message-id
+	is converted to a link, the format of the link cannot be changed.
+	Any changes to MSGIDLINK will only affect newly create links.
+  -->
+<MsgIdLink>
+<A $FRAME-MAIN$ HREF="frm$MSGNUM$.html">$MSGID$</A>
+</MsgIdLink>
+
+<!--	Define MSGFOOT to contain a partial thread listing.  Set
+	TSLICE to have current message as the start of the listing.
+	Redefine TSLICEBEG and TSLICEEND to suit our needs.  The
+	thread formating resources used for the thread index are
+	also apply to a thread slice listing.
+  -->
+<MsgFoot>
+Partial thread listing:
+$TSLICE$
+</MsgFoot>
+
+<TSlice>
+0:4
+</TSlice>
+<TSliceBeg>
+<ul>
+</TSliceBeg>
+<TSliceEnd>
+</ul>
+</TSliceEnd>
+
+<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  -->
+<!-- 	Message navigation resources					-->
+
+<!--	We define TOPLINKS and BOTLINKS as blank since derived files
+	with frames will provide navigational links.
+	Note: A newline is needed else mhonarc will use the default
+	      values if the elements are null.
+  -->
+<TopLinks>
+
+</TopLinks>
+
+<BotLinks>
+
+</BotLinks>
+
+<!--	We define next/previous links to point to frame documents
+	created through the definederived feature.  Since (T)NEXTBUTTON,
+	(T)NEXTBUTTONIA, (T)PREVBUTTON, and (T)PREVBUTTONIA actually set
+	their corresponding resource variables, these values are
+	actually utilized in the derived navigational files.
+  -->
+<TNextButton chop>
+<a $FRAME-MAIN$ href="frm$MSGNUM(TNEXT)$.html">Next</a>
+</TNextButton>
+
+<TNextButtonIA chop>
+Next
+</TNextButtonIA>
+
+<TPrevButton chop>
+<a $FRAME-MAIN$ href="frm$MSGNUM(TPREV)$.html">Prev</a>
+</TPrevButton>
+
+<TPrevButtonIA chop>
+Prev
+</TPrevButtonIA>
+
+<NextButton chop>
+<a $FRAME-MAIN$ href="frm$MSGNUM(NEXT)$.html">Next</a>
+</NextButton>
+
+<NextButtonIA chop>
+Next
+</NextButtonIA>
+
+<PrevButton chop>
+<a $FRAME-MAIN$ href="frm$MSGNUM(PREV)$.html">Prev</a>
+</PrevButton>
+
+<PrevButtonIA chop>
+Prev
+</PrevButtonIA>
+
+<!-- ================================================================== -->
+<!--	MIME Resources							-->
+<!-- ================================================================== -->
+
+<!--	Define some options to text/plain filter.
+  -->
+<MimeArgs>
+text/plain:quote maxwidth=78
+</MimeArgs>
+
+<!--	Have iso-8859-1 data stored in binary form since Web browsers
+	use iso-8859-1 natively.  I.e.  Do not keep iso-8859-1 encoded
+	or escaped with SGML entities.
+  -->
+<DecodeHeads>
+<CharsetConverters>
+iso-8859-1:-decode-
+</CharsetConverters>
+
    + + diff --git a/doc/rcfileexs/icons.mrc.html b/doc/rcfileexs/icons.mrc.html new file mode 100644 index 0000000..6ef5f5b --- /dev/null +++ b/doc/rcfileexs/icons.mrc.html @@ -0,0 +1,77 @@ + + +
    +<!--	MHonArc resource file
+
+	icons.mrc 1.3 99/06/25
+
+	This example file makes use of the icons feature of
+	MHonArc.
+  -->
+
+<main>
+<sort>
+<nothread>
+<noreverse>
+
+<!--	Have LISTBEGIN contain last updated information
+  -->
+<listbegin>
+<address>
+Last update: $LOCALDATE$<br>
+$NUMOFMSG$ messages<br>
+</address>
+<p>
+Messages listed in chronological order.  Listing format is the following:
+<blockquote>
+<img src="/icons/gletter.gif" alt="* ">
+<strong>Subject</strong><code>  </code>
+(# of follow-ups)<code>  </code>
+<em>From</em>.
+</blockquote>
+<p>
+<hr>
+</listbegin>
+
+<!--	A compact listing template with icon usage
+  -->
+<litemplate>
+<img src="$ICONURL$" alt="* "><strong>$SUBJECT:40$</strong>
+($NUMFOLUP$) <em>$FROMNAME$</em><br>
+</litemplate>
+
+<listend>
+</listend>
+
+<labelstyles>
+-default-
+subject:strong
+from:strong
+</labelstyles>
+
+<fieldstyles>
+-default-
+subject:strong
+from:strong
+</fieldstyles>
+
+<!--	Specify icons for message types
+  -->
+<icons>
+audio/basic:/icons/gsound.gif
+image/gif:/icons/gimage.gif
+image/jpeg:/icons/gimage.gif
+image/tiff:/icons/ggraphic.gif
+multipart/alternative:/icons/gmulti.gif
+multipart/digest:/icons/gtext.gif
+multipart/mixed:/icons/gdoc2.gif
+multipart/parallel:/icons/gdoc.gif
+text/enriched:/icons/gdoc.gif
+text/html:/icons/gdoc.gif
+text/plain:/icons/gletter.gif
+unknown:/icons/gunknown.gif
+video/mpeg:/icons/gmovie.gif
+</icons>
+
    + + diff --git a/doc/rcfileexs/subject.mrc.html b/doc/rcfileexs/subject.mrc.html new file mode 100644 index 0000000..9cf4a9b --- /dev/null +++ b/doc/rcfileexs/subject.mrc.html @@ -0,0 +1,39 @@ + + +
    +<!-- MHonArc Resource File -->
+<!-- @(#) subject.mrc 99/06/25 13:25:44
+     Earl Hood <mhonarc@pobox.com>
+  -->
+<!-- This resource file utilizes the subject grouping feature of MHonArc
+     to format the main index.
+  -->
+
+<!--	Specify subject sorting.
+  -->
+<SubSort>
+
+<!--	SUBJECTBEGIN defines the markup to be printed when a new subject
+	group is started.
+  -->
+<SubjectBegin>
+<li><strong>$SUBJECTNA$</strong>
+<ul>
+</SubjectBegin>
+
+<!--	SUBJECTEND defines the markup to be printed when a subject
+	group ends.  We define it to close the <UL> opened by
+	SUBJECTBEGIN.
+  -->
+<SubjectEnd>
+</li></ul>
+</SubjectEnd>
+
+<!--	Define LITEMPLATE to display just author names.
+  -->
+<LiTemplate>
+<li><a $A_ATTR$>$FROMNAME$</a></li>
+</LiTemplate>
+
    + + diff --git a/doc/rcvars.html b/doc/rcvars.html index dc05131..51a80ee 100644 --- a/doc/rcvars.html +++ b/doc/rcvars.html @@ -1,30 +1,43 @@ -MHonArc v2.3 -- Resource Variables +MHonArc v2.4 -- Resource Variables

    -[Prev][Next][TOC][FAQ][Bugs][Home] +[Prev][Next][TOC][FAQ][Bugs][Home]

    Resource Variables

    + + + + +
    +

    Overview

    Resource variables are used to represent dynamic data in MHonArc resources. Take the following LITEMPLATE resource setting for example: -

    +

     <LiTemplate>
-<LI><STRONG>$SUBJECT$</STRONG>
-<UL><LI><EM>From</EM>: $FROM$</LI></UL>
-</LI>
+<li><strong>$SUBJECT$</strong>
+<ul><li><em>From</em>: $FROM$</li></ul>
+</li>
 </LiTemplate>
    @@ -32,7 +45,8 @@

    Resource Variables

    in the main index page. The $SUBJECT$ and $FROM$ are resource variables. $SUBJECT$ will get expanded to the current message's -subject, hyperlinked to the message page. $FROM$ will be replaced with +subject, hyperlinked to the message page. +$FROM$ will be replaced with the message's author's name and address.

    @@ -41,9 +55,9 @@

    Resource Variables

    example: 
    -<LI>Next by Date:
-<STRONG><A HREF="$MSG(NEXT)$">$SUBJECT(NEXT)$</A></STRONG>
-</LI>
+<li>Next by Date:
+<strong><a href="$MSG(NEXT)$">$SUBJECT(NEXT)$</a></strong>
+</li>

    The resource setting uses two resource variables: $MSG$ and @@ -186,7 +200,7 @@

    Resource Variable Index

    -
    mesg_spec
    +
    mesg_spec

    A message specification determines which message the variable's expanded will be based upon. Possible values are:

    @@ -195,34 +209,53 @@

    Resource Variable Index

    Value- Meaning -CUR- Current message. +CUR + - Current message. + + +FIRST + - First message listed in main index. + + +LAST + - Last message listed in main index. -FIRST- First message listed in main index. +NEXT + - Next message by main sort order. -LAST- Last message listed in main index. +PREV + - Previous message by main sort order. -NEXT- Next message by main sort order. +TEND + - Last message of current discussion thread. -PARENT- Parent message by thread. +TFIRST + - First message listed thread index. -PREV- Previous message by main sort order. +TLAST + - Last message listed thread index. -TFIRST- First message listed thread index. +TNEXT + - Next message by thread. -TLAST- Last message listed thread index. +TPARENT + - Parent message of current +thread. -TNEXT- Next message by thread. +TPREV + - Previous message by thread. -TPREV- Previous message by thread. +TTOP + - Top/root message of current discussion thread.

    "CUR" is the default if nothing is specified for @@ -231,7 +264,7 @@

    Resource Variable Index

    -
    idx_page_spec
    +
    idx_page_spec

    An index page specification denoting the index page to use when determing the value of the variable. The possible values are:

    @@ -269,7 +302,7 @@

    Resource Variable Index

    -
    time_fmt_str
    +
    time_fmt_str

    A time format string specifies how a date/time will be printed for a date/time related variable. The syntax of the format string is the same as the conversion specification as defined in @@ -292,7 +325,10 @@

    Variables

    Description: -The NAME and HREF attributes to use in an anchor to link to the archived message. The NAME attribute links the messages to the index page. +The NAME and HREF attributes to use in an anchor +to link to the archived message. +The NAME attribute provides a destination location when a message +links to the index page.
    $A_HREF$
    @@ -325,7 +361,15 @@

    Variables

    Description: -Button markup linking to a message. +Button markup linking to a message. The value of $BUTTON$ is determined +by the following resources: +NEXTBUTTON, +NEXTBUTTONIA, +PREVBUTTON, +PREVBUTTONIA, +TNEXTBUTTON, +TNEXTBUTTONIA. +
    $DATE$
    @@ -347,7 +391,7 @@

    Variables

    Description: -Message date in dd/mm/yyyy format. +Message date (according to local time) in dd/mm/yyyy format.
    $DOCURL$
    @@ -358,18 +402,21 @@

    Variables

    Description: -URL to documentation. +URL to MHonArc documentation. Value of variable set by the +DOCURL resource.
    -
    $FIRSTPG$
    +
    $ENV$
    - + - +
    Arguments:N/Avariable_name
    Description:Filename of first page of main index.The value of the environment variable specified by variable_name. +For example, $ENV(HOME)$ would expand to the value of the +HOME environment variable.

    $FROM$
    @@ -391,7 +438,33 @@

    Variables

    Description: -The e-mail address in the From: field of the message. +The full mail address in the From: field of the message. + +
    +
    $FROMADDRNAME$
    +
    + + + + + + + + +
    Arguments:mesg_spec
    Description:The username/local-part of the mail address in the From: +field of the message. For example, given the address "someuser@foo.com", +$FROMADDRNAME$ would equal "someuser".

    +
    $FROMADDRDOMAIN$
    +
    + + + + + + +
    Arguments:mesg_spec
    Description:The domain part of the mail address in the From: +field of the message. For example, given the address "someuser@foo.com", +$FROMADDRDOMAIN$ would equal "foo.com".

    $FROMNAME$
    @@ -402,18 +475,24 @@

    Variables

    Description: -The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used. +The human name of the person in the From: field of the message. +If no human name is found, the local-part specified in the mail address +is used.
    $GMTDATE$
    - + - +
    Arguments:N/Atime_fmt_str
    Description:Current GMT date.Current GMT date. +Default format of date set by the +GMTDATEFMT +resource. +

    $ICON$
    @@ -424,7 +503,8 @@

    Variables

    Description: -The context-type sensistive icon. +The context-type sensistive icon. The type of icon displayed +is determined by the ICONS resource.
    $ICONURL$
    @@ -435,7 +515,8 @@

    Variables

    Description: -The URL to the context-type sensistive icon. +The URL to the context-type sensistive icon. The URL value is +determined by the ICONS resource.
    $IDXFNAME$
    @@ -446,7 +527,13 @@

    Variables

    Description: -Filename of main index page. +Filename of main index page. The value is set by the +IDXFNAME or +IDXPREFIX and +HTMLEXT +resources. If the first page, IDXFNAME is used. For other pages, +the filename is IDXPREFIXpage-number.HTMLEXT. +
    $IDXLABEL$
    @@ -457,7 +544,8 @@

    Variables

    Description: -Label for main index page. +Label for main index page. Value set by the +IDXLABEL resource.
    $IDXPREFIX$
    @@ -468,7 +556,9 @@

    Variables

    Description: -Prefix of filenames of main index pages. +Prefix of filenames of main index pages. +Value set by the IDXPREFIX resource. +
    $IDXSIZE$
    @@ -479,7 +569,9 @@

    Variables

    Description: -Max number of messages that may be listed in index page. +Max number of messages that may be listed in index page. +Value set by the IDXSIZE resource. +
    $IDXTITLE$
    @@ -490,18 +582,9 @@

    Variables

    Description: -The title of the main index page. - -
    -
    $LASTPG$
    -
    - - - - - - - +
    Arguments:N/A
    Description:Filename of last page in of main index.The title of the main index page. +Value set by the TITLE resource. +

    $LINK$
    @@ -512,18 +595,33 @@

    Variables

    Description: -Link markup linking to a message. +Link markup linking to a message. +Value set by the +NEXTLINK, +NEXTLINKIA, +PREVLINK, +PREVLINKIA, +TNEXTLINK, +TNEXTLINKIA, +TPREVLINK, and +TPREVLINKIA +resources. +
    $LOCALDATE$
    - + - +
    Arguments:N/Atime_fmt_str
    Description:Current local date.Current local date. +Default format of date set by the +LOCALDATEFMT +resource. +

    $MMDDYYYY$
    @@ -534,7 +632,7 @@

    Variables

    Description: -Message date in mm/dd/yyyy format. +Message (local) date in mm/dd/yyyy format.
    $MSG$
    @@ -545,7 +643,11 @@

    Variables

    Description: -Filename of message. +Filename of message. Filename of the message is determined by the +following resources: +HTMLEXT, +MSGPREFIX. +
    $MSGGMTDATE$
    @@ -600,7 +702,64 @@

    Variables

    Description: -Filename prefix for message files. +Filename prefix for message files. +Value set by the +MSGPREFIX +resource. + + +
    +
    $MSGTORDNUM$
    +
    + + + + + + + + +
    Arguments:mesg_spec
    Description:The ordinal message number of the current discussion thread. Numbering +starts with the first top/root message of a thread and ends with the +last message of the thread, spanning in sub-threads. The following +illustrates how the numbering works: +
    +  1. top/root message
+    2. first follow-up to 1
+      3. first follow-up to 2
+      4. second follow-up to 2
+    5. second follow-up to 1
+      6. first follow-up to 5
+        7. first follow-up to 6
+    8. third follow-up to 1
+
    +The above contains 8 total message in the discussion thread, so numbering +goes from 1 to 8. +

    +
    $NOTE$
    +
    + + + + + + + + +
    Arguments:mesg_spec
    Description:Message annotation. If annotation text exists for the message, +the NOTE resource determines the +value of $NOTE$. When no annotation text is defined, +NOTEIA is used.

    +
    $NOTETEXT$
    +
    + + + + + + +
    Arguments:mesg_spec
    Description:Base text of message annotation. Variable should be used only +within the NOTE resource.

    $NUMFOLUP$
    @@ -611,7 +770,8 @@

    Variables

    Description: -Number of explicit follow-ups to the message. +Number of explicit follow-ups to the message. This number does +NOT include subject-based follow-ups.
    $NUMOFIDXMSG$
    @@ -622,7 +782,7 @@

    Variables

    Description: -Number of message listed. +Number of message listed for the current page.
    $NUMOFMSG$
    @@ -633,7 +793,7 @@

    Variables

    Description: -Number of messages in the archive. +Total number of messages in the archive.
    $NUMOFPAGES$
    @@ -644,7 +804,7 @@

    Variables

    Description: -Number of index pages. +Total number of index pages for a given index type.
    $ORDNUM$
    @@ -666,7 +826,11 @@

    Variables

    Description: -Pathname of archive. +Pathname of archive. +Value set by the +OUTDIR +resource. +
    $PAGENUM$
    @@ -684,22 +848,62 @@

    Variables

    - + - +
    Arguments:mesg_specidx_page_spec
    Description:Filename of an index page.Filename of an index page. +Value determined by the +HTMLEXT, +IDXFNAME, +IDXPREFIX, +TIDXFNAME, and +TIDXPREFIX +resources. Which resources are in effect depends on the current +context. +

    $PGLINK$
    - + - + + +
    Arguments:mesg_specidx_page_spec
    Description:Markup linking to a main index page.Markup linking to a main index page. +Value determined by the +NEXTPGLINK, +NEXTPGLINKIA, +PREVPGLINK, +PREVPGLINKIA, +TNEXTPGLINK, +TNEXTPGLINKIA, +TPREVPGLINK, and +TPREVPGLINKIA, +resources. The resource used depends on +idx_page_spec and context. +

    +
    $PGLINKLIST$
    +
    + + + + + + +
    Arguments:num;num
    Description:

    Markup linking to a list of index pages. $PGLINKLIST$ takes +two arguments: the first is the number of pages before the current page +to create links to; the second is the number of pages after the +current page to create links to. If either number argument is prefixed +with a 'T', then the list of links apply to the thread index. +Examples: $PGLINKLIST(3;3)$, $PGLINKLIST(T2;T3)$. The +link text for to a give page is the page number. +

    +

    $PROG$
    @@ -721,7 +925,10 @@

    Variables

    Description: -The subject text of the message wrapped in an anchor element that hyperlinks to the message. +The subject text of the message, and if no arguments, wrapped in an +anchor element that hyperlinks to the message. This behavior exists +for backwards capatibility and a simple way to provide a link to +the current message using the subject as the link text.
    $SUBJECTNA$
    @@ -743,7 +950,13 @@

    Variables

    Description: -Filename of thread index page. +Filename of thread index page. The value is set by the +TIDXFNAME or +TIDXPREFIX and +HTMLEXT +resources. If the first page, TIDXFNAME is used. For other pages, +the filename is TIDXPREFIXpage-number.HTMLEXT. +
    $TIDXLABEL$
    @@ -754,7 +967,8 @@

    Variables

    Description: -Label for thread index page. +Label for thread index page. Value set by the +TIDXLABEL resource.
    $TIDXPREFIX$
    @@ -765,7 +979,11 @@

    Variables

    Description: -Prefix of filenames of thread index pages. +Prefix of filenames of thread index pages. +Value set by the +TIDXPREFIX +resource. +
    $TIDXTITLE$
    @@ -776,7 +994,52 @@

    Variables

    Description: -Title of thread index. +The title of the thread index page. +Value set by the TTITLE resource. + + +
    +
    $TO$
    +
    + + + + + + + + +
    Arguments:N/A
    Description:The mail address. +This variable is only applicable for use in the +MAILTOURL.

    +
    $TOADDRNAME$
    +
    + + + + + + + + +
    Arguments:N/A
    Description:The username/local-part of the e-mail address. +For example, given the address "someuser@foo.com", +$TOADDRNAME$ would equal "someuser". +This variable is only applicable for use in the +MAILTOURL.

    +
    $TOADDRDOMAIN$
    +
    + + + + + + +
    Arguments:N/A
    Description:The domain part of the e-mail address. +For example, given the address "someuser@foo.com", +$TOADDRDOMAIN$ would equal "foo.com". +This variable is only applicable for use in the +MAILTOURL.

    $TSLICE$
    @@ -787,7 +1050,19 @@

    Variables

    Description: -A slice of the thread listing relative to the current message. Size of slice determined by the TSLICE resource. +A slice of the thread listing relative to the current message. +Size of slice determined by the TSLICE +resource. Layout appearance of $TSLICE$ determined by +TSLICEBEG, +TSLICEEND, +TTOPBEGIN, +TLITXT, +TLIEND, +TSINGLETXT, +TSUBJECTBEG, and +TTOPEND +resources. +
    $VERSION$
    @@ -809,7 +1084,7 @@

    Variables

    Description: -Message date in yyyy/mm/dd format. +Message (local) date in yyyy/mm/dd format.
    @@ -819,20 +1094,20 @@

    Variables

    -[Prev][Next][TOC][FAQ][Bugs][Home] +[Prev][Next][TOC][FAQ][Bugs][Home]

    -98/10/24 17:31:05
    +01/06/10 17:47:40
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@mhonarc.org
    diff --git a/doc/resources.html b/doc/resources.html index f22c4f4..304ccb3 100644 --- a/doc/resources.html +++ b/doc/resources.html @@ -1,23 +1,47 @@ -MHonArc v2.3 -- Resources +MHonArc v2.4 -- Resources

    -[Prev][Next][TOC][FAQ][Bugs][Home] +[Prev][Next][TOC][FAQ][Bugs][Home]

    Resources

    + + + + + +
    +

    Overview

    +

    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, +for short), command-line options, and/or elements in a +resource file. +For example, the MAXSIZE +resource tells +MHonArc the maximum number of messages in an archive. To set +the resource, you can use the -maxsize +command-line option, the M2H_MAXSIZE envariable, or the +<MAXSIZE> resource file element. +

    + +

    For information on the syntax and usage of MHonArc resource files, see the RCFILE resource.

    @@ -114,211 +138,231 @@

    Resource Index

    -

    Resource list

    +

    Resource list

    + +

    The following is a list of all the MHonArc resources available. +For a list of resource by envariable, resource file element, and/or +command-line option, see +Appendix: Resource Indexes. +

    -
    - +
    - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Resource NameDescriptionResourceDescription
    ADDAdd messages to the archive.
    AFSSkip archive directory permission check.
    ANNOTATEAdd/set annotation for message(s).
    ARCHIVECreate archive.
    AUTHORBEGINMarkup at the start of a author group.
    AUTHORENDMarkup at the end of a author group.
    AUTHSORTSort main index by author.
    BOTLINKSLinks markup at the bottom of message pages.
    CHARSETCONVERTERSCharater set filter functions.
    CONLENUse Content-Length value.
    DATEFIELDSList of fields to extract date of message.
    DAYBEGINMarkup at the start of a day group.
    DAYENDMarkup at the end of a day group.
    DBFILEName of archive database file.
    DECODEHEADSStore "decode-only" characters sets in raw form.
    DEFINEDERIVEDDefine extra file(s) to generate for each message page.
    DEFINEVARDefine a custom resource variable.
    DEFRCFILEPathname of default resource file.
    DEFRCNAMEName of default resource file.
    DOCAdd link to documentation.
    DOCURLURL to documentation
    EDITIDXModify archive with new resource settings.
    EXCSList of header fields to exclude.
    EXPIREAGELength of time to keep a message in an archive.
    EXPIREDATEExpiration of date of message.
    FIELDORDEROrder to display message header fields.
    FIELDSBEGBeginning markup of message header.
    FIELDSENDEnding markup of message header.
    FIELDSTYLESDefine HTML elements that wrap field text of message headers.
    FLDBEGMarkup before field text.
    FLDENDMarkup after field text.
    FOLREFSPrint links links to explicit follow-ups and references.
    FOLUPBEGINBeginning markup of follow-up links in message pages.
    FOLUPENDEnding markup of follow-up links in message pages.
    FOLUPLITXTMarkup for a follow-up link.
    FOOTERFile to include at the foot of main index pages.
    FORCEForce archive operation even if lock cannot be obtained.
    FROMFIELDSList of fields to extract author of a message.
    GENIDXGenerate a message index to standard output.
    GMTDATEFMTConversion specification for GMT dates.
    GZIPEXEPathname to gzip executable.
    GZIPFILESGzip files.
    GZIPLINKSAssume files are gzipped when creating links.
    HEADBODYSEPMarkup separating the message head from the body.
    HEADERFile to include at the top of main index pages.
    HTMLEXTExtension to use for HTML files.
    ICONSContent-type to icon mapping.
    IDXFNAMEFilename for main (first) index page.
    IDXLABELLabel for main index.
    IDXPGBEGINBeginning markup for main index pages.
    IDXPGENDEnding markup for main index pages.
    IDXPREFIXFilename prefix for multi-page main index.
    IDXSIZESize of each index page.
    INCLUDEInclude a resource file.
    LABELBEGBeginning markup of the label text of a message field.
    LABELENDEnd markup of the label text of a message field.
    LABELSTYLESDefine HTML elements to wrap message header field labels.
    LISTBEGINMarkup to begin main index message listing.
    LISTENDMarkup to end main index message listing.
    LITEMPLATEMarkup for an entry in the main index message list.
    LOCALDATEFMTConversion specification for printing local date.
    LOCKPerform a lock on the archive.
    LOCKDELAYWait time between lock attempts.
    LOCKFILEName of the lock file.
    LOCKTRIESTotal number of time to attempt a lock before failing.
    MAILTOConvert email addresses in message headers to hyperlinks.
    MAILTOURLURL template to use when MAILTO is set.
    MAINCreate main index.
    MAXSIZEMaximum number of messages in an archive.
    MHPATTERNRegex for matching message files in an MH folder (directory).
    MIMEARGSArguments to MIME filters.
    MIMEFILTERSMapping of MIME filters to content-types.
    MODTIMESet modification time on message files to message dates.
    MONTHSMonth names.
    MONTHSABRAbbreviated month names.
    MSGBODYENDMarkup after the message body.
    MSGFOOTMarkup at the foot of each message page.
    MSGGMTDATEFMTGMT conversion specification for message dates.
    MSGHEADMarkup at the head of each message page.
    MSGIDLINKHyperlink markup for embedded message-ids in message pages.
    MSGLOCALDATEFMTLocal conversion specification for message dates.
    MSGPGBEGINStarting markup for each message page.
    MSGPGENDEnding markup for each message page.
    MSGPGSPrint message pages.
    MSGPREFIXPrefix for message page filenames.
    MSGSEPRegex for matching message separator in mailbox files.
    MULTIPGCreate multi-page indexes.
    NEWSHyperlink newsgroups in message headers.
    NEXTBUTTONButton markup for next message by main index.
    NEXTBUTTONIAInactive button markup for next message by main index.
    NEXTLINKLink markup for next message by main index.
    NEXTLINKIAInactive link markup for next message by main index.
    NEXTPGLINKLink markup for next page of main index.
    NEXTPGLINKIAInactive link markup for next page of main index.
    NOTEMarkup for representing the annotation of a message.
    NOTEDIRDirectory to store annotations.
    NOTEIAMarkup when no annotation is available for a message.
    NOTETEXTAnnotation text.
    OTHERINDEXESList of alternate indexes to create for an archive.
    OUTDIRLocation of archive.
    PERLINCAdditional Perl include paths.
    PREVBUTTONButton markup for previous message by main index.
    PREVBUTTONIAInactive button markup for previous message by main index.
    PREVLINKLink markup for previous message by main index.
    PREVLINKIAInactive link markup for previous message by main index.
    PREVPGLINKLink markup for previous page of main index.
    PREVPGLINKIAInactive link markup for previous page of main index.
    QUIETDo not output status.
    RCFILEResource file to read before processing input.
    REFSBEGINBeginning markup for explicit reference links in message pages.
    REFSENDEnding markup for explicit reference links in message pages.
    REFSLITXTMarkup representing a reference entry in explicit reference links.
    REVERSEReverse the listing order in the main index.
    RMMRemove specified messages from an archive.
    SCANList archive messages to standard output.
    SINGLEProcess a single message.
    SORTList messages by date in main index.
    SUBJECTARTICLERXPRegex for matching leading articles in message subjects.
    SUBJECTBEGINBeginning markup for a subject group in the main index.
    SUBJECTENDEnding markup for a subject group in the main index.
    SUBJECTHEADERMain subject line markup above message header.
    SUBJECTREPLYRXPRegex for matching subject text denoting a reply message.
    SUBJECTSTRIPCODEPerl expressions to strip subject text while reading messages.
    SUBSORTList messages by subjext in main index.
    TCONTBEGINMarkup before the continuation of a broken thread.
    TCONTENDMarkup after the continuation of a broken thread.
    TFOOTFooter markup for thread index page.
    THEADHeader markup for thread index page.
    THREADCreate thread index.
    TIDXFNAMEFilename of first thread index page.
    TIDXLABELLabel string for the thread index.
    TIDXPGBEGINBeginning markup for the thread index pages.
    TIDXPGENDEnding markup for the thread index pages.
    TIDXPREFIXFilename prefix for thread index pages beyond the first page.
    TIMEZONESHour offsets for timezones.
    TINDENTBEGINMarkup for opening a level when continuing a broken thread.
    TINDENTENDMarkup for closing a level when continuing a broken thread.
    TITLETitle for main index.
    TLEVELSMaximum number of levels to indent in thread index.
    TLIENDEnding markup for a thread index message listing.
    TLINONEMarkup for a missing message in thread index.
    TLINONEENDEnding markup for a missing message in thread index.
    TLITXTMarkup for a thread index message listing.
    TNEXTBUTTONButton markup for next message by thread.
    TNEXTBUTTONIAInactive button markup for next message by thread.
    TNEXTLINKLink markup for next message by thread.
    TNEXTLINKIAInactive link markup for next message by thread.
    TNEXTPGLINKLink markup for next page in thread index.
    TNEXTPGLINKIAInactive link markup for next page in thread index.
    TOPLINKSMarkup for top navigational links of a message page.
    TPREVBUTTONButton markup for previous message by thread.
    TPREVBUTTONIAInactive button markup for previous message by thread.
    TPREVLINKLink markup for previous message by thread.
    TPREVLINKIAInactive link markup for previous message by thread.
    TPREVPGLINKLink markup for previous page in thread index.
    TPREVPGLINKIAInactive link markup for previous page in thread index.
    TREVERSEList thread in reverse order.
    TSINGLETXTMarkup for a thread listing with no follow-ups.
    TSLICESize of thread listing slice for message pages.
    TSLICEBEGMarkup for the start of a thread slice.
    TSLICEENDMarkup for the end of a thread slice.
    TSORTList threads by date.
    TSUBJECTBEGMarkup before a subject based thread listing.
    TSUBJECTENDMarkup after a subject based thread listing.
    TSUBLISTBEGMarkup for starting a sub-thread.
    TSUBLISTENDMarkup for ending a sub-thread.
    TSUBSORTList threads by subject.
    TTITLETitle of thread index.
    TTOPBEGINMarkup for the root/start of a thread.
    TTOPENDMarkup for the end of a thread.
    UMASKUmask value for the MHonArc process.
    USELOCALTIMEUse local time to determine day groups in main index listing.
    USINGLASTPG$LASTPG$ is used in resource values.
    WEEKDAYSWeekday names.
    WEEKDAYSABRAbbreviated weekday names.
    ADD Add messages to the archive.
    ADDRESSMODIFYCODE Perl expressions modifying displayed addresses in headers.
    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.
    CHECKNOARCHIVE Honor "no archive" flag in messages.
    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.
    KEEPONRMM Do not physically delete message files when message removed from archive.
    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.
    LOCKMETHOD How archive locks are done.
    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.
    MIMEDECODERS Content-Transfer-Encoding decoding functions.
    MIMEEXCS Content-types to exclude.
    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.
    MSGEXCFILTER Perl expression(s) to selectively exclude messages.
    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.
    POSIXSTRFTIME Use POSIX's strftime() for converted time format strings.
    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.
    SAVERESOURCES Save resource values in database.
    SCAN List archive messages to standard output.
    SINGLE Process a single message.
    SORT List messages by date in main index.
    SPAMMODE Perform actions to deter email address harvesters.
    SSMARKUP Markup at the beginning of all generated pages.
    STDERR File for standard error messages.
    STDIN File to treat as standard input.
    STDOUT File for standard output messages.
    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.
    SUBJECTTHREADS Check subjects when computing message threads.
    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.
    VARREGEX Perl regular expression matching a resource variable.
    WEEKDAYS Weekday names.
    WEEKDAYSABR Abbreviated weekday names.
    -

    -[Prev][Next][TOC][FAQ][Bugs][Home] +[Prev][Next][TOC][FAQ][Bugs][Home]

    -98/10/24 17:31:06
    +01/06/10 17:47:40
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1999, Earl Hood, mhonarc@mhonarc.org
    diff --git a/doc/resources/add.html b/doc/resources/add.html index 0be1e97..5031bb3 100644 --- a/doc/resources/add.html +++ b/doc/resources/add.html @@ -129,10 +129,10 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:12:50
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/addressmodifycode.html b/doc/resources/addressmodifycode.html new file mode 100644 index 0000000..e245e41 --- /dev/null +++ b/doc/resources/addressmodifycode.html @@ -0,0 +1,142 @@ + + + +MHonArc Resources: ADDRESSMODIFYCODE + + + +
    +MHonArc Resource List
    +
    + +
    +

    ADDRESSMODIFYCODE

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    +M2H_ADDRESSMODIFYCODE=Perl_expressions +

    +
    + +
    Element
    +


    +<ADDRESSMODIFYCODE>
    +Perl expressions...
    +</ADDRESSMODIFYCODE>
    +

    +
    + +
    Command-line Option
    +


    +-addressmodifycode Perl_expressions +

    +
    + +
    + + +
    +

    Description

    + +

    ADDRESSMODIFYCODE may be used to define Perl expressions to +apply to addresses in message headers during conversion. +

    +

    When defining the expressions, the mail address will be in +the $_ variable. The value of $_ +after all expressions are evaluated is the address MHonArc will +print. +

    + + + + + +
    NOTE

    ADDRESSMODIFYCODE only affects the display text of the +address. If MAILTO is active, the +URL of the link is NOT affected by ADDRESSMODIFYCODE. +MAILTOURL can be used to modify the +URL. +

    +
    + + +
    +

    Default Setting

    + +

    Nil. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    ADDRESSMODIFYCODE main use is to obfuscate addresses, +or hide them entirely, to +prevent spam address harvesters from getting user addresses from +MHonArc archives. Here is an example that performs a ROT13 to +provide some simple obfuscation: +

    +
    +<AddressModifyCode>
+tr/A-Za-z/N-ZA-Mn-za-m/;
+</AddressModifyCode>
+
    +

    However, this may not be enough since an intelligent harvester +may try a ROT13. To completely hide the address, do something like +this: +

    +
    +<AddressModifyCode>
+$_ = 'address@hidden';
+</AddressModifyCode>
+
    +

    You cannot rely on ADDRESSMODIFYCODE alone to +hide/obfuscate addresses (see NOTE above). +Also look at the SPAMMODE if you are +interested in fighting address harvesting. +

    + + +
    +

    Version

    + +

    2.4.0 +

    + + +
    +

    See Also

    + +

    +MAILTO, +MAILTOURL, +SPAMMODE, +

    + + +
    +
    +00/10/28 11:12:59
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/afs.html b/doc/resources/afs.html index 9f66585..e45eff5 100644 --- a/doc/resources/afs.html +++ b/doc/resources/afs.html @@ -13,6 +13,7 @@

    AFS

    +

    Syntax

    @@ -37,6 +38,7 @@

    Syntax

    +

    Description

    If AFS is set, MHonArc is skips the archive directory permission @@ -48,30 +50,35 @@

    Description

    +

    Default Setting

    Off.

    +

    Resource Variables

    N/A

    +

    Examples

    None.

    +

    Version

    2.3.0

    +

    See Also

    @@ -80,13 +87,13 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:12:55
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/annotate.html b/doc/resources/annotate.html index 6d868c7..7f86e89 100644 --- a/doc/resources/annotate.html +++ b/doc/resources/annotate.html @@ -13,6 +13,7 @@

    ANNOTATE

    +

    Syntax

    @@ -37,6 +38,7 @@

    Syntax

    +

    Description

    ANNOTATE is used to add an annotation to a message, or multiple @@ -53,18 +55,21 @@

    Description

    +

    Default Setting

    Off.

    +

    Resource Variables

    N/A

    +

    Examples

    The following adds an annotation to message 15 of an archive: @@ -138,12 +143,14 @@

    Examples

    +

    Version

    2.3.0

    +

    See Also

    @@ -155,13 +162,13 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:12:59
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/archive.html b/doc/resources/archive.html index 4101105..bcd733a 100644 --- a/doc/resources/archive.html +++ b/doc/resources/archive.html @@ -13,6 +13,7 @@

    ARCHIVE

    +

    Syntax

    @@ -30,14 +31,15 @@

    Syntax

    Command-line Option(s)


    --archive
    --noarchive +-archive
    +-noarchive

    +

    Description

    MHonArc using the ARCHIVE resource to determine if it should @@ -45,6 +47,7 @@

    Description

    +

    Default Setting

    @@ -52,122 +55,53 @@ 
    Default Setting
    +

    Resource Variables

    N/A

    +

    Examples

    The purpose of MHonArc is to create HTML archive, so why would you want to disable archiving? One potential purpose is to use MHonArc as a general MIME processing filter to extract all attachments in a -mail folder to separate files. To do this, you can define a resource -file as follows:

    - -
    -<MIMEFilters override>
-application/*;m2h_external::filter;mhexternal.pl
-audio/*;m2h_external::filter;mhexternal.pl
-image/*;m2h_external::filter;mhexternal.pl
-model/*;m2h_external::filter;mhexternal.pl
-text/*;m2h_external::filter;mhexternal.pl
-video/*;m2h_external::filter;mhexternal.pl
-</MIMEFilters>
-<MIMEArgs override>
-m2h_external::filter; usename
-</MIMEArgs>
-
    -

    For this example, let's assume this resource file is called -.mha-attach.mrc and it exists in your home directory. -

    - - - - - -
    NOTE

    You notice that we set the "usename" option to the external file -filter. Our intent is to be able to save attachments with the filename -specified in the message. If you do not want this, you can remove -the MIMEARGS resource setting. This will cause the attachments to -be saved to a unique -filename with an extenstion based upon sub-type is generated. -

    -
    -

    Now, you can create a shell alias (assuming Csh syntax) as -follows: -

    -
    -alias save-attachments 'mhonarc -noarchive -rcfile ~/mha-attach.mrc \!*'
-
    -

    So, if you want to extract all attachments to a mail folder called -"inbox" with all attachments saved to ~/tmp, you would enter -the following at your shell prompt (%): -

    -
    -    % save-attachments -outdir ~/tmp inbox
-
    - -

    Extraction of all attachments from a mail folder maybe more than -you need. You may want to just do a single message. Although the -following example has nothing to with the ARCHIVE resource, it is related -to using MHonArc as a MIME processing tool. -

    - -

    To processing a single message, we can use the same resource file -listed above. The difference is how we invoke MHonArc. If you have -the message in a file, you can do the following: -

    -
    -    % mhonarc -rcfile ~/mha-attach.mrc -single message.822 > /dev/null
-
    -

    Where message.822 is the file containing a single message. -The redirection of standard output to /dev/null -is done to discard the -HTML message text data since all we care about are the attachments saved. -

    -

    I use MH, and the version I have does not support filenames -defined for attachments. Hence, I have the following (Csh) alias -in my .cshrc file -to store all parts of a message to disk utilizing the filenames -defined in the message: -

    -
    -alias store     'show -noshowproc -noheader \!* | \\
-                mhonarc -rcfile ~/dotfile/.mhonarc.attach.mrc -single  \\
-                > /dev/null'
-
    -

    The resource file ~/dotfile/.mhonarc.attach.mrc is the -same as mha-attach.mrc in the previous examples. -

    - -

    If you have a MUA that does not support MIME, or the support is minimal, -you can use MHonArc as shown to decode and save attachments. +mail folder to separate files. Luckily, the utility program +mha-decode is +included in the MHonArc distribution to provide basic MIME message +decoding. Therefore, the lengthy example that used to be here +has been deleted. You can examine the source of mha-decode +to see how it interfaces with the MHonArc libraries and uses the +ARCHIVE resource.

    +

    Version

    2.1.2

    +

    See Also

    +mha-decode

    -98/09/27 16:56:01
    +00/10/28 11:12:59
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/authorbegin.html b/doc/resources/authorbegin.html index b557553..6020647 100644 --- a/doc/resources/authorbegin.html +++ b/doc/resources/authorbegin.html @@ -29,7 +29,6 @@

    Syntax

    <AUTHORBEGIN>
    markup ...
    </AUTHORBEGIN>
    -

    @@ -69,7 +68,6 @@

    Default Setting

    Resource Variables

    - @@ -94,6 +92,10 @@

    Resource Variables

    + + + + @@ -102,6 +104,14 @@

    Resource Variables

    + + + + + + + + @@ -138,6 +148,14 @@

    Resource Variables

    + + + + + + + + @@ -147,7 +165,7 @@

    Resource Variables

    - + @@ -157,7 +175,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -205,13 +222,13 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:12:59
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/authorend.html b/doc/resources/authorend.html index e3ff170..7264dc1 100644 --- a/doc/resources/authorend.html +++ b/doc/resources/authorend.html @@ -29,7 +29,6 @@

    Syntax

    <AUTHOREND>
    markup ...
    </AUTHOREND>
    -

    @@ -91,13 +90,13 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:12:59
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/authsort.html b/doc/resources/authsort.html index 58e06e7..c930b4a 100644 --- a/doc/resources/authsort.html +++ b/doc/resources/authsort.html @@ -28,7 +28,6 @@

    Syntax


    <AUTHSORT>
    <NOAUTHSORT>
    -

    @@ -89,13 +88,13 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:12:59
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/botlinks.html b/doc/resources/botlinks.html index 37d6d50..8ef6818 100644 --- a/doc/resources/botlinks.html +++ b/doc/resources/botlinks.html @@ -62,8 +62,8 @@

    Default Setting

    <BotLinks> <HR> <UL> -$PREVLINK$$NEXTLINK$ -$TPREVLINK$$TNEXTLINK$ +$LINK(PREV)$$LINK(NEXT)$ +$LINK(TPREV)$$LINK(TNEXT)$ <LI>Index(es): <UL> <LI><A HREF="$IDXFNAME$#$MSGNUM$"> @@ -81,7 +81,6 @@

    Default Setting

    Resource Variables

    - @@ -102,8 +101,8 @@

    Resource Variables

    - - + + @@ -114,6 +113,14 @@

    Resource Variables

    + + + + + + + + @@ -150,10 +157,6 @@

    Resource Variables

    - - - - @@ -190,6 +193,14 @@

    Resource Variables

    + + + + + + + + @@ -214,6 +225,10 @@

    Resource Variables

    + + + + @@ -245,7 +260,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -282,10 +296,10 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:12:59
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/charsetconverters.html b/doc/resources/charsetconverters.html index ef01ba8..70053d0 100644 --- a/doc/resources/charsetconverters.html +++ b/doc/resources/charsetconverters.html @@ -26,7 +26,7 @@

    Syntax

    Element


    <CHARSETCONVERTERS>
    -charset-filter-specification +charset-filter-specification
    </CHARSETCONVERTERS>

    @@ -171,6 +171,13 @@

    Default Setting

    iso-8859-8; iso_8859::str2sgml; iso8859.pl iso-8859-9; iso_8859::str2sgml; iso8859.pl iso-8859-10; iso_8859::str2sgml; iso8859.pl +iso-2022-jp; iso_2022_jp::str2html; iso2022jp.pl +latin1; mhonarc::htmlize; +latin2; iso_8859::str2sgml; iso8859.pl +latin3; iso_8859::str2sgml; iso8859.pl +latin4; iso_8859::str2sgml; iso8859.pl +latin5; iso_8859::str2sgml; iso8859.pl +latin6; iso_8859::str2sgml; iso8859.pl default; -ignore- </CharsetConverters> @@ -210,6 +217,7 @@

    See Also

    DECODEHEADS, +MIMEDECODERS, MIMEFILTERS, PERLINC

    @@ -217,10 +225,10 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/checknoarchive.html b/doc/resources/checknoarchive.html new file mode 100644 index 0000000..3f7933c --- /dev/null +++ b/doc/resources/checknoarchive.html @@ -0,0 +1,108 @@ + + + +MHonArc Resources: CHECKNOARCHIVE + + + +
    +MHonArc Resource List
    +
    + +
    +

    CHECKNOARCHIVE

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    +M2H_CHECKNOARCHIVE=[ 0 | 1 ] +

    +
    + +
    Element
    +


    +<CHECKNOARCHIVE>
    +<NOCHECKNOARCHIVE>
    +

    +
    + +
    Command-line Option
    +


    +-checknoarchive
    +-nochecknoarchive +

    +
    + +
    + + +
    +

    Description

    + +

    If CHECKNOARCHIVE is set, MHonArc will check each message for +the "no archive" flag. If present, MHonArc will not add the message +to the archive. MHonArc looks for one of the following in a message +header to determine if message should not be archived. +

    +
    +    X-no-archive: yes
+    Restrict: no-external-archive
+
    +

    If either header field is present with the given value, and +CHECKNOARCHIVE is set, MHonArc will skip the message. +

    + + +
    +

    Default Setting

    + +

    Off. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    None. +

    + + +
    +

    Version

    + +

    2.4.0 +

    + + +
    +

    See Also

    + +

    +

    + + +
    +
    +00/10/28 11:13:00
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/conlen.html b/doc/resources/conlen.html index 85f5365..85904e9 100644 --- a/doc/resources/conlen.html +++ b/doc/resources/conlen.html @@ -91,10 +91,10 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:12:59
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/datefields.html b/doc/resources/datefields.html index 590d00c..f0281c9 100644 --- a/doc/resources/datefields.html +++ b/doc/resources/datefields.html @@ -100,13 +100,13 @@

    See Also

    -98/09/19 18:27:07
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/daybegin.html b/doc/resources/daybegin.html index a1aa75d..f498866 100644 --- a/doc/resources/daybegin.html +++ b/doc/resources/daybegin.html @@ -29,7 +29,6 @@

    Syntax

    <DAYBEGIN>
    markup ...
    </DAYBEGIN>
    -

    @@ -69,7 +68,6 @@

    Default Setting

    Resource Variables

    - @@ -94,6 +92,10 @@

    Resource Variables

    + + + + @@ -102,6 +104,14 @@

    Resource Variables

    + + + + + + + + @@ -138,6 +148,14 @@

    Resource Variables

    + + + + + + + + @@ -147,7 +165,7 @@

    Resource Variables

    - + @@ -157,7 +175,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -170,22 +187,22 @@

    Examples

    -<Sort>
-<MsgLocalDateFmt>
+<Sort>
+<MsgGMTDateFmt>
 %B %d, %Y
-</MsgLocalDateFmt>
+</MsgGMTDateFmt>
 
-<DayBegin>
-<li><strong>$MSGGMTDATE$</strong>
-<ul>
-</DayBegin>
+<DayBegin>
+<li><strong>$MSGGMTDATE$</strong>
+<ul>
+</DayBegin>
 
 <DayEnd>
-</li></ul>
-</DayEnd>
+</li></ul>
+</DayEnd>
 
-<LITemplate>
-<li>$SUBJECT$, $FROMNAME$</li>
+<LITemplate>
+<li>$SUBJECT$, $FROMNAME$</li>
 </LITemplate>
    @@ -209,13 +226,13 @@

    See Also

    -98/10/10 15:29:28
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/dayend.html b/doc/resources/dayend.html index db34405..9b4f947 100644 --- a/doc/resources/dayend.html +++ b/doc/resources/dayend.html @@ -29,7 +29,6 @@

    Syntax

    <DAYEND>
    markup ...
    </DAYEND>
    -

    @@ -91,13 +90,13 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/dbfile.html b/doc/resources/dbfile.html index 122a515..c3db4ff 100644 --- a/doc/resources/dbfile.html +++ b/doc/resources/dbfile.html @@ -96,10 +96,10 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/decodeheads.html b/doc/resources/decodeheads.html index d3dbf01..7991d4c 100644 --- a/doc/resources/decodeheads.html +++ b/doc/resources/decodeheads.html @@ -99,10 +99,10 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/definederived.html b/doc/resources/definederived.html index 4badcc5..59c8b4c 100644 --- a/doc/resources/definederived.html +++ b/doc/resources/definederived.html @@ -64,7 +64,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +84,8 @@

    Resource Variables

    - - + + @@ -97,6 +96,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +140,6 @@

    Resource Variables

    - - - - @@ -173,6 +176,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +208,10 @@

    Resource Variables

    + + + + @@ -228,7 +243,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -322,10 +336,10 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/definevar.html b/doc/resources/definevar.html index d7bc7fb..f91c96b 100644 --- a/doc/resources/definevar.html +++ b/doc/resources/definevar.html @@ -151,10 +151,10 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/defrcfile.html b/doc/resources/defrcfile.html index 27382bd..3a9affb 100644 --- a/doc/resources/defrcfile.html +++ b/doc/resources/defrcfile.html @@ -98,13 +98,13 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/defrcname.html b/doc/resources/defrcname.html index 28b6359..2dc38d8 100644 --- a/doc/resources/defrcname.html +++ b/doc/resources/defrcname.html @@ -77,13 +77,13 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/doc.html b/doc/resources/doc.html index 584330a..1fda2a5 100644 --- a/doc/resources/doc.html +++ b/doc/resources/doc.html @@ -87,10 +87,10 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:12:59
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/docurl.html b/doc/resources/docurl.html index 7301544..68e8df3 100644 --- a/doc/resources/docurl.html +++ b/doc/resources/docurl.html @@ -53,7 +53,7 @@

    Description

    Default Setting

    -

    http://www.oac.uci.edu/indiv/ehood/mhonarc.html +

    http://www.pobox.com/~ehood/mhonarc.html

    @@ -88,10 +88,10 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/editidx.html b/doc/resources/editidx.html index 3e2ab03..b0622cb 100644 --- a/doc/resources/editidx.html +++ b/doc/resources/editidx.html @@ -85,10 +85,10 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/excs.html b/doc/resources/excs.html index 0e2d11f..5681019 100644 --- a/doc/resources/excs.html +++ b/doc/resources/excs.html @@ -142,10 +142,10 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/expireage.html b/doc/resources/expireage.html index 11b9a64..88eb6eb 100644 --- a/doc/resources/expireage.html +++ b/doc/resources/expireage.html @@ -58,9 +58,8 @@

    Description

    - - + @@ -74,7 +73,6 @@

    Description

    -
    Time periodEquivalance in secondsTime periodEquivalence in seconds
    day86400
    year (365 days)31536000
    @@ -137,13 +135,13 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/expiredate.html b/doc/resources/expiredate.html index d8950bf..e82286f 100644 --- a/doc/resources/expiredate.html +++ b/doc/resources/expiredate.html @@ -134,13 +134,13 @@

    See Also

    -98/09/19 18:27:08
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/fieldorder.html b/doc/resources/fieldorder.html index 26caf07..201b601 100644 --- a/doc/resources/fieldorder.html +++ b/doc/resources/fieldorder.html @@ -126,10 +126,10 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/fieldsbeg.html b/doc/resources/fieldsbeg.html index b304b3d..d9d6258 100644 --- a/doc/resources/fieldsbeg.html +++ b/doc/resources/fieldsbeg.html @@ -73,33 +73,31 @@

    Examples

    -<Fieldsbeg>
-<table border=0>
-<tbody>
-</FieldsBeg>
+<FieldsBeg>
+<table border=0>
+</FieldsBeg>
  
-<LabelBeg>
-<tr>
-<td align="right" valign="top">
-</LabelBeg>
+<LabelBeg>
+<tr>
+<td align="right" valign="top">
+</LabelBeg>
  
 <LabelEnd>
-</td>
-</LabelEnd>
+</td>
+</LabelEnd>
  
-<FldBeg>
-<td align="left">
-</FldBeg>
+<FldBeg>
+<td align="left">
+</FldBeg>
  
-<FldEnd>
-</td>
-</tr>
-</FldEnd>
+<FldEnd>
+</td>
+</tr>
+</FldEnd>
  
-<FieldsEnd>
-</tbody>
-</table>
-</FieldsEnd>
+<FieldsEnd>
+</table>
+</FieldsEnd>
    @@ -128,10 +126,10 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/fieldsend.html b/doc/resources/fieldsend.html index 8cf475e..a5c614a 100644 --- a/doc/resources/fieldsend.html +++ b/doc/resources/fieldsend.html @@ -98,10 +98,10 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/fieldstyles.html b/doc/resources/fieldstyles.html index 2577e41..4e871d3 100644 --- a/doc/resources/fieldstyles.html +++ b/doc/resources/fieldstyles.html @@ -122,10 +122,10 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/fldbeg.html b/doc/resources/fldbeg.html index a4a8e73..ad651c1 100644 --- a/doc/resources/fldbeg.html +++ b/doc/resources/fldbeg.html @@ -94,10 +94,10 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/fldend.html b/doc/resources/fldend.html index 1047e63..bc28115 100644 --- a/doc/resources/fldend.html +++ b/doc/resources/fldend.html @@ -94,10 +94,10 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/folrefs.html b/doc/resources/folrefs.html index 26ca57b..4a1cef8 100644 --- a/doc/resources/folrefs.html +++ b/doc/resources/folrefs.html @@ -96,10 +96,10 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/folupbegin.html b/doc/resources/folupbegin.html index d23f7b4..a9db891 100644 --- a/doc/resources/folupbegin.html +++ b/doc/resources/folupbegin.html @@ -114,11 +114,11 @@

    See Also

    98/03/03 18:19:32
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/folupend.html b/doc/resources/folupend.html index ea5d980..af097b6 100644 --- a/doc/resources/folupend.html +++ b/doc/resources/folupend.html @@ -95,13 +95,13 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/foluplitxt.html b/doc/resources/foluplitxt.html index 3a9cfba..a15cdc2 100644 --- a/doc/resources/foluplitxt.html +++ b/doc/resources/foluplitxt.html @@ -67,7 +67,6 @@

    Default Setting

    Resource Variables

    - @@ -92,6 +91,10 @@

    Resource Variables

    + + + + @@ -100,6 +103,14 @@

    Resource Variables

    + + + + + + + + @@ -136,6 +147,14 @@

    Resource Variables

    + + + + + + + + @@ -145,7 +164,7 @@

    Resource Variables

    - + @@ -155,7 +174,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -185,13 +203,13 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/footer.html b/doc/resources/footer.html index 7297dab..62f4761 100644 --- a/doc/resources/footer.html +++ b/doc/resources/footer.html @@ -111,10 +111,10 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/force.html b/doc/resources/force.html index 4bc4ad5..4aa70df 100644 --- a/doc/resources/force.html +++ b/doc/resources/force.html @@ -125,13 +125,13 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:00
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/fromfields.html b/doc/resources/fromfields.html index 8abf623..c647e02 100644 --- a/doc/resources/fromfields.html +++ b/doc/resources/fromfields.html @@ -13,6 +13,7 @@

    FROMFIELDS

    +

    Syntax

    @@ -46,6 +47,7 @@

    Syntax

    +

    Description

    FROMFIELDS specify the message header fields MHonArc will search to @@ -58,31 +60,43 @@

    Description

    +

    Default Setting

    -from:reply-to:apparently-from
+from:mail-reply-to:reply-to:return-path:apparently-from:sender:resent-sender
    +

    This resource is intended to reflect who the author is and not necessarily +where replies of the message should be directed. This is why the +From: field has higher precendence than the reply-to fields. +However, if it is desired that it reflect where replies should be +directed, then put mail-reply-to and reply-to first. +

    + +

    Resource Variables

    N/A

    +

    Examples

    None.

    +

    Version

    2.1.2

    +

    See Also

    DATEFIELDS @@ -91,13 +105,13 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/genidx.html b/doc/resources/genidx.html index 43fed8b..d848fea 100644 --- a/doc/resources/genidx.html +++ b/doc/resources/genidx.html @@ -91,13 +91,13 @@

    See Also

    -98/09/19 18:27:09
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/gmtdatefmt.html b/doc/resources/gmtdatefmt.html index f780fbd..cefa6d1 100644 --- a/doc/resources/gmtdatefmt.html +++ b/doc/resources/gmtdatefmt.html @@ -56,8 +56,19 @@

    Description

    The following lists the possible conversion specifications:

    + + + + + +
    NOTE

    If POSIXSTRFTIME is set, +the POSIX::strftime() function will be used. Therefore, there may be +more conversion specifications available. See your system's +strftime() manpage for specifics. +

    +
    + - @@ -138,8 +149,6 @@

    Description

    - -
    Spec Value %Y year, including the century (for example 1993)

    Setting GMTDATEFMT to a blank string will reset the resource @@ -151,7 +160,7 @@

    Description

    Default Setting

    -%a %b %d %H:%M:%S GMT %y
+%a %b %d %H:%M:%S GMT %Y
    @@ -193,6 +202,7 @@

    See Also

    MONTHSABR, MSGGMTDATEFMT, MSGLOCALDATEFMT, +POSIXSTRFTIME, WEEKDAYS, WEEKDAYSABR

    @@ -200,10 +210,10 @@

    See Also

    -98/03/03 18:19:34
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/gzipexe.html b/doc/resources/gzipexe.html index 85ee871..9fe0a2f 100644 --- a/doc/resources/gzipexe.html +++ b/doc/resources/gzipexe.html @@ -96,13 +96,13 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/gzipfiles.html b/doc/resources/gzipfiles.html index f0f2887..3dafac5 100644 --- a/doc/resources/gzipfiles.html +++ b/doc/resources/gzipfiles.html @@ -104,13 +104,13 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/gziplinks.html b/doc/resources/gziplinks.html index ad29001..755a114 100644 --- a/doc/resources/gziplinks.html +++ b/doc/resources/gziplinks.html @@ -87,13 +87,13 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/headbodysep.html b/doc/resources/headbodysep.html index 2c7dd62..b81b656 100644 --- a/doc/resources/headbodysep.html +++ b/doc/resources/headbodysep.html @@ -46,16 +46,6 @@

    Description

    and the message body.

    -
    -
    NOTE
    -

    If HEADBODYSEP is changed, -the existing messages in the archive will not get changed, even -if the EDITIDX resource is on. All -new messages will contain the new setting. -

    -
    -
    -

    Default Setting

    @@ -69,11 +59,14 @@

    Default Setting

    Resource Variables

    - + + + + @@ -82,6 +75,14 @@

    Resource Variables

    + + + + + + + + @@ -90,14 +91,66 @@

    Resource Variables

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -110,18 +163,81 @@

    Resource Variables

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -
    VariableValue
    $BUTTON$Button markup linking to a message.
    $DATE$ The date of the message.
    Message date in dd/mm/yyyy format.
    $DOCURL$URL to documentation.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    $GMTDATE$Current GMT date.
    $ICON$The context-type sensistive icon.
    $ICONURL$The URL to the context-type sensistive icon.
    $IDXFNAME$Filename of main index page.
    $IDXLABEL$Label for main index page.
    $IDXPREFIX$Prefix of filenames of main index pages.
    $IDXSIZE$Max number of messages that may be listed in index page.
    $IDXTITLE$The title of the main index page.
    $LINK$Link markup linking to a message.
    $LOCALDATE$Current local date.
    $MMDDYYYY$ Message date in mm/dd/yyyy format.
    $MSG$Filename of message.
    $MSGGMTDATE$ GMT date of current message.
    Local date of current message.
    $MSGNUM$The message number assigned to the message by MHonArc (includes leading zeros).
    $MSGPREFIX$ Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$Number of explicit follow-ups to the message.
    $NUMOFMSG$Number of messages in the archive.
    $NUMOFPAGES$Number of index pages.
    $ORDNUM$The current listing number of the message.
    $OUTDIR$Pathname of archive.
    $PROG$Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $TIDXFNAME$Filename of thread index page.
    $TIDXLABEL$Label for thread index page.
    $TIDXPREFIX$Prefix of filenames of thread index pages.
    $TIDXTITLE$Title of thread index.
    $TSLICE$A slice of the thread listing relative to the current message. Size of slice determined by the TSLICE resource.
    $VERSION$Program version.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -149,10 +265,11 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/header.html b/doc/resources/header.html index 6e61e84..27024d4 100644 --- a/doc/resources/header.html +++ b/doc/resources/header.html @@ -112,10 +112,10 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/htmlext.html b/doc/resources/htmlext.html index 17b1183..4958e60 100644 --- a/doc/resources/htmlext.html +++ b/doc/resources/htmlext.html @@ -95,13 +95,13 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/icons.html b/doc/resources/icons.html index 1e06b69..fcf95f3 100644 --- a/doc/resources/icons.html +++ b/doc/resources/icons.html @@ -153,10 +153,10 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:01
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/idxfname.html b/doc/resources/idxfname.html index 065582c..3fcb33b 100644 --- a/doc/resources/idxfname.html +++ b/doc/resources/idxfname.html @@ -90,10 +90,10 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/idxlabel.html b/doc/resources/idxlabel.html index 8c8883d..f416727 100644 --- a/doc/resources/idxlabel.html +++ b/doc/resources/idxlabel.html @@ -29,7 +29,6 @@

    Syntax

    <IDXLABEL>
    markup ... </IDXLABEL>
    -

    @@ -96,13 +95,13 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/idxpgbegin.html b/doc/resources/idxpgbegin.html index ba6039f..4e0bb86 100644 --- a/doc/resources/idxpgbegin.html +++ b/doc/resources/idxpgbegin.html @@ -73,7 +73,6 @@

    Default Setting

    Resource Variables

    - @@ -82,8 +81,8 @@

    Resource Variables

    - - + + @@ -110,10 +109,6 @@

    Resource Variables

    - - - - @@ -143,7 +138,11 @@

    Resource Variables

    - + + + + + @@ -169,7 +168,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $PGLINK$Markup linking to a main index page.Markup linking to an index page.
    $PGLINKLIST$List of links to index pages.
    $PROG$ $VERSION$ Program version.
    @@ -213,10 +211,10 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/idxpgend.html b/doc/resources/idxpgend.html index 2dfcc0f..cfcaf95 100644 --- a/doc/resources/idxpgend.html +++ b/doc/resources/idxpgend.html @@ -62,7 +62,6 @@

    Default Setting

    Resource Variables

    - @@ -71,8 +70,8 @@

    Resource Variables

    - - + + @@ -99,10 +98,6 @@

    Resource Variables

    - - - - @@ -132,7 +127,11 @@

    Resource Variables

    - + + + + + @@ -158,7 +157,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $PGLINK$Markup linking to a main index page.Markup linking to an index page.
    $PGLINKLIST$List of links to index pages.
    $PROG$ $VERSION$ Program version.
    @@ -188,10 +186,10 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/idxprefix.html b/doc/resources/idxprefix.html index 5009c4a..862280e 100644 --- a/doc/resources/idxprefix.html +++ b/doc/resources/idxprefix.html @@ -104,10 +104,10 @@

    See Also

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/idxsize.html b/doc/resources/idxsize.html index 94bf7c2..61d05c1 100644 --- a/doc/resources/idxsize.html +++ b/doc/resources/idxsize.html @@ -85,17 +85,17 @@

    Version

    See Also

    -MAXSIZE, +MAXSIZE, MULTIPG

    -98/09/19 18:27:10
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/include.html b/doc/resources/include.html index dd69efa..928df97 100644 --- a/doc/resources/include.html +++ b/doc/resources/include.html @@ -101,10 +101,10 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/keeponrmm.html b/doc/resources/keeponrmm.html new file mode 100644 index 0000000..20703a0 --- /dev/null +++ b/doc/resources/keeponrmm.html @@ -0,0 +1,128 @@ + + + +MHonArc Resources: KEEPONRMM + + + +
    +MHonArc Resource List
    +
    + +
    +

    KEEPONRMM

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    +M2H_KEEPONRMM=[ 0 | 1 ] +

    +
    + +
    Element
    +


    +<KEEPONRMM>
    +<NOKEEPONRMM>
    +

    +
    + +
    Command-line Option
    +


    +-keeponrmm +-nokeeponrmm +

    +
    + +
    + + +
    +

    Description

    + +

    If KEEPONRMM is set, message files will not be deleted from +the file system when a message is removed from an archive. This option +is useful if you are using a search engine to index archives and +you still want old messages to be searchable but not part of the +browsable indexes. This is a benefit for large archives that want to +allow access to old messages but without taking the overhead of +long archive updates. +

    + +

    The KEEPONRMM applies to messages removed via the +RMM resource or by automatic deletions performed +enforcing +MAXSIZE, +EXPIREAGE, and +EXPIREDATE, +

    + + + + + + +
    NOTE

    KEEPONRMM resource is stored in the database file. Therefore, +when set on an archive update, or creation, message files will +not be physically deleted for all future archive message removals +until KEEPONRMM is explicitly disabled. +

    +
    + + +
    +

    Default Setting

    + +

    Off. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    None. +

    + + +
    +

    Version

    + +

    2.4.8 +

    + + +
    +

    See Also

    + +

    +EXPIREAGE, +EXPIREDATE, +MAXSIZE, +RMM +

    + + +
    +
    +01/04/13 12:32:44
    + +MHonArc
    +Copyright © 2001, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/labelbeg.html b/doc/resources/labelbeg.html index 487b858..d1d3ac4 100644 --- a/doc/resources/labelbeg.html +++ b/doc/resources/labelbeg.html @@ -96,10 +96,10 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/labelend.html b/doc/resources/labelend.html index dedc196..170d938 100644 --- a/doc/resources/labelend.html +++ b/doc/resources/labelend.html @@ -96,10 +96,10 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/labelstyles.html b/doc/resources/labelstyles.html index 6606411..50e7f8d 100644 --- a/doc/resources/labelstyles.html +++ b/doc/resources/labelstyles.html @@ -123,10 +123,10 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/listbegin.html b/doc/resources/listbegin.html index 2f27c23..70d4b1c 100644 --- a/doc/resources/listbegin.html +++ b/doc/resources/listbegin.html @@ -86,7 +86,6 @@

    Default Setting

    Resource Variables

    - @@ -95,8 +94,8 @@

    Resource Variables

    - - + + @@ -123,10 +122,6 @@

    Resource Variables

    - - - - @@ -156,7 +151,11 @@

    Resource Variables

    - + + + + + @@ -182,7 +181,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $PGLINK$Markup linking to a main index page.Markup linking to an index page.
    $PGLINKLIST$List of links to index pages.
    $PROG$ $VERSION$ Program version.
    @@ -234,10 +232,10 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/listend.html b/doc/resources/listend.html index e165e75..230e6db 100644 --- a/doc/resources/listend.html +++ b/doc/resources/listend.html @@ -65,7 +65,6 @@

    Default Setting

    Resource Variables

    - @@ -74,8 +73,8 @@

    Resource Variables

    - - + + @@ -102,10 +101,6 @@

    Resource Variables

    - - - - @@ -135,7 +130,11 @@

    Resource Variables

    - + + + + + @@ -161,7 +160,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $PGLINK$Markup linking to a main index page.Markup linking to an index page.
    $PGLINKLIST$List of links to index pages.
    $PROG$ $VERSION$ Program version.
    @@ -190,10 +188,10 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/litemplate.html b/doc/resources/litemplate.html index 2dfc2a5..c4968ed 100644 --- a/doc/resources/litemplate.html +++ b/doc/resources/litemplate.html @@ -67,7 +67,6 @@

    Default Setting

    Resource Variables

    - @@ -92,6 +91,10 @@

    Resource Variables

    + + + + @@ -100,6 +103,14 @@

    Resource Variables

    + + + + + + + + @@ -136,6 +147,14 @@

    Resource Variables

    + + + + + + + + @@ -145,7 +164,7 @@

    Resource Variables

    - + @@ -155,7 +174,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -193,10 +211,10 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/localdatefmt.html b/doc/resources/localdatefmt.html index f7380bc..a97063f 100644 --- a/doc/resources/localdatefmt.html +++ b/doc/resources/localdatefmt.html @@ -56,8 +56,19 @@

    Description

    The following lists the possible conversion specifications:

    + + + + + +
    NOTE

    If POSIXSTRFTIME is set, +the POSIX::strftime() function will be used. Therefore, there may be +more conversion specifications available. See your system's +strftime() manpage for specifics. +

    +
    + - @@ -139,7 +150,6 @@

    Description

    -
    Spec Value year, including the century (for example 1993)

    Setting LOCALDATEFMT to a blank string will reset the resource @@ -151,7 +161,7 @@

    Description

    Default Setting

    -%a %b %d %H:%M:%S %y
+%a %b %d %H:%M:%S %Y
    @@ -193,6 +203,7 @@

    See Also

    MONTHSABR, MSGGMTDATEFMT, MSGLOCALDATEFMT, +POSIXSTRFTIME, WEEKDAYS, WEEKDAYSABR

    @@ -200,10 +211,10 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/lock.html b/doc/resources/lock.html index 1697411..6ca67c3 100644 --- a/doc/resources/lock.html +++ b/doc/resources/lock.html @@ -13,6 +13,7 @@

    LOCK

    +

    Syntax

    @@ -29,7 +30,7 @@

    Syntax

    Command-line Option


    --lock +-lock
    -nolock

    @@ -37,6 +38,7 @@

    Syntax

    +

    Description

    When LOCK is On, MHonArc performs attempts to create a lock @@ -62,48 +64,54 @@

    Description

    +

    Default Setting

    On.

    +

    Resource Variables

    N/A

    +

    Examples

    None.

    +

    Version

    2.3.0

    +

    See Also

    FORCE, LOCKDELAY, +LOCKMETHOD, LOCKTRIES

    -98/09/19 18:27:11
    +00/10/28 11:13:02
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999 Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/lockdelay.html b/doc/resources/lockdelay.html index a529ee0..d77ceb8 100644 --- a/doc/resources/lockdelay.html +++ b/doc/resources/lockdelay.html @@ -90,13 +90,13 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/lockfile.html b/doc/resources/lockfile.html index f9a962f..c621b09 100644 --- a/doc/resources/lockfile.html +++ b/doc/resources/lockfile.html @@ -13,77 +13,101 @@

    LOCKFILE

    +

    Syntax

    Envariable

    -M2H_LOCKFILE= +M2H_LOCKFILE=name

    Element
    -


    -<LOCKFILE>
    -</LOCKFILE>
    +

    N/A

    Command-line Option

    --lockfile +-lockfile name

    +

    Description

    -

    +

    LOCKFILE is the name of the file used to create a lock on an +archive. The file is used in the archive directory to signify +that a MHonArc process is accessing the archive, and any other +MHonArc process will wait until the lock is released.

    + + + + + +
    WARNING

    You should not override the default name unless +absolutely necessary, and you are confident about what you are doing. +

    +
    + +

    Default Setting

    -

    +

    .mhonarc.lck
    +mhonarc.lck (Windows/MSDOS)
    +mhonarc_lck (VMS)

    +

    Resource Variables

    N/A

    +

    Examples

    None.

    +

    Version

    -

    +

    1.2

    +

    See Also

    +LOCK, +LOCKDELAY, +LOCKMETHOD, +LOCKTRIES

    -98/09/19 18:27:11
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-2000, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/lockmethod.html b/doc/resources/lockmethod.html new file mode 100644 index 0000000..886f127 --- /dev/null +++ b/doc/resources/lockmethod.html @@ -0,0 +1,246 @@ + + + +MHonArc Resources: LOCKMETHOD + + + +
    +MHonArc Resource List
    +
    + +
    +

    LOCKMETHOD

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    +M2H_LOCKMETHOD=method +

    +
    + +
    Element
    +


    +<LOCKMETHOD>
    +method
    +</LOCKMETHOD>
    +

    +
    + +
    Command-line Option
    +


    +-lockmethod method +

    +
    + +
    + + +
    +

    Description

    + +

    LOCKMETHOD determines how MHonArc should lock archives to protect +multiple MHonArc processes modifying an archive at the same time. If +after reading this page you still are unsure on what method to use, or +do not understand some of the material, then just stick with the default +value. +

    + +

    The following is a list of possible values for LOCKMETHOD: +

    +
    + +
    directory
    +

    MHonArc uses a directory file in the archive directory to +lock an archive. When MHonArc is to access/modify an archive, it +will first try to create a directory in the archive directory +with a name determined by the +LOCKFILE resource. MHonArc will try +LOCKTRIES times to create +the directory (obtains the lock) before timing out. +

    +
    + +
    flock
    +

    MHonArc will use Perl's flock() operator. +LOCKFILE will be created in the archive +directory if does not already exist. Then MHonArc will try to +LOCKTRIES times to obtain +an exclusive lock on the file via flock() before timing out. +

    +
    + +
    + + + + + + +
    WARNING

    Each locking method is incompatible with each other. Therefore, +make sure the same method is specified for all MHonArc processes that +will be accessing a given archive. +If you want to change the default +lock method so it will affect all MHonArc processes, you can set +it via the default resource file or through mhasiteinit.pl. +See +Post Installation Configuration +for more information. +

    +
    + +

    The following sub-sections give more information of each lock method, +including the pros and cons of each, +and assumes you have some knowledge about file systems. +

    + +

    Directory File Method

    +

    The directory file method is the default method used by MHonArc, +and is the method used by past version of MHonArc. If you are familiar +with locking methods used by other software, you may find it strange +that a directory (which is just a special kind of file) is used instead +of a plain file. The reason a directory is used is that it has +unique properties over regular files on the various operating systems +MHonArc runs on. The property that MHonArc takes advantage of is +that you cannot create a new directory over an existing directory of +the same name. This property is not guaranteed for plain files, or +at least Perl cannot give a common interface for plain files to work +on all platforms. It may be possible to use a plain file with +Perl's sysopen() operator with the proper options, but +the needed sysopen() options are not guaranteed to be available +for all ports of Perl. +

    + +

    Pros

    +
      +

    • Appears to work for all known platforms. +

      +
      • +
    +

    Cons

    +
      +

    • If MHonArc/Perl abnormally terminates, MHonArc may not have the +chance to delete the directory, failing to release the lock on the archive +(a stale lock). +This will cause other MHonArc processes to fail out with "Unable to lock ..." +messages. To correct, manual deletion of the directory is required +(or FORCE must be used). +

      +
      • +
    + +

    flock Method

    +

    Using flock() is a common method for locking files under Unix-type +operating systems. In order to use flock() method, the Symbol +and Fcntl Perl modules must be available. If not available, and +this method is specified, MHonArc will fallback to the directory file +method. +

    +

    Unlike the directory method, it is okay if +LOCKFILE stays around, and actually, it +should never be manual deleted. +

    + +

    Pros

    +
      +

    • Lock is automatically released if MHonArc/Perl abnormally terminates, +eliminating the stale lock problem. +

      +
      • +
    +

    Cons

    +
      +

    • Not availabe on all platforms. +

      +
      • +

    • May not work over NFS reliably. Read the documentation +for flock() in the Perl documentation for more information. +

      +
    + + +
    +

    Default Setting

    + +

    directory +

    + + + + + +
    NOTE

    The use of <LOCKMETHOD> within an +RCFILE will take affect ONLY if used in the +DEFRCFILE. +

    +
    + + + + + +
    WARNING

    Each locking method is incompatible with each other. Therefore, +make sure the same method is specified for all MHonArc processes that +will be accessing a given archive. +If you want to change the default +lock method so it will affect all MHonArc processes, you can set +it via the default resource file or through mhasiteinit.pl. +See +Post Installation Configuration +for more information. +

    +
    + + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    None. +

    + + +
    +

    Version

    + +

    2.4.0 +

    + + +
    +

    See Also

    + +

    +FORCE, +LOCK, +LOCKDELAY, +LOCKFILE, +LOCKTRIES +

    + + +
    +
    +00/10/28 11:13:03
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/locktries.html b/doc/resources/locktries.html index 877aab8..e8aedce 100644 --- a/doc/resources/locktries.html +++ b/doc/resources/locktries.html @@ -89,13 +89,13 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/mailto.html b/doc/resources/mailto.html index 971655b..aacff9d 100644 --- a/doc/resources/mailto.html +++ b/doc/resources/mailto.html @@ -91,10 +91,10 @@

    See Also

    -98/09/19 18:27:11
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/mailtourl.html b/doc/resources/mailtourl.html index 9c83cc9..a0259a2 100644 --- a/doc/resources/mailtourl.html +++ b/doc/resources/mailtourl.html @@ -77,8 +77,51 @@

    Default Setting

    Resource Variables

    -

    N/A -

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    VariableValue
    $FROMADDR$The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    $MSGGMTDATE$GMT date of current message.
    $MSGID$The message-id of the message.
    $MSGLOCALDATE$Local date of current message.
    $TO$The email address (MAILTOURL only).
    $TOADDRDOMAIN$The e-mail address domain (MAILTOURL only).
    $TOADDRNAME$The e-mail address "username" (or local-part) (MAILTOURL only).
    @@ -90,7 +133,7 @@

    Examples

     <MailToURL>
-/cgi-bin/mailform.cgi?to=$FROM$;subject=$SUBJECT$;srcid=$MSGID$
+/cgi-bin/mailform.cgi?to=$TO$;subject=$SUBJECT$;srcid=$MSGID$
 </MailToURL>
    @@ -112,10 +155,10 @@

    See Also

    -98/09/19 18:27:12
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/main.html b/doc/resources/main.html index 131cca4..7def3cc 100644 --- a/doc/resources/main.html +++ b/doc/resources/main.html @@ -88,10 +88,10 @@

    See Also

    -98/09/19 18:27:12
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/maxsize.html b/doc/resources/maxsize.html index ef95eca..fc20f97 100644 --- a/doc/resources/maxsize.html +++ b/doc/resources/maxsize.html @@ -99,10 +99,10 @@

    See Also

    -98/09/19 18:27:12
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/mhpattern.html b/doc/resources/mhpattern.html index a26dee8..6d8d792 100644 --- a/doc/resources/mhpattern.html +++ b/doc/resources/mhpattern.html @@ -102,10 +102,10 @@

    See Also

    -98/09/19 18:27:12
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/mimeargs.html b/doc/resources/mimeargs.html index afda3e4..d4f51c0 100644 --- a/doc/resources/mimeargs.html +++ b/doc/resources/mimeargs.html @@ -110,7 +110,7 @@

    Examples

     <MIMEArgs>
-text/plain:quote
+text/plain;quote
 </MIMEArgs>
    @@ -132,10 +132,10 @@

    See Also

    -98/09/19 18:27:12
    +00/10/28 11:13:03
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/mimedecoders.html b/doc/resources/mimedecoders.html new file mode 100644 index 0000000..83f74fb --- /dev/null +++ b/doc/resources/mimedecoders.html @@ -0,0 +1,161 @@ + + + +MHonArc Resources: MIMEDECODERS + + + +
    +MHonArc Resource List
    +
    + +
    +

    MIMEDECODERS

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    N/A +

    +
    + +
    Element
    +


    +<MIMEDECODERS>
    +decoder-specification
    +...
    +</MIMEDECODERS>
    +

    +
    + +
    Command-line Option
    +

    N/A +

    +
    + +
    + + +
    +

    Description

    + +

    The MIMEDECODERS resource specifies Perl routines to call +for decoding MIME encoded data. For message bodies, the encoding +is specified by the Content-Transfer-Encoding header +field. Data encoding can also occur for non-ASCII data in +message headers. +

    + +

    The MIMEDECODERS resource can only be defined via the +resource file. Each line of the element specifies a encoding, +the Perl routine for filtering the character set, and the Perl source +file containing the routine. +

    + +

    Example:

    +
    +<MIMEDecoders>
+base64;           base64::b64decode;            base64.pl
+</MIMEDecoders>
+
    + +

    The first field is the encoding method. The second field +is the routine name (which should contain a package qualifier). +The third field is the source file the routine is defined. The +source file is optional if the routine is known to be defined in +an already listed source file. +

    + +

    There are some special decoder routines +values. They are as follows: +

    + +
    + +
    as-is
    +

    Leave the data "as-is". +

    +
    + +
    + +

    Each decoder function is invoked as follows: +

    + +
    +    $decoded_data = &function($data);
+
    + + +
    +

    Default Setting

    + +
    +<MIMEDecoders>
+7bit;             as-is;
+8bit;             as-is;
+binary;           as-is;
+base64;           base64::b64decode;            base64.pl
+quoted-printable; quoted_printable::qprdecode;  qprint.pl
+x-uuencode;       base64::uudecode;             base64.pl
+xuue;             base64::uudecode;             base64.pl
+uuencode;         base64::uudecode;             base64.pl
+</MIMEDecoders>
+
    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    The following example changes the base64 decoder to use the +MIME::Base64 module (available from CPAN): +

    + +
    +<MIMEDecoders>
+base64; MIME::Base64::decode_base64; MIME/Base64.pm
+</MIMEDecoders>
+
    + + +
    +

    Version

    + +

    2.4.4 +

    + + +
    +

    See Also

    + +

    +CHARSETCONVERTER, +MIMEFILTERS, +PERLINC +

    + + +
    +
    +00/10/28 11:13:13
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/mimeexcs.html b/doc/resources/mimeexcs.html new file mode 100644 index 0000000..0db8376 --- /dev/null +++ b/doc/resources/mimeexcs.html @@ -0,0 +1,134 @@ + + + +MHonArc Resources: MIMEEXCS + + + +
    +MHonArc Resource List
    +
    + +
    +

    MIMEEXCS

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    N/A +

    +
    + +
    Element
    +


    +<MIMEEXCS>
    +content-type
    +content-type
    +... +</MIMEEXCS>
    +

    +
    + +
    Command-line Option
    +

    N/A +

    +
    + +
    + + +
    +

    Description

    + +

    MIMEEXCS defines the list of content-types to exclude from processing. +The exclusion occurs before the data is processed to any filters +registered via the MIMEFILTERS resource. +If a message body part is excluded, the converted message will have +a note that the part was excluded. +

    + + + + + +
    NOTE

    Base types can also be listed to exclude all content-types +with a give base. For example, image/jpg will only exclude +JPEG images, but image will exclude all images. +

    +
    + + +
    +

    Default Setting

    + +

    Nil. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    The following example excludes all binaries, images, and postscript +data: +

    +
    +<MIMEExcs>
+application/octet-stream
+application/postscript
+image
+</MIMEExcs>
+
    + +

    The following is a very restrictive setting to minimize archive +exploits and large data files: +

    +
    +<MIMEExcs>
+application
+image
+audio
+video
+text/html
+</MIMEExcs>
+
    + + +
    +

    Version

    + +

    2.4.9 +

    + + +
    +

    See Also

    + +

    +MIMEFILTERS +

    + + +
    +
    +01/06/10 17:08:42
    + +MHonArc
    +Copyright © 2001, Earl Hood, mhonarc@mhonarc.org
    +
    + + + diff --git a/doc/resources/mimefilters.html b/doc/resources/mimefilters.html index ef1c4b7..0b4ba1c 100644 --- a/doc/resources/mimefilters.html +++ b/doc/resources/mimefilters.html @@ -25,10 +25,10 @@

    Syntax

    Element

    -<MIMEFILTERS>
     +<MIMEFILTERS>
    filter-specification
    ...
    -</MIMEFILTERS>
     +</MIMEFILTERS>

    @@ -80,17 +80,6 @@

    Description

    - - - - - -
    NOTE

    For backwards compatibility, the values of a filter specification -can be separated with a colon, ":". However, if you use a colon, -package qualification of a function must use Perl 4 syntax. -

    -
    -

    Whitespace is stripped out for each filter specification.

    @@ -107,8 +96,7 @@

    Writing Filters

    The filter model follows Perl 4 syntax conventions and constructs. This is because of historical reasons. Note, the implementation of the filter can use Perl 5 -syntax and features, where applicable, if running MHonArc -under Perl 5. +syntax and features, when applicable.

    @@ -304,8 +292,20 @@

    Using C

    Default Setting

    + + + + + +
    NOTE

    It is important to have an explicit entry for +application/octet-stream for handling unknown +media-types. +

    +
    + 
     <MIMEFilters>
+application/octet-stream;  m2h_external::filter;	mhexternal.pl
 application/*;		   m2h_external::filter;	mhexternal.pl
 application/x-patch;	   m2h_text_plain::filter;	mhtxtplain.pl
 audio/*;		   m2h_external::filter;	mhexternal.pl
@@ -313,6 +313,7 @@ 
    Default Setting
    
 model/*;		   m2h_external::filter;	mhexternal.pl
 image/*;		   m2h_external::filter;	mhexternal.pl
 message/delivery-status;   m2h_text_plain::filter;	mhtxtplain.pl
+message/external-body;     m2h_msg_extbody::filter;	mhmsgextbody.pl
 message/partial;	   m2h_text_plain::filter;	mhtxtplain.pl
 text/*;			   m2h_text_plain::filter;	mhtxtplain.pl
 text/enriched;		   m2h_text_enriched::filter;	mhtxtenrich.pl
@@ -350,26 +351,59 @@ 
    m2h_external::filter
    
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
+
@@ -378,22 +412,22 @@ 
    m2h_external::filter
    
 The filter already has a large list of descriptions for various
 content-types.  Use this argument if you process a
 content-type not recognized by the filter.
-
    
+
    
@@ -401,7 +435,7 @@ 
    m2h_external::filter
    
 the derived file.  The icon used is the value of the
 iconurl option or the icon
 defined by the ICONS resource.
-
    
+
    
@@ -410,7 +444,7 @@ 
    m2h_external::filter
    
 since it can lead to filename conflicts and
 security problems (however, see the subdir
 option).
-
    
+
    
@@ -419,7 +453,7 @@ 
    m2h_external::filter
    
 since it can lead to
 security problems (however, see the subdir
 option).
-
    
+
    
 
    excludeexts=ext1,...
    A comma separated list of message specified filename extensions
+to exclude.  I.e.  If the filename extension matches an extension
+in excludeexts, the content will not be written.  The return markup
+will contain the name of the attachment, but no link to the data.
+This option is best used with application/octet-stream to exclude
+unwanted data that is not tagged with the proper content-type.  The
+m2h_null::filter can be used to
+exclude content by content-type.
+
    
+
    ext=ext
    Use ext as the filename extension.
+The filter already has a large list of extensions for various
+content-types.  Use this argument if you process a
+content-type not recognized by the filter.
+
    forceattach
    Force images to never be displayed inline, overriding any
+Content-Disposition setting.
+
    forceinline
    Force images to be displayed inline, overriding any
+Content-Disposition setting.
+
    
 iconurl="url"
 
    Use "url" as the url for the icon to use
 if the useicon option is set.
 This option will override any setting defined by the
 ICONS resource.
 The double quotes are required.
-
    
+
    		
 
    
 
    
 inline
 
    Inline image data by default if content-disposition not defined.
-
    
+
    		
 
    
 
    ext=ext
    Use ext as the filename extension.
-The filter already has a large list of extensions for various
-content-types.  Use this argument if you process a
-content-type not recognized by the filter.
-
    
+    		inlineexts=ext1,...
    A comma separated list of message specified filename
+extensions to treat as possible inline data.
+Applicable when content-type is not image/* and
+usename or usenameext is in effect.
+
    		
 
    
 
    
 type="description"
 
    
 
    
 subdir
 
    Place derived file in a subdirectory of the archive.
-The subdirectory will be called "msgMSGNUM.dir".
+The subdirectory will be called "msgMSGNUM".
 This option may be useful if usename is
 specified to avoid security and name conflict problems.
-
    
+
    		
 
    
 
    
 target=name
 
    Set the TARGET attribute of anchor link to file
 Default value is undefined (ie. no TARGET attribute will be
 written).
-
    
+
    		
 
    
 
    
 useicon
 
    
 
    
 usename
 
    
 
    
 usenameext
 
    
 
    
 
@@ -469,6 +503,18 @@ 
    m2h_external::filter
    
 mbd
 mbedlet file
 
+application/ms-excel
+xls
+MS-Excel spreadsheet
+
+application/ms-powerpoint
+ppt
+MS-Powerpoint presentation
+
+application/ms-project
+mpp
+MS-Project file
+
 application/msword
 doc
 MS-Word document
@@ -525,6 +571,30 @@ 
    m2h_external::filter
    
 hpg
 HPGL file
 
+application/vnd.lotus-1-2-3
+123
+Lotus 1-2-3
+
+application/vnd.lotus-approach
+apr
+Lotus Approach
+
+application/vnd.lotus-freelance
+prz
+Lotus Freelance
+
+application/vnd.lotus-organizer
+org
+Lotus Organizer
+
+application/vnd.lotus-screencam
+scm
+Lotus Screencam
+
+application/vnd.lotus-wordpro
+lwp
+Lotus WordPro
+
 application/vnd.mif
 mif
 Frame MIF document
@@ -557,6 +627,10 @@ 
    m2h_external::filter
    
 bcpio
 BCPIO file
 
+application/x-bzip2
+bz2
+BZip2 compressed data
+
 application/x-compress
 Z
 Unix compressed data
@@ -841,6 +915,10 @@ 
    m2h_external::filter
    
 cml
 CML chemical test
 
+chemical/cmsl
+cml
+Chemical Structure Markup
+
 chemical/cxf
 cxf
 Chemical Exhange Format file
@@ -853,9 +931,17 @@ 
    m2h_external::filter
    
 emb
 EMBL nucleotide format file
 
+chemical/gaussian
+gau
+Gaussian data
+
 chemical/gaussian-input
 gau
-Gaussian chemical test
+Gaussian input data
+
+chemical/gaussian-log
+gal
+Gaussian log
 
 chemical/gcg8-sequence
 gcg
@@ -871,7 +957,7 @@ 
    m2h_external::filter
    
 
 chemical/kinemage
 kin
-Kinemage chemical test
+Kinemage
 
 chemical/macromodel-input
 mmd
@@ -901,6 +987,10 @@ 
    m2h_external::filter
    
 mif
 MIF chemical test
 
+chemical/mmd
+mmd
+Macromodel data
+
 chemical/mopac-input
 mop
 MOPAC data 
@@ -911,12 +1001,16 @@ 
    m2h_external::filter
    
 
 chemical/pdb
 pdb
-PDB chemical test
+Protein Databank data
 
 chemical/rosdal
 ros
 Rosdal data
 
+chemical/xyz
+xyz
+Xmol XYZ data
+
 image/bmp
 bmp
 Windows bitmap
@@ -1112,6 +1206,35 @@ 
    m2h_external::filter
    
 
 
 
+
    
+
    m2h_msg_extbody::filter
    
+
+
    This filter is designed to process message/external-body
+data.
+The filter attempts to translate the external-body paramaters
+into a linked URL with some descriptive information,
+if provided.  The following access-types are supported:
+ANON-FTP, FTP, TFTP, LOCAL-FILE, and URL.  Note, LOCAL-FILE is
+only supported if the local-file option is specified.
+
    
+
+
    m2h_msg_extbody::filter can take the
+following
+arguments:
+
    
+
+
+
+
+
+
    local-file
    Support LOCAL-FILE access-type.  This option
+is best used for internal local mail archives
+where it is known that readers will have
+direct access to the file.
+
    
+
    
+
+
 
    
 
    m2h_text_enriched::filter
    
 
@@ -1126,63 +1249,63 @@ 
    m2h_text_enriched::filter
    
 Text/Enriched CommandHTML Translation
 
 
-<Bold>
-<B>
+<Bold>
+<B>
 
 
-<Italic>
-<I>
+<Italic>
+<I>
 
 
-<Underline>
-<U>
+<Underline>
+<U>
 
 
-<Fixed>
-<TT>
+<Fixed>
+<TT>
 
 
-<Smaller>
-<SMALL>
+<Smaller>
+<SMALL>
 
 
-<Bigger>
-<BIG>
+<Bigger>
+<BIG>
 
 
-<FontFamily><Param>family</Param>
-<FONT face="family">
+<FontFamily><Param>family</Param>
+<FONT face="family">
 
 
-<Color><Param>color</Param>
-<FONT color="color">
+<Color><Param>color</Param>
+<FONT color="color">
 
 
 <Center>
-<P align="center">
+<P align="center">
 
 
-<FlushLeft>
-<P align="left">
+<FlushLeft>
+<P align="left">
 
 
-<FlushRight>
-<P align="right">
+<FlushRight>
+<P align="right">
 
 
-<FlushBoth>
-<P align="both"> (not supported in HTML)
+<FlushBoth>
+<P align="both"> (not supported in HTML)
 
 
-<ParaIndent>
-<BLOCKQUOTE>
+<ParaIndent>
+<BLOCKQUOTE>
 
 
-<Excerpt>
-<BLOCKQUOTE>
+<Excerpt>
+<BLOCKQUOTE>
 
 
-<Lang>
+<Lang>
 Stripped
 
 
@@ -1204,8 +1327,8 @@ 
    m2h_text_enriched::filter
    
 
    
 
    m2h_text_html::filter
    
 
-
    This filter is designed to process text/html or
-text/x-html data.
+
    This filter is designed to process text/html, or
+text/x-html, data.
 The filter modifies HTML documents so they can be
 included into the message pages without causing invalid markup
 to occur.  The following modification are done to HTML documents when
@@ -1217,20 +1340,85 @@ 
    m2h_text_html::filter
    
 done when removing the HEAD element:
    
     
      
     
    • The title will be extracted and prepended
-    to the body data.
+    to the body data.
      • 
     
    • Any BASE URL will be propogated to any relative URLs in the
-    document.
+    document.
      • 
     
    
     
    
 
+
  • Any markup related to scripting is removed for security
+reasons.  The following tags are removed:
+<applet>,
+<base>,
+<embed>,
+<form>,
+<ilayer>,
+<input>,
+<layer>,
+<link>,
+<meta>,
+<object>,
+<option>,
+<param>,
+<script>,
+<select>,
+<style>,
+<textarea>.
+The following attributes are removed:
+onload,
+onunload,
+onclick,
+ondblclick,
+onmousedown,
+onmouseup,
+onmouseover,
+onmousemove,
+onmouseout,
+onkeypress,
+onkeydown,
+onkeyup.
+The allowscript option can be
+be used to override the this behavior (see below).
+
    • 
 
  • cid: URLs are resolved, if possible.  Therefore,
 if image data related to the HTML document is included with the message,
 the URLs will be modified to the filenames of the images that were
 decoded.
    
 
    • 
 
+
+
    m2h_text_html::filter can take the
+following
+arguments:
 
    
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
    allowcomments
    Preserve any comment declarations.  Comment declarations
+are sometimes used to contain executable commands, like for
+server-side includes.  Normally, comment declarations are munged
+to protect against potential exploits, but this option will
+disable that behavior.  Use this options with EXTREME
+care.
+
    allowscript
    Preserve any markup associated with scripting.
+This includes elements and attributes related to scripting.  This option
+can cause security problems for your archive since someone can introduce
+foreign client-side code.  Use this options with EXTREME
+care.
+
    nofont
    Remove font tags.
+
    
+
 
    
 
    m2h_text_plain::filter
    
 
@@ -1250,9 +1438,9 @@ 
    m2h_text_plain::filter
    
 
-
@@ -1269,6 +1457,17 @@ 
    m2h_text_plain::filter
    
+
+
+
@@ -1279,6 +1478,21 @@ 
    m2h_text_plain::filter
    
+
+
+
+
+
+
-
+
+
+
+
+
+
+
+
+
    
 
    
 NOTE
    Only the ISO-8859-[1-10] and ISO-2022-JP
-character sets are recognized.  For ISO-2022-JP data, a Web
-client with ISO-2022-JP is required to read the data.
+
    The functions registered via the
+CHARSETCONVERTERS are used
+to handle character set processing.
 
    
     		
 
    
 
    asis=set1:...
 
    Colon separated lists of charsets to leave as-is.
 Only HTML special characters will be converted into entities.
+The default is "us-ascii:iso-8859-1".
+
    
+
    attachcheck
    Honor attachment disposition.  By default,
+all text/plain data is displayed inline on
+the message page.  If attachcheck is specified
+and Content-Disposition specifies the data as
+an attachment, the data is saved to a file
+with a link to it from the message page.
 
    
 
    
 
    
 
 
    
 
    inlineexts=ext1,...
    A comma separated list of message specified filename
+extensions to treat as inline data.
+Applicable only when uudecode is specified.
+
    
+
    htmlcheck
    Check if message is actually an HTML message
+(to get around abhorrent MUAs).  The message
+is treated as HTML if the first non-whitespace
+data looks like the start of an HTML document.
+
    
+
    
 keepspace
 
    Preserve all spaces if the nonfixed
 option is specified.  All spaces and tabs will be translated to the
@@ -1286,7 +1500,7 @@ 
    m2h_text_plain::filter
    
 
    
 
    
 
    maxwidth=#maxwidth=#
 
    Force the maximum width of lines to be # characters
 in length.  Any lines longer than # characters will be
 wrapped.
@@ -1317,6 +1531,32 @@ 
    m2h_text_plain::filter
    
 hyperlinking URLs.
 
    
 
    usename
    When decoding uuencoded data, use the full filename specified
+when write the data to disk instead of just the filename extension.
+Note: Be aware that there are potential security problems when
+using this option.
+
    uudecode
    Decode any embedded uuencoded data.  Including uuencoded data
+within messages was a way to trasmit binary data
+via email before MIME was developed.  The inclusion of uuencoded
+data is deprecated within email, but is still common in the
+USENET (binary) newsgroups.  Note, specifying uudecode
+adds extra
+overhead in the processing of text messages, including messages without
+any uuencoded data.
+
    
+
    Uuencoded data is treated as application/octet-stream
+data for purposes of checking if the data should be excluded when
+checked against the MIMEEXCS resource.
+Therefore, if application/octet-stream data is listed
+in MIMEEXCS, uudencode data will be excluded.
+
    
 
 
    
 
@@ -1336,6 +1576,32 @@ 
    m2h_text_tsv::filter
    
 tabular data will be converted into an HTML table.
 
    
 
+
    
+
    m2h_null::filter
    
+
+
    This filter can be used to exclude message content from archives.
+You can register this filter to any content-type you do not want
+to store in your archives.  For example, the following resource setting
+excludes all images:
+
    
+
    +<MIMEFilters>
+image/*; m2h_null::filter; mhnull.pl
+</MIMEFilters>
+
    
+
    The markup returned by this filter displays the a one line description
+of what was excluded.  Examples:
+
    
+
    +<<attachment: HelloWorld.jpg>>
+<<application/postscript>>
+<<inline: image/jpg>>
+
    
+
    If the disposition is available, it will be shown.  If a filename
+was specified, it will be shown.  If there was no filename, the
+content-type is shown.
+
    
+
 
 
    
 
    Resource Variables
    
@@ -1353,7 +1619,7 @@ 
    Examples
    
 
    
 
     ##---------------------------------------------------------------------------##
-##    Copyright (C) 1995-1998	Earl Hood, earlhood@usa.net
+##    Copyright (C) 1995-1998	Earl Hood, mhonarc@mhonarc.org
 ##---------------------------------------------------------------------------##
 
 package m2h_text_html;
@@ -1441,16 +1707,18 @@ 
    See Also
    
 
    
 CHARSETCONVERTERS,
 MIMEARGS,
+MIMEDECODERS,
+MIMEEXCS,
 PERLINC
 
    
 
 
 
    
 
    
-98/10/24 16:57:31
    
+01/06/10 17:48:19
    
 
-MHonArc
    
-Copyright © 1997-1998 Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-2001 Earl Hood, mhonarc@mhonarc.org
    
 
    
 
 
diff --git a/doc/resources/modtime.html b/doc/resources/modtime.html
index bb251ce..b61b70e 100644
--- a/doc/resources/modtime.html
+++ b/doc/resources/modtime.html
@@ -99,10 +99,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:12
    
+00/10/28 11:13:03
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/months.html b/doc/resources/months.html
index f4ecc15..ef2b60d 100644
--- a/doc/resources/months.html
+++ b/doc/resources/months.html
@@ -103,10 +103,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:12
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/monthsabr.html b/doc/resources/monthsabr.html
index 6a2335d..cfa0347 100644
--- a/doc/resources/monthsabr.html
+++ b/doc/resources/monthsabr.html
@@ -38,7 +38,7 @@ 
    Syntax
    
 
 
    Command-line Option
    
 
    
--MONTHSABR month1:-monthsabr month1:month2:...:month12
 
    
@@ -103,10 +103,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:12
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msgbodyend.html b/doc/resources/msgbodyend.html
index 5de8841..a300b6f 100644
--- a/doc/resources/msgbodyend.html
+++ b/doc/resources/msgbodyend.html
@@ -55,7 +55,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -68,6 +67,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -76,6 +79,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -100,6 +111,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -107,7 +122,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    Message date in dd/mm/yyyy format.
 
    
 
    $ENV$Value of an environment variable.
    
 $FROM$
 The complete text in the From: field of the message.
 
    
 
    The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -136,13 +150,13 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:12
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msgexcfilter.html b/doc/resources/msgexcfilter.html
new file mode 100644
index 0000000..32b7eae
--- /dev/null
+++ b/doc/resources/msgexcfilter.html
@@ -0,0 +1,142 @@
+
+
+
+MHonArc Resources: MSGEXCFILTER
+
+
+
+
    
+MHonArc Resource List
    
+
    
+
+
    
+
    MSGEXCFILTER
    
+
+
+
    
+
    Syntax
    
+
+
    
+
+
    Envariable
    
+
    
+M2H_MSGEXCFILTER=Perl_expressions
+
    
+
    
+
+
    Element
    
+

    
+<MSGEXCFILTER>
    
+Perl_expressions
    
+</MSGEXCFILTER>
    
+
    
+
    
+
+
    Command-line Option
    
+

    
+-msgexcfilter Perl_expressions
+
    
+
    
+
+
    
+
+
+
    
+
    Description
    
+
+
    MSGEXCFILTER may be used to define Perl expressions to
+selectively exclude messages during an
+ADD operation.  Unlike the
+CHECKNOARCHIVE resource,
+MSGEXCFILTER allows you to explicitly examine entire message headers
+to determine which messages should be added.
+
    
+
    When defining the expressions, the raw message header will be in
+the $_ variable.  If the last evaluated expression
+of MSGEXCFILTER returns a true value, or there is an explicit
+return statement that returns a true value, MHonArc will
+exclude the message.
+
    
+
+
+
+
    
+
    Default Setting
    
+
+
    Nil.
+
    
+
+
+
    
+
    Resource Variables
    
+
+
    N/A
+
    
+
+
+
    
+
    Examples
    
+
+
    A typical usage of MSGEXCFILTER is to define a pattern match
+operation:
+
    
+
    +<MsgExcFilter>
+/^From: .*\behood@/im;
+</MsgExcFilter>
+
    
+
    Here, we are excluding any messages that are from "ehood".  The
+"m" modifier to the pattern match exists because the
+header will contain newlines.
+
    
+
+
    The following example attempts to exclude all messages not addressed
+to mhonarc@ncsa.uiuc.edu:
+
    
+
    +<MsgExcFilter>
+!/\bmhonarc@ncsa.uiuc.edu\b/i;
+</MsgExcFilter>
+
    
+
+
    Here, we do what the CHECKNOARCHIVE
+resource basically does:
+
    
+
    +<MsgExcFilter>
+/^restrict:\s+no-external-archive/im ||
+/^x-no-archive:\s+yes/im;
+</MsgExcFilter>
+
    
+
+
+
+
    
+
    Version
    
+
+
    2.4.1
+
    
+
+
+
    
+
    See Also
    
+
+
    
+ADD,
+CHECKNOARCHIVE
+
    
+
+
+
    
+
    
+00/10/28 11:13:04
    
+
+MHonArc
    
+Copyright © 1999, Earl Hood, mhonarc@pobox.com
    
+
    
+
+
+
diff --git a/doc/resources/msgfoot.html b/doc/resources/msgfoot.html
index 8ce72ff..f4f892e 100644
--- a/doc/resources/msgfoot.html
+++ b/doc/resources/msgfoot.html
@@ -20,7 +20,6 @@ 
    Syntax
    
 
 
    Envariable
    
 
    N/A
-
 
    
 
    
 
@@ -29,7 +28,6 @@ 
    Syntax
    
 <MSGFOOT>
    
 markup ...
    
 </MSGFOOT>
    
-
 
    
 
 
@@ -60,7 +58,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -81,8 +78,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -93,6 +90,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -129,10 +134,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -169,6 +170,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -193,6 +202,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -224,7 +237,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -256,8 +268,8 @@ 
    See Also
    
 
    
 98/03/03 18:19:42
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msggmtdatefmt.html b/doc/resources/msggmtdatefmt.html
index a400e48..a98d827 100644
--- a/doc/resources/msggmtdatefmt.html
+++ b/doc/resources/msggmtdatefmt.html
@@ -56,8 +56,19 @@ 
    Description
    
 
    The following lists the possible conversion specifications:
 
    
 
-
-
+
    
+
+
+
+
+
    NOTE
    If POSIXSTRFTIME is set,
+the POSIX::strftime() function will be used.  Therefore, there may be
+more conversion specifications available.  See your system's
+strftime() manpage for specifics.
+
    
+
    
+
+
@@ -139,7 +150,6 @@ 
    Description
    
 
-
    
 
    
 Spec
 Value
 year, including the century (for example 1993)
 
    
 
    
 
 
    Setting MSGGMTDATEFMT to a blank string will reset the resource
@@ -151,7 +161,7 @@ 
    Description
    
 
    Default Setting
    
 
 
    -%a %b %d %H:%M:%S GMT %y
+%a %b %d %H:%M:%S GMT %Y
 
    
 
 
@@ -184,6 +194,7 @@ 
    See Also
    
 LOCALDATEFMT,
 MONTHS,
 MONTHSABR,
+POSIXSTRFTIME,
 WEEKDAYS,
 WEEKDAYSABR
 
    
@@ -192,10 +203,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:12
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msghead.html b/doc/resources/msghead.html
index abf95de..f6340ef 100644
--- a/doc/resources/msghead.html
+++ b/doc/resources/msghead.html
@@ -20,7 +20,6 @@ 
    Syntax
    
 
 
    Envariable
    
 
    N/A
-
 
    
 
    
 
@@ -29,7 +28,6 @@ 
    Syntax
    
 <MSGHEAD>
    
 markup ...
    
 </MSGHEAD>
    
-
 
    
 
 
@@ -60,7 +58,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -81,8 +78,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -93,6 +90,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -129,10 +134,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -169,6 +170,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -193,6 +202,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -224,7 +237,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -257,10 +269,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:12
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msgidlink.html b/doc/resources/msgidlink.html
index 0886c76..4bc2eb3 100644
--- a/doc/resources/msgidlink.html
+++ b/doc/resources/msgidlink.html
@@ -59,7 +59,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -80,8 +79,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -92,6 +91,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -128,10 +135,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -168,6 +171,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -192,6 +203,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -223,7 +238,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -254,13 +268,13 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1998, Earl Hood, earlhood@usa.net
    
+Copyright © 1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msglocaldatefmt.html b/doc/resources/msglocaldatefmt.html
index 032b3b1..d2d37b8 100644
--- a/doc/resources/msglocaldatefmt.html
+++ b/doc/resources/msglocaldatefmt.html
@@ -56,8 +56,19 @@ 
    Description
    
 
    The following lists the possible conversion specifications:
 
    
 
-
-
+
    
+
+
+
+
+
    NOTE
    If POSIXSTRFTIME is set,
+the POSIX::strftime() function will be used.  Therefore, there may be
+more conversion specifications available.  See your system's
+strftime() manpage for specifics.
+
    
+
    
+
+
@@ -139,7 +150,6 @@ 
    Description
    
 
-
    
 
    
 Spec
 Value
 year, including the century (for example 1993)
 
    
 
    
 
 
    Setting MSGLOCALDATEFMT to a blank string will reset the resource
@@ -151,7 +161,7 @@ 
    Description
    
 
    Default Setting
    
 
 
    -%a %b %d %H:%M:%S %y
+%a %b %d %H:%M:%S %Y
 
    
 
 
@@ -185,6 +195,7 @@ 
    See Also
    
 MONTHS,
 MONTHSABR,
 MSGGMTDATEFMT,
+POSIXSTRFTIME,
 WEEKDAYS,
 WEEKDAYSABR
 
    
@@ -192,10 +203,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msgpgbegin.html b/doc/resources/msgpgbegin.html
index db3c254..deb5f7e 100644
--- a/doc/resources/msgpgbegin.html
+++ b/doc/resources/msgpgbegin.html
@@ -20,7 +20,6 @@ 
    Syntax
    
 
 
    Envariable
    
 
    N/A
-
 
    
 
    
 
@@ -29,7 +28,6 @@ 
    Syntax
    
 <MSGPGBEGIN>
    
 markup ...
    
 </MSGPGBEGIN>
    
-
 
    
 
 
@@ -71,7 +69,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -92,8 +89,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -104,6 +101,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -140,10 +145,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -180,6 +181,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -204,6 +213,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -235,7 +248,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -268,10 +280,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msgpgend.html b/doc/resources/msgpgend.html
index de53794..a4dc248 100644
--- a/doc/resources/msgpgend.html
+++ b/doc/resources/msgpgend.html
@@ -20,7 +20,6 @@ 
    Syntax
    
 
 
    Envariable
    
 
    N/A
-
 
    
 
    
 
@@ -29,7 +28,6 @@ 
    Syntax
    
 <MSGPGEND>
    
 markup ...
    
 </MSGPGEND>
    
-
 
    
 
 
@@ -64,7 +62,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -85,8 +82,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -97,6 +94,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -133,10 +138,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -173,6 +174,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -197,6 +206,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -228,7 +241,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -261,10 +273,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msgpgs.html b/doc/resources/msgpgs.html
index ca02d5f..3d6c156 100644
--- a/doc/resources/msgpgs.html
+++ b/doc/resources/msgpgs.html
@@ -6,7 +6,7 @@
 
 
 
    
-MHonArc Resource List
    
+MHonArc Resource List
    
 
    
 
 
    
@@ -94,13 +94,13 @@ 
    See Also
    
 
 
    
 
    
-98/09/30 22:33:43
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1998, Earl Hood, earlhood@usa.net
    
+Copyright © 1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msgprefix.html b/doc/resources/msgprefix.html
index 2258e90..e75d945 100644
--- a/doc/resources/msgprefix.html
+++ b/doc/resources/msgprefix.html
@@ -89,13 +89,13 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/msgsep.html b/doc/resources/msgsep.html
index b8d312d..1129bc0 100644
--- a/doc/resources/msgsep.html
+++ b/doc/resources/msgsep.html
@@ -84,6 +84,18 @@ 
    Examples
    
 </MSGSEP>
 
    
 
+
    or
    
+
+
    +<MSGSEP>
+^From\s+(?:"[^"]+"@\S+|\S+)\s+\S+\s+\S+\s+\d+\s+\d+:\d+:\d+\s+\d+
+</MSGSEP>
+
    
+
+
    The second version deals with some systems that have quoted
+local parts in the address listed in the separator.
+
    
+
 
    It is still possible to get bogus splitting if a message
 contains a line that matches the regexp.
 Therefore, you may
@@ -109,10 +121,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/multipg.html b/doc/resources/multipg.html
index 5bfaf02..9cc8c0f 100644
--- a/doc/resources/multipg.html
+++ b/doc/resources/multipg.html
@@ -101,10 +101,10 @@ 
    See Also
    
 
 
    
 
    
-98/10/10 15:34:43
    
+00/10/28 11:13:04
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/news.html b/doc/resources/news.html
index 5608efa..78a89c1 100644
--- a/doc/resources/news.html
+++ b/doc/resources/news.html
@@ -90,10 +90,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:03
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/nextbutton.html b/doc/resources/nextbutton.html
index ec6d211..342e089 100644
--- a/doc/resources/nextbutton.html
+++ b/doc/resources/nextbutton.html
@@ -42,11 +42,12 @@ 
    Syntax
    
 
    
 
    Description
    
 
-
    NEXTBUTTON defines the value for the $BUTTON(NEXT)$
-resource variable when there is a next message to the current message
-according to the message list order of the main index.  See the
-NEXTBUTTONIA for defining the
-value of $BUTTON(NEXT)$ when there is no next message.
+
    NEXTBUTTON defines the value of the $BUTTON(NEXT)$
+resource when a message has a successor.  That is, if the
+main index message list lists a message after the current
+message, $BUTTON(NEXT)$ will take on the
+value of NEXTBUTTON.  If a next message doesn't exist, the NEXTBUTTONIA value will be used instead.
 
    
 
 
@@ -64,7 +65,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -85,8 +85,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -97,6 +97,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -133,10 +141,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -173,6 +177,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -197,6 +209,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -228,7 +244,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -268,10 +283,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:05
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/nextbuttonia.html b/doc/resources/nextbuttonia.html
index a4c5463..158f0f7 100644
--- a/doc/resources/nextbuttonia.html
+++ b/doc/resources/nextbuttonia.html
@@ -64,7 +64,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -85,8 +84,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -97,6 +96,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -133,10 +140,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -173,6 +176,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -197,6 +208,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -228,7 +243,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -268,10 +282,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:06
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/nextlink.html b/doc/resources/nextlink.html
index 7b177a7..fa185ce 100644
--- a/doc/resources/nextlink.html
+++ b/doc/resources/nextlink.html
@@ -76,7 +76,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -97,8 +96,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -109,6 +108,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -145,10 +152,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -185,6 +188,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -209,6 +220,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -240,7 +255,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -283,10 +297,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:07
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/nextlinkia.html b/doc/resources/nextlinkia.html
index f400009..3536df0 100644
--- a/doc/resources/nextlinkia.html
+++ b/doc/resources/nextlinkia.html
@@ -64,7 +64,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -85,8 +84,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -97,6 +96,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -133,10 +140,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -173,6 +176,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -197,6 +208,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -228,7 +243,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
@@ -261,10 +275,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:07
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/nextpglink.html b/doc/resources/nextpglink.html
index 5c1f4ce..12d7730 100644
--- a/doc/resources/nextpglink.html
+++ b/doc/resources/nextpglink.html
@@ -68,7 +68,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -77,8 +76,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -105,10 +104,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -138,7 +133,11 @@ 
    Resource Variables
    
-
+
+
+
+
+
@@ -164,7 +163,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $GMTDATE$
 The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LOCALDATE$
 Current local date.
 
    
 
 
    
 $PGLINK$Markup linking to a main index page.Markup linking to an index page.
    $PGLINKLIST$List of links to index pages.
 
    
 
    
 $PROG$
 $VERSION$
 Program version.
 
    
 
    
 
 
@@ -196,10 +194,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:13
    
+00/10/28 11:13:07
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/nextpglinkia.html b/doc/resources/nextpglinkia.html
index ebb9d79..55ce292 100644
--- a/doc/resources/nextpglinkia.html
+++ b/doc/resources/nextpglinkia.html
@@ -68,7 +68,6 @@ 
    Default Setting
    
 
    Resource Variables
    
 
 
-
@@ -77,8 +76,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -105,10 +104,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -138,7 +133,11 @@ 
    Resource Variables
    
-
+
+
+
+
+
@@ -164,7 +163,6 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $GMTDATE$
 The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LOCALDATE$
 Current local date.
 
    
 
 
    
 $PGLINK$Markup linking to a main index page.Markup linking to an index page.
    $PGLINKLIST$List of links to index pages.
 
    
 
    
 $PROG$
 $VERSION$
 Program version.
 
    
 
    
 
 
@@ -196,10 +194,10 @@ 
    See Also
    
 
 
    
 
    
-98/09/19 18:27:14
    
+00/10/28 11:13:07
    
 
-MHonArc
    
-Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    
+MHonArc
    
+Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    
 
    
 
 
diff --git a/doc/resources/note.html b/doc/resources/note.html
index 94e5d29..ce77e49 100644
--- a/doc/resources/note.html
+++ b/doc/resources/note.html
@@ -13,6 +13,7 @@
 
    NOTE
    
 
 
+
    
 
    Syntax
    
 
 
    
@@ -38,6 +39,7 @@ 
    Syntax
    
 
    
 
 
+
    
 
    Description
    
 
 
    NOTE defines the value of the $NOTE$ resource variable
@@ -47,17 +49,18 @@ 
    Description
    
 
    
 
 
+
    
 
    Default Setting
    
 
 
    -$NOTETEXT$
+$NOTETEXT$
 
    
 
 
+
    
 
    Resource Variables
    
 
 
-
@@ -78,8 +81,8 @@ 
    Resource Variables
    
-
-
+
+
@@ -90,6 +93,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -126,10 +137,6 @@ 
    Resource Variables
    
-
-
-
-
@@ -166,6 +173,14 @@ 
    Resource Variables
    
+
+
+
+
+
+
+
+
@@ -190,6 +205,10 @@ 
    Resource Variables
    
+
+
+
+
@@ -221,10 +240,10 @@ 
    Resource Variables
    
-
    
 
    
 VariableValue
 
    
 
    URL to documentation.
 
    
 
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
 
    
 
    
 $FROM$
 The e-mail address in the From: field of the message.
 
    
 
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    
 $FROMNAME$
 The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
 
    
 
    The title of the main index page.
 
    
 
    $LASTPG$Filename of last page in of main index.
    
 $LINK$
 Link markup linking to a message.
 
    
 
    Filename prefix for message files.
 
    
 
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTETEXT$Base text of message annotation.
    
 $NUMFOLUP$
 Number of explicit follow-ups to the message.
 
    
 
    Program name
 
    
 
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    
 $SUBJECTNA$
 The subject text of the message without the anchor element.
 
    
 
    $YYYYMMDD$
 Message date in yyyy/mm/dd format.
 
    
 
    
 
 
+
    
 
    Examples
    
 
 
    If you use annotations to provide a brief summary of the message
@@ -255,12 +274,14 @@ 
    Examples
    +

    Version

    2.3.0

    +

    See Also

    @@ -273,13 +294,13 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:05
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/notedir.html b/doc/resources/notedir.html index 8163640..450b566 100644 --- a/doc/resources/notedir.html +++ b/doc/resources/notedir.html @@ -13,6 +13,7 @@

    NOTEDIR

    +

    Syntax

    @@ -40,6 +41,7 @@

    Syntax

    +

    Description

    NOTEDIR defines the directory location to store annotation data @@ -81,6 +83,7 @@

    Description

    +

    Default Setting

    @@ -88,10 +91,10 @@ 
    Default Setting
    +

    Resource Variables

    - @@ -112,8 +115,8 @@

    Resource Variables

    - - + + @@ -124,6 +127,14 @@

    Resource Variables

    + + + + + + + + @@ -160,10 +171,6 @@

    Resource Variables

    - - - - @@ -200,6 +207,14 @@

    Resource Variables

    + + + + + + + + @@ -224,6 +239,10 @@

    Resource Variables

    + + + + @@ -255,22 +274,24 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    +

    Examples

    None.

    +

    Version

    2.3.0

    +

    See Also

    @@ -281,13 +302,13 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/noteia.html b/doc/resources/noteia.html index 3afdd18..0e94d90 100644 --- a/doc/resources/noteia.html +++ b/doc/resources/noteia.html @@ -13,6 +13,7 @@

    NOTEIA

    +

    Syntax

    @@ -38,6 +39,7 @@

    Syntax

    +

    Description

    NOTEIA defines the value of the $NOTE$ resource variable @@ -47,16 +49,17 @@

    Description

    +

    Default Setting

    Nil.

    +

    Resource Variables

    - @@ -77,8 +80,8 @@

    Resource Variables

    - - + + @@ -89,6 +92,14 @@

    Resource Variables

    + + + + + + + + @@ -125,10 +136,6 @@

    Resource Variables

    - - - - @@ -165,6 +172,14 @@

    Resource Variables

    + + + + + + + + @@ -189,6 +204,10 @@

    Resource Variables

    + + + + @@ -220,22 +239,24 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    +

    Examples

    None.

    +

    Version

    2.3.0

    +

    See Also

    @@ -248,13 +269,13 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/notetext.html b/doc/resources/notetext.html index aeeecfa..42cf3a8 100644 --- a/doc/resources/notetext.html +++ b/doc/resources/notetext.html @@ -13,6 +13,7 @@

    NOTETEXT

    +

    Syntax

    @@ -36,32 +37,45 @@

    Syntax

    +

    Description

    NOTETEXT is the annotation text for a message. When defining NOTETEXT for a message, ANNOTATION must be set. To access -the value of NOTETEXT within -page layout resources, use the +the value of NOTETEXT use the $NOTETEXT$ resource variable.

    + + + + + +
    NOTE

    $NOTETEXT$ should only be used as part of the +NOTE resource. To display annotations for +messages within page layout resources, +$NOTE$ should be used. +

    +
    +

    The value of NOTETEXT is treated as HTML markup. Therefore, if you want to include characters like '<', '>', and '&', make sure to use the appropriate HTML entity reference.

    +

    Default Setting

    Nil

    +

    Resource Variables

    - @@ -82,8 +96,8 @@

    Resource Variables

    - - + + @@ -94,6 +108,14 @@

    Resource Variables

    + + + + + + + + @@ -130,10 +152,6 @@

    Resource Variables

    - - - - @@ -170,6 +188,14 @@

    Resource Variables

    + + + + + + + + @@ -194,6 +220,10 @@

    Resource Variables

    + + + + @@ -225,10 +255,10 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    +

    Examples

    See @@ -237,12 +267,14 @@

    Examples

    +

    Version

    -

    +

    2.3.0

    +

    See Also

    @@ -254,13 +286,13 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/otherindexes.html b/doc/resources/otherindexes.html index 4e544ed..faa2e60 100644 --- a/doc/resources/otherindexes.html +++ b/doc/resources/otherindexes.html @@ -196,10 +196,10 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/outdir.html b/doc/resources/outdir.html index 8d8541e..00c789e 100644 --- a/doc/resources/outdir.html +++ b/doc/resources/outdir.html @@ -89,8 +89,8 @@

    See Also

    98/03/03 18:19:46
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/perlinc.html b/doc/resources/perlinc.html index 48d2024..fd3435e 100644 --- a/doc/resources/perlinc.html +++ b/doc/resources/perlinc.html @@ -121,10 +121,10 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/posixstrftime.html b/doc/resources/posixstrftime.html new file mode 100644 index 0000000..b177ed2 --- /dev/null +++ b/doc/resources/posixstrftime.html @@ -0,0 +1,121 @@ + + + +MHonArc Resources: POSIXSTRFTIME + + + +
    +MHonArc Resource List
    +
    + +
    +

    POSIXSTRFTIME

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    +M2H_POSIXSTRFTIME=[ 0 | 1 ] +

    +
    + +
    Element
    +


    +<POSIXSTRFTIME>
    +<NOPOSIXSTRFTIME>
    +

    +
    + +
    Command-line Option
    +


    +-posixstrftime
    +-noposixstrftime +

    +
    + +
    + + +
    +

    Description

    + +

    If POSIXSTRFTIME is set, then POSIX::strftime() +is used to process time format strings as defined by the +GMTDATEFMT, +LOCALDATEFMT, +MSGGMTDATEFMT, and +MSGLOCALDATEFMT resources. +If POSIX::strftime() is used, the resources +MONTHS, +MONTHSABR, +WEEKDAYS, and +WEEKDAYSABR will have no +effect. Month names and weekday names will be determined +by your systems locale. See your system's manual page on +strftime() for more information. +

    + +

    If not set (the default), time format strings are processed +by MHonArc specific code. A reason to activate POSIXSTRFTIME is +if your system's strftime() supports conversion +specifications you require which are not supported by MHonArc. +

    + + +
    +

    Default Setting

    + +

    Off. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    None. +

    + + +
    +

    Version

    + +

    2.4.3 +

    + + +
    +

    See Also

    + +

    +GMTDATEFMT, +LOCALDATEFMT, +MSGGMTDATEFMT, +MSGLOCALDATEFMT +

    + + +
    +
    +00/10/28 11:13:13
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/prevbutton.html b/doc/resources/prevbutton.html index deea4d1..fb3c4db 100644 --- a/doc/resources/prevbutton.html +++ b/doc/resources/prevbutton.html @@ -42,11 +42,12 @@

    Syntax

    Description

    -

    PREVBUTTON defines the value for the $BUTTON(PREV)$ -resource variable when there is a previous message to the current message -according to the message list order of the main index. See the -PREVBUTTONIA for defining the -value of $BUTTON(PREV)$ when there is no next message. +

    PREVBUTTON defines the value of the $BUTTON(PREV)$ +resource when a message has a predecessor. That is, if the +main index message list lists a message before the current +message, $BUTTON(PREV)$ will take on the value +of PREVBUTTON. If a previous message doesn't exist, the PREVBUTTONIA value will be used instead.

    @@ -64,7 +65,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +85,8 @@

    Resource Variables

    - - + + @@ -97,6 +97,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +141,6 @@

    Resource Variables

    - - - - @@ -173,6 +177,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +209,10 @@

    Resource Variables

    + + + + @@ -228,7 +244,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -268,10 +283,10 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/prevbuttonia.html b/doc/resources/prevbuttonia.html index d3dac4a..0b26e1e 100644 --- a/doc/resources/prevbuttonia.html +++ b/doc/resources/prevbuttonia.html @@ -56,7 +56,7 @@

    Default Setting

     <PrevButtonIA chop>
 [Date Prev]
-<PrevButtonIA>
+</PrevButtonIA>
    @@ -64,7 +64,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +84,8 @@

    Resource Variables

    - - + + @@ -97,6 +96,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +140,6 @@

    Resource Variables

    - - - - @@ -173,6 +176,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +208,10 @@

    Resource Variables

    + + + + @@ -228,7 +243,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -268,10 +282,10 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/prevlink.html b/doc/resources/prevlink.html index 652ffa0..eaea3e6 100644 --- a/doc/resources/prevlink.html +++ b/doc/resources/prevlink.html @@ -76,7 +76,6 @@

    Default Setting

    Resource Variables

    - @@ -97,8 +96,8 @@

    Resource Variables

    - - + + @@ -109,6 +108,14 @@

    Resource Variables

    + + + + + + + + @@ -145,10 +152,6 @@

    Resource Variables

    - - - - @@ -185,6 +188,14 @@

    Resource Variables

    + + + + + + + + @@ -209,6 +220,10 @@

    Resource Variables

    + + + + @@ -240,7 +255,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -283,10 +297,10 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/prevlinkia.html b/doc/resources/prevlinkia.html index 4bf1617..7a2232e 100644 --- a/doc/resources/prevlinkia.html +++ b/doc/resources/prevlinkia.html @@ -64,7 +64,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +84,8 @@

    Resource Variables

    - - + + @@ -97,6 +96,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +140,6 @@

    Resource Variables

    - - - - @@ -173,6 +176,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +208,10 @@

    Resource Variables

    + + + + @@ -228,7 +243,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -261,10 +275,10 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/prevpglink.html b/doc/resources/prevpglink.html index 49ee2d6..8f57a16 100644 --- a/doc/resources/prevpglink.html +++ b/doc/resources/prevpglink.html @@ -68,7 +68,6 @@

    Default Setting

    Resource Variables

    - @@ -77,8 +76,8 @@

    Resource Variables

    - - + + @@ -105,10 +104,6 @@

    Resource Variables

    - - - - @@ -138,7 +133,11 @@

    Resource Variables

    - + + + + + @@ -164,7 +163,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $PGLINK$Markup linking to a main index page.Markup linking to an index page.
    $PGLINKLIST$List of links to index pages.
    $PROG$ $VERSION$ Program version.
    @@ -196,10 +194,10 @@

    See Also

    -98/09/19 18:27:14
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/prevpglinkia.html b/doc/resources/prevpglinkia.html index 546a452..2c0e87f 100644 --- a/doc/resources/prevpglinkia.html +++ b/doc/resources/prevpglinkia.html @@ -68,7 +68,6 @@

    Default Setting

    Resource Variables

    - @@ -77,8 +76,8 @@

    Resource Variables

    - - + + @@ -105,10 +104,6 @@

    Resource Variables

    - - - - @@ -138,7 +133,11 @@

    Resource Variables

    - + + + + + @@ -164,7 +163,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $PGLINK$Markup linking to a main index page.Markup linking to an index page.
    $PGLINKLIST$List of links to index pages.
    $PROG$ $VERSION$ Program version.
    @@ -196,10 +194,10 @@

    See Also

    -98/09/19 18:27:15
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/quiet.html b/doc/resources/quiet.html index b0319ee..76e2406 100644 --- a/doc/resources/quiet.html +++ b/doc/resources/quiet.html @@ -84,10 +84,10 @@

    See Also

    -98/09/19 18:27:15
    +00/10/28 11:13:07
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/rcfile.html b/doc/resources/rcfile.html index fe0201b..f8788c4 100644 --- a/doc/resources/rcfile.html +++ b/doc/resources/rcfile.html @@ -60,13 +60,18 @@

    Resource file syntax

    that regular text can be put anywhere outside of recognized elements for commenting purposes.

    -
    NOTE
    -

    You should use SGML comment declarations + + + + + +
    NOTE

    You should use SGML comment declarations (<!-- ... -->) when commenting a -resource file. This will eliminate possible conflict with later -versions of MHonArc if more stricter parsing rules are -adopted.

    - +resource file. This will eliminate possible conflicts +if more stricter parsing rules are adopted. +

    +
    +

  • The opening tag of an element must occur by itself on a single line. Whitespace is allowed before the the open tag.

    @@ -101,6 +106,11 @@

    Resource file syntax

  • Elements can occur in any order in the resource file.

    +

  • Elements canNOT be nested. Many resources define +the values of resource variables, which +may be used within resource elements. +

    +

    Resource variables

    @@ -298,13 +308,13 @@

    See Also

    -98/09/19 18:27:15
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/refsbegin.html b/doc/resources/refsbegin.html index e46c7d2..a831210 100644 --- a/doc/resources/refsbegin.html +++ b/doc/resources/refsbegin.html @@ -116,13 +116,13 @@

    See Also

    -98/09/19 18:27:15
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/refsend.html b/doc/resources/refsend.html index 024857f..0097784 100644 --- a/doc/resources/refsend.html +++ b/doc/resources/refsend.html @@ -98,13 +98,13 @@

    See Also

    -98/09/19 18:27:15
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/refslitxt.html b/doc/resources/refslitxt.html index 3b3946d..ec8b5b2 100644 --- a/doc/resources/refslitxt.html +++ b/doc/resources/refslitxt.html @@ -67,7 +67,6 @@

    Default Setting

    Resource Variables

    - @@ -92,6 +91,10 @@

    Resource Variables

    + + + + @@ -100,6 +103,14 @@

    Resource Variables

    + + + + + + + + @@ -136,6 +147,14 @@

    Resource Variables

    + + + + + + + + @@ -145,7 +164,7 @@

    Resource Variables

    - + @@ -155,7 +174,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -188,13 +206,13 @@

    See Also

    -98/09/19 18:27:15
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/reverse.html b/doc/resources/reverse.html index 125aa35..9bf4d72 100644 --- a/doc/resources/reverse.html +++ b/doc/resources/reverse.html @@ -103,10 +103,10 @@

    See Also

    -98/09/19 18:27:15
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/rmm.html b/doc/resources/rmm.html index f49f87a..e3b2149 100644 --- a/doc/resources/rmm.html +++ b/doc/resources/rmm.html @@ -124,10 +124,10 @@

    See Also

    -98/09/19 18:27:15
    +00/10/28 11:13:08
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/saveresources.html b/doc/resources/saveresources.html new file mode 100644 index 0000000..e19d286 --- /dev/null +++ b/doc/resources/saveresources.html @@ -0,0 +1,109 @@ + + + +MHonArc Resources: SAVERESOURCES + + + +
    +MHonArc Resource List
    +
    + +
    +

    SAVERESOURCES

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    +M2H_SAVERESOURCES= [ 0 | 1 ] +

    +
    + +
    Element
    +


    +<SAVERESOURCES>
    +<NOSAVERESOURCES>
    +

    +
    + +
    Command-line Option
    +


    +-saveresources
    +-nosaveresources +

    +
    + +
    + + +
    +

    Description

    + +

    SAVERESOURCES determines if MHonArc will save resource settings +in the database. If set, resources settings +will be saved. This eliminates the need to respecify a +resource file, envariables, and/or +command-line options for future archive operations, and it increases +execution performance. +

    +

    You may want to shut off SAVERESOURCES if you always specify +a resource file when invoking MHonArc. +This will reduce the size of the database. +

    + + +
    +

    Default Setting

    + +

    True. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    None. +

    + + +
    +

    Version

    + +

    2.4.1 +

    + + +
    +

    See Also

    + +

    +DBFILE, +RCFILE. +

    + + +
    +
    +00/10/28 11:13:09
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/scan.html b/doc/resources/scan.html index e6cbc66..a6808d6 100644 --- a/doc/resources/scan.html +++ b/doc/resources/scan.html @@ -144,10 +144,10 @@

    See Also

    -98/09/19 18:27:15
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1997-1998 Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998 Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/single.html b/doc/resources/single.html index 8df46a2..12a56b7 100644 --- a/doc/resources/single.html +++ b/doc/resources/single.html @@ -98,13 +98,13 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/sort.html b/doc/resources/sort.html index 803b383..826609d 100644 --- a/doc/resources/sort.html +++ b/doc/resources/sort.html @@ -92,10 +92,10 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/spammode.html b/doc/resources/spammode.html new file mode 100644 index 0000000..88c54d2 --- /dev/null +++ b/doc/resources/spammode.html @@ -0,0 +1,131 @@ + + + +MHonArc Resources: SPAMMODE + + + +
    +MHonArc Resource List
    +
    + +
    +

    SPAMMODE

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    +M2H_SPAMMODE=[ 0 | 1 ] +

    +
    + +
    Element
    +


    +<SPAMMODE>
    +<NOSPAMMODE>
    +

    +
    + +
    Command-line Option
    +


    +-spammode
    +-nospammode +

    +
    + +
    + + +
    +

    Description

    + +

    SPAMMODE determines if MHonArc will perform actions to deter +spam address harvesters or not. If SPAMMODE is true, it changes the default +values of various resources that display email addresses. The +following default resource values are affected: +

    +
    +
    LITEMPLATE
    +
    $FROMNAME$ is used +instead of $FROM$.
    +
    MSGPGBEGIN
    +
    The <LINK REV="made" ...> is removed.
    +
    FOLUPLITXT
    +
    $FROMNAME$ is used +instead of $FROM$.
    +
    REFSLITXT
    +
    $FROMNAME$ is used +instead of $FROM$.
    +
    ADDRESSMODIFYCODE
    +
    Is defined as +"s|([\!\%\w\.\-+=/]+@)([\w\.\-]+)|$1.('x' x length($2))|ge" +(this has the effect of preserving the local-part of the address and +complete masking out the domain portion).
    +
    MAILTOURL
    +
    Is defined as +"mailto:$TOADDRNAME$@DOMAIN.HIDDEN"
    +
    +

    Note, a user defined setting of an above resource will override +any effects that SPAMMODE has on the resource. +

    + + +
    +

    Default Setting

    + +

    Off. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    None. +

    + + +
    +

    Version

    + +

    2.4.0 +

    + + +
    +

    See Also

    + +

    +ADDRESSMODIFYCODE, +FOLUPLITXT, +LITEMPLATE, +MAILTOURL, +MSGPGBEGIN, +REFSLITXT +

    + + +
    +
    +00/10/28 11:13:09
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/ssmarkup.html b/doc/resources/ssmarkup.html new file mode 100644 index 0000000..247d8ee --- /dev/null +++ b/doc/resources/ssmarkup.html @@ -0,0 +1,110 @@ + + + +MHonArc Resources: SSMARKUP + + + +
    +MHonArc Resource List
    +
    + +
    +

    SSMARKUP

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    N/A +

    +
    + +
    Element
    +


    +<SSMARKUP>
    +markup...
    +</SSMARKUP>
    +

    +
    + +
    Command-line Option
    +

    N/A +

    +
    + +
    + + +
    +

    Description

    + +

    SSMARKUP defines any markup that occurs at the very +beginning of all created HTML pages. This resource +may be used to include any server-side processing markup that must +occur before any HTML-related markup. +

    + + +
    +

    Default Setting

    + +

    Nil. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    The following example is stolen from the MHonArc mailing list +which lead to the addition of SSMARKUP to MHonArc. In this markup, +some server-side markup is added to check if the user is logged +in: +

    +
    +<SSMarkup>
+<%@ LANGUAGE=VBSCRIPT %>
+<%
+If Not Session("LoginOK") Then Response.redirect "/default.htm"
+%>
+</SSMarkup>
+
    + + +
    +

    Version

    + +

    2.4.0 +

    + + +
    +

    See Also

    + +

    +

    + + +
    +
    +00/10/28 11:13:09
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/stderr.html b/doc/resources/stderr.html new file mode 100644 index 0000000..6fee95d --- /dev/null +++ b/doc/resources/stderr.html @@ -0,0 +1,108 @@ + + + +MHonArc Resources: STDERR + + + +
    +MHonArc Resource List
    +
    + +
    +

    STDERR

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    N/A +

    +
    + +
    Element
    +

    N/A +

    +
    + +
    Command-line Option
    +


    +-stderr filename +

    +
    + +
    + + +
    +

    Description

    + +

    STDERR can be used to have all output that would go standard error to +a specified file. Messages that go to standard error are +warnings and errors. +If the filename specified already +exists, any standard error data generated will be appended to +filename. +

    + +

    Note, most system shells (Unix) provide the ability to redirect +standard error to a file. STDERR is provided where such functionality +is not available or easy to achieve. +

    + + +
    +

    Default Setting

    + + +

    The default location of standard error, which is normally the +terminal. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    None. +

    + + +
    +

    Version

    + +

    2.4.0 +

    + + +
    +

    See Also

    + +

    +STDIN, +STDOUT +

    + + +
    +
    +00/10/28 11:13:09
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/stdin.html b/doc/resources/stdin.html new file mode 100644 index 0000000..e828aab --- /dev/null +++ b/doc/resources/stdin.html @@ -0,0 +1,111 @@ + + + +MHonArc Resources: STDIN + + + +
    +MHonArc Resource List
    +
    + +
    +

    STDIN

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    N/A +

    +
    + +
    Element
    +

    N/A +

    +
    + +
    Command-line Option
    +


    +-stdin filename +

    +
    + +
    + + +
    +

    Description

    + +

    STDIN can be used to specify a file to treat as standard input. +

    + +

    Note, most system shells (Unix) provide the ability to redirect +standard input from a file or other process. STDIN is provided where such +functionality is not available or easy to achieve. +

    + + +
    +

    Default Setting

    + +

    The default location of standard input, which is usually the +terminal. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    One way to perform an ADD operation for +a single message is something like the following: +

    +
    +    shell> mhonarc -add -outdir /path/to/archive -stdin mesg.822
+
    +

    However, any decent shell would allow: +

    +
    +    shell> mhonarc -add -outdir /path/to/archive < mesg.822
+
    + + +
    +

    Version

    + +

    2.4.2 +

    + + +
    +

    See Also

    + +

    +STDERR, +STDOUT +

    + + +
    +
    +00/10/28 11:13:09
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/stdout.html b/doc/resources/stdout.html new file mode 100644 index 0000000..1fcd53c --- /dev/null +++ b/doc/resources/stdout.html @@ -0,0 +1,109 @@ + + + +MHonArc Resources: STDOUT + + + +
    +MHonArc Resource List
    +
    + +
    +

    STDOUT

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    N/A +

    +
    + +
    Element
    +

    N/A +

    +
    + +
    Command-line Option
    +


    +-stdout filename +

    +
    + +
    + + +
    +

    Description

    + +

    STDOUT can be used to have all output that would go standard output to +a specified file. Output that goes to standard output are +informational/status +messages, or in the case of SINGLE, the +converted mail message. +If the filename specified already +exists, any standard output data generated will be appended to +filename. +

    + +

    Note, most system shells (Unix) provide the ability to redirect +standard output to a file. STDOUT is provided where such functionality +is not available or easy to achieve. +

    + + +
    +

    Default Setting

    + +

    The default location of standard output, which is normally the +terminal. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    None. +

    + + +
    +

    Version

    + +

    2.4.0 +

    + + +
    +

    See Also

    + +

    +STDERR, +STDIN +

    + + +
    +
    +00/10/28 11:13:09
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/subjectarticlerxp.html b/doc/resources/subjectarticlerxp.html index 1eb2199..a02c089 100644 --- a/doc/resources/subjectarticlerxp.html +++ b/doc/resources/subjectarticlerxp.html @@ -97,13 +97,13 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/subjectbegin.html b/doc/resources/subjectbegin.html index b59525d..942bf6a 100644 --- a/doc/resources/subjectbegin.html +++ b/doc/resources/subjectbegin.html @@ -29,7 +29,6 @@

    Syntax

    <SUBJECTBEGIN>
    markup ...
    </SUBJECTBEGIN>
    -

    • @@ -68,7 +67,6 @@

    Default Setting

    Resource Variables

    - @@ -93,6 +91,10 @@

    Resource Variables

    + + + + @@ -101,6 +103,14 @@

    Resource Variables

    + + + + + + + + @@ -137,6 +147,14 @@

    Resource Variables

    + + + + + + + + @@ -146,7 +164,7 @@

    Resource Variables

    - + @@ -156,7 +174,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -204,13 +221,13 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/subjectend.html b/doc/resources/subjectend.html index 81de6b1..39fea35 100644 --- a/doc/resources/subjectend.html +++ b/doc/resources/subjectend.html @@ -29,7 +29,6 @@

    Syntax

    <SUBJECTEND>
    markup ...
    </SUBJECTEND>
    -

    @@ -91,13 +90,13 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/subjectheader.html b/doc/resources/subjectheader.html index b0347b6..ae5ac86 100644 --- a/doc/resources/subjectheader.html +++ b/doc/resources/subjectheader.html @@ -43,11 +43,7 @@

    Syntax

    Description

    SUBJECTHEADER defines the markup for the main subject line -above the message header of message pages. If the -SUBJECTHEADER resource is changed and messages already exist -in the archive, the existing messages will not inherit the change. -Therefore, you need to be sure about the value of SUBJECTHEADER -when creating an archive. +above the message header of message pages.

    @@ -66,11 +62,14 @@

    Default Setting

    Resource Variables

    - + + + + @@ -79,6 +78,14 @@

    Resource Variables

    + + + + + + + + @@ -87,14 +94,66 @@

    Resource Variables

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -107,18 +166,81 @@

    Resource Variables

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -
    VariableValue
    $BUTTON$Button markup linking to a message.
    $DATE$ The date of the message.
    Message date in dd/mm/yyyy format.
    $DOCURL$URL to documentation.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    $GMTDATE$Current GMT date.
    $ICON$The context-type sensistive icon.
    $ICONURL$The URL to the context-type sensistive icon.
    $IDXFNAME$Filename of main index page.
    $IDXLABEL$Label for main index page.
    $IDXPREFIX$Prefix of filenames of main index pages.
    $IDXSIZE$Max number of messages that may be listed in index page.
    $IDXTITLE$The title of the main index page.
    $LINK$Link markup linking to a message.
    $LOCALDATE$Current local date.
    $MMDDYYYY$ Message date in mm/dd/yyyy format.
    $MSG$Filename of message.
    $MSGGMTDATE$ GMT date of current message.
    Local date of current message.
    $MSGNUM$The message number assigned to the message by MHonArc (includes leading zeros).
    $MSGPREFIX$ Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$Number of explicit follow-ups to the message.
    $NUMOFMSG$Number of messages in the archive.
    $NUMOFPAGES$Number of index pages.
    $ORDNUM$The current listing number of the message.
    $OUTDIR$Pathname of archive.
    $PROG$Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $TIDXFNAME$Filename of thread index page.
    $TIDXLABEL$Label for thread index page.
    $TIDXPREFIX$Prefix of filenames of thread index pages.
    $TIDXTITLE$Title of thread index.
    $TSLICE$A slice of the thread listing relative to the current message. Size of slice determined by the TSLICE resource.
    $VERSION$Program version.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -145,10 +267,11 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/subjectreplyrxp.html b/doc/resources/subjectreplyrxp.html index c009f7d..f5ace8a 100644 --- a/doc/resources/subjectreplyrxp.html +++ b/doc/resources/subjectreplyrxp.html @@ -96,13 +96,13 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/subjectstripcode.html b/doc/resources/subjectstripcode.html index cc4b521..998072b 100644 --- a/doc/resources/subjectstripcode.html +++ b/doc/resources/subjectstripcode.html @@ -100,13 +100,13 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/subjectthreads.html b/doc/resources/subjectthreads.html new file mode 100644 index 0000000..d806d9c --- /dev/null +++ b/doc/resources/subjectthreads.html @@ -0,0 +1,109 @@ + + + +MHonArc Resources: SUBJECTTHREADS + + + +
    +MHonArc Resource List
    +
    + +
    +

    SUBJECTTHREADS

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    +M2H_SUBJECTTHREADS=[ 0 | 1 ] +

    +
    + +
    Element
    +


    +<SUBJECTTHREADS>
    +<NOSUBJECTTHREADS>
    +

    +
    + +
    Command-line Option
    +


    +-subjectthreads
    +-nosubjectthreads +

    +
    + +
    + + +
    +

    Description

    + +

    SUBJECTTHREADS determines if MHonArc will examine message subjects +for detecting message threads. It is still common for mail composition +software to not include a message-id reference when a user replies to a message. +When SUBJECTTHREADS is active, after checking for message-id references, +MHonArc will then look for messages with the same subjects and group +them into the same thread. Subject thread groups are contained +by the +TSUBJECTBEG and +TSUBJECTEND of the thread index. +

    + + +
    +

    Default Setting

    + +

    On. +

    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    None. +

    + + +
    +

    Version

    + +

    2.4.0 +

    + + +
    +

    See Also

    + +

    +SUBJECTREPLYRXP, +TSUBJECTBEG, +TSUBJECTEND +

    + + +
    +
    +00/10/28 11:13:10
    + +MHonArc
    +Copyright © 1999, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/subsort.html b/doc/resources/subsort.html index bec204a..00491f7 100644 --- a/doc/resources/subsort.html +++ b/doc/resources/subsort.html @@ -91,10 +91,10 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tcontbegin.html b/doc/resources/tcontbegin.html index 255d186..b568184 100644 --- a/doc/resources/tcontbegin.html +++ b/doc/resources/tcontbegin.html @@ -27,7 +27,6 @@

    Syntax

    <TCONTBEGIN>
    markup...
    </TCONTBEGIN>
    -

    @@ -77,7 +76,6 @@

    Default Setting

    Resource Variables

    - @@ -102,6 +100,10 @@

    Resource Variables

    + + + + @@ -110,6 +112,14 @@

    Resource Variables

    + + + + + + + + @@ -146,6 +156,14 @@

    Resource Variables

    + + + + + + + + @@ -155,7 +173,7 @@

    Resource Variables

    - + @@ -165,7 +183,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -192,13 +209,13 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tcontend.html b/doc/resources/tcontend.html index b109649..8cb3ff4 100644 --- a/doc/resources/tcontend.html +++ b/doc/resources/tcontend.html @@ -27,7 +27,6 @@

    Syntax

    <TCONTEND>
    markup...
    </TCONTEND>
    -

    @@ -84,13 +83,13 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tfoot.html b/doc/resources/tfoot.html index 0f81ebe..3fc828c 100644 --- a/doc/resources/tfoot.html +++ b/doc/resources/tfoot.html @@ -62,7 +62,6 @@

    Default Setting

    Resource Variables

    - @@ -71,8 +70,8 @@

    Resource Variables

    - - + + @@ -99,10 +98,6 @@

    Resource Variables

    - - - - @@ -146,7 +141,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $VERSION$ Program version.
    @@ -196,10 +190,10 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:09
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/thead.html b/doc/resources/thead.html index f36713b..52cf417 100644 --- a/doc/resources/thead.html +++ b/doc/resources/thead.html @@ -83,7 +83,6 @@

    Default Setting

    Resource Variables

    - @@ -92,8 +91,8 @@

    Resource Variables

    - - + + @@ -120,10 +119,6 @@

    Resource Variables

    - - - - @@ -167,7 +162,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $VERSION$ Program version.
    @@ -221,10 +215,10 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/thread.html b/doc/resources/thread.html index 614919a..e241f3e 100644 --- a/doc/resources/thread.html +++ b/doc/resources/thread.html @@ -88,10 +88,10 @@

    See Also

    -98/09/19 18:27:16
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tidxfname.html b/doc/resources/tidxfname.html index f81dbfa..994dde3 100644 --- a/doc/resources/tidxfname.html +++ b/doc/resources/tidxfname.html @@ -90,10 +90,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tidxlabel.html b/doc/resources/tidxlabel.html index b3939bb..3dcdc98 100644 --- a/doc/resources/tidxlabel.html +++ b/doc/resources/tidxlabel.html @@ -29,7 +29,6 @@

    Syntax

    <TIDXLABEL>
    markup ... </TIDXLABEL>
    -

    @@ -90,13 +89,13 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tidxpgbegin.html b/doc/resources/tidxpgbegin.html index ea2f834..e0e9c60 100644 --- a/doc/resources/tidxpgbegin.html +++ b/doc/resources/tidxpgbegin.html @@ -73,7 +73,6 @@

    Default Setting

    Resource Variables

    - @@ -82,8 +81,8 @@

    Resource Variables

    - - + + @@ -110,10 +109,6 @@

    Resource Variables

    - - - - @@ -157,7 +152,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $VERSION$ Program version.
    @@ -200,10 +194,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tidxpgend.html b/doc/resources/tidxpgend.html index 3e4a953..b6b0416 100644 --- a/doc/resources/tidxpgend.html +++ b/doc/resources/tidxpgend.html @@ -62,7 +62,6 @@

    Default Setting

    Resource Variables

    - @@ -71,8 +70,8 @@

    Resource Variables

    - - + + @@ -99,10 +98,6 @@

    Resource Variables

    - - - - @@ -146,7 +141,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $VERSION$ Program version.
    @@ -174,10 +168,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tidxprefix.html b/doc/resources/tidxprefix.html index 1189edc..15d8c38 100644 --- a/doc/resources/tidxprefix.html +++ b/doc/resources/tidxprefix.html @@ -106,10 +106,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/timezones.html b/doc/resources/timezones.html index 781e130..c25a997 100644 --- a/doc/resources/timezones.html +++ b/doc/resources/timezones.html @@ -26,11 +26,10 @@

    Syntax

    Element


    <TIMEZONES>
     -timezone_acronym:hour_offset
    -timezone_acronym:hour_offset
    +timezone_acronym:time_offset
    +timezone_acronym:time_offset
    ...
    </TIMEZONES>
     -

    @@ -50,44 +49,227 @@

    Description

    can be defined only by the TIMEZONES element The format of each line of content is -"timezone_acronym:hour_offset". +"timezone_acronym:time_offset", +where time_offset is in [-]HHMM notation. Examples of timezone acronyms are: UTC, PDT, -EST. The hour offset should be positive for timezones +EST. The time offsets should be positive for timezones West of UTC, and negative for time zones East of UTC.

    -

    MHonArc has a default list of timezone acronyms -defined with hour offsets. Therefore, the list given in -the resource file will augment the default list, unless the -"Override" attribute is specified. If -"Override" is specified, the default list, along with any -other lists specified in previous TIMEZONES elements, -are discarded, and only the timezone acronyms specified in the -TIMEZONES element will be used.

    - -

    Much of the time, the date used by MHonArc has an hour -offset instead of a timezone acronym. However, mail messages may + + + + + +
    NOTE

    Timezone settings in MHonArc are the negative inverse +of what is used in dates in messages. For example, an EST time will +look like the following in a mail message: +

    +
    +    Sat, 10 Sep 1994 15:11:10 -0500
+
    +

    Notice that -0500 is used for EST. However, in MHonArc, +EST is mapped to 0500, since 0500 must be added to +the specified date/time to get the UTC date/time. +

    +
    + +

    MHonArc has a default list of timezone acronyms defined with +time offsets. Therefore, the list given in the resource file will +augment the default list. If "Override" attribute is +specified, any local lists specified in previous TIMEZONES +elements are replaced. +

    + +

    Much of the time, the date used by MHonArc has a time +offset instead of a timezone acronym. However, mail messages may contain timezone acronyms in received/sent dates and MHonArc -must be told what the hour offset from UTC the timezone acronym -represents in order to properly sort messages by date.

    +must be told what hour offset to add to the give time to get UTC time +to properly sort messages by date.

    Default Setting

    +

    The following table shows the zones and values currently known +to MHonArc: +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    ZoneOffsetDescription
    ACDT-1030Australian Central Daylight
    ACST-0930Australian Central Standard
    ADT0300(US) Atlantic Daylight
    AEDT-1100Australian East Daylight
    AEST-1000Australian East Standard
    AHDT0900 
    AHST1000 
    AST0400(US) Atlantic Standard
    AT0200Azores
    AWDT-0900Australian West Daylight
    AWST-0800Australian West Standard
    BAT-0300Baghdad
    BDST-0200British Double Summer
    BET1100Bering Standard
    BST-0100British Summer
    BT-0300Baghdad
    BZT20300Brazil Zone 2
    CADT-1030Central Australian Daylight
    CAST-0930Central Australian Standard
    CAT1000Central Alaska
    CCT-0800China Coast
    CDT0500(US) Central Daylight
    CED-0200Central European Daylight
    CET-0100Central European
    CST0600(US) Central Standard
    EAST-1000Eastern Australian Standard
    EDT0400(US) Eastern Daylight
    EED-0300Eastern European Daylight
    EET-0200Eastern Europe
    EEST-0300Eastern Europe Summer
    EST0500(US) Eastern Standard
    FST-0200French Summer
    FWT-0100French Winter
    GMT0000Greenwich Mean
    GST-1000Guam Standard
    HDT0900Hawaii Daylight
    HST1000Hawaii Standard
    IDLE-1200Internation Date Line East
    IDLW1200Internation Date Line West
    IST-0530Indian Standard
    IT-0330Iran
    JST-0900Japan Standard
    JT-0700Java
    KST-0900Korean Standard
    MDT0600(US) Mountain Daylight
    MED-0200Middle European Daylight
    MET-0100Middle European
    MEST-0200Middle European Summer
    MEWT-0100Middle European Winter
    MST0700(US) Mountain Standard
    MT-0800Moluccas
    NDT0230Newfoundland Daylight
    NFT0330Newfoundland
    NT1100Nome
    NST-0630North Sumatra
    NZ-1100New Zealand
    NZST-1200New Zealand Standard
    NZDT-1300New Zealand Daylight
    NZT-1200New Zealand
    PDT0700(US) Pacific Daylight
    PST0800(US) Pacific Standard
    ROK-0900Republic of Korea
    SAD-1000South Australia Daylight
    SAST-0900South Australia Standard
    SAT-0900South Australia
    SDT-1000South Australia Daylight
    SST-0200Swedish Summer
    SWT-0100Swedish Winter
    USZ3-0400USSR Zone 3
    USZ4-0500USSR Zone 4
    USZ5-0600USSR Zone 5
    USZ6-0700USSR Zone 6
    UT0000Universal Coordinated
    UTC0000Universal Coordinated
    UZ10-1100USSR Zone 10
    WAT0100West Africa
    WET0000West European
    WST-0800West Australian Standard
    YDT0800Yukon Daylight
    YST0900Yukon Standard
    ZP4-0400USSR Zone 3
    ZP5-0500USSR Zone 4
    ZP6-0600USSR Zone 5
    + +

    The following shows how these values would be specified in a +resource file: +

     <TimeZones>
-UTC:0
-GMT:0
-AST:4
-ADT:3
-EST:5
-EDT:4
-CST:6
-CDT:5
-MST:7
-MDT:6
-PST:8
-PDT:7
+ACDT:-1030
+ACST:-0930
+ADT:0300
+AEDT:-1100
+AEST:-1000
+AHDT:0900
+AHST:1000
+AST:0400
+AT:0200
+AWDT:-0900
+AWST:-0800
+BAT:-0300
+BDST:-0200
+BET:1100
+BST:-0100
+BT:-0300
+BZT2:0300
+CADT:-1030
+CAST:-0930
+CAT:1000
+CCT:-0800
+CDT:0500
+CED:-0200
+CET:-0100
+CST:0600
+EAST:-1000
+EDT:0400
+EED:-0300
+EET:-0200
+EEST:-0300
+EST:0500
+FST:-0200
+FWT:-0100
+GMT:0000
+GST:-1000
+HDT:0900
+HST:1000
+IDLE:-1200
+IDLW:1200
+IST:-0530
+IT:-0330
+JST:-0900
+JT:-0700
+KST:-0900
+MDT:0600
+MED:-0200
+MET:-0100
+MEST:-0200
+MEWT:-0100
+MST:0700
+MT:-0800
+NDT:0230
+NFT:0330
+NT:1100
+NST:-0630
+NZ:-1100
+NZST:-1200
+NZDT:-1300
+NZT:-1200
+PDT:0700
+PST:0800
+ROK:-0900
+SAD:-1000
+SAST:-0900
+SAT:-0900
+SDT:-1000
+SST:-0200
+SWT:-0100
+USZ3:-0400
+USZ4:-0500
+USZ5:-0600
+USZ6:-0700
+UT:0000
+UTC:0000
+UZ10:-1100
+WAT:0100
+WET:0000
+WST:-0800
+YDT:0800
+YST:0900
+ZP4:-0400
+ZP5:-0500
+ZP6:-0600
 </TimeZones>
    @@ -102,8 +284,27 @@

    Resource Variables

    Examples

    -

    None. +

    Some zone acronyms are not unique, and have different time offsets. +The following table describes alternative values for these zones: +

    + + + + + + + +
    ZoneOffsetDescription
    BST0300Brazil Standard
    NST0330Newfoundland Standard
    GST0300Greenland Standard
    +

    To have the above values used instead of the default values use by +MHonArc, the following TIMEZONES setting would be used:

    +
    +<TimeZones>
+BST:0300
+NST:0330
+GST:0300
+</TimeZones>
+
    @@ -122,10 +323,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tindentbegin.html b/doc/resources/tindentbegin.html index e5b911a..f2dde3e 100644 --- a/doc/resources/tindentbegin.html +++ b/doc/resources/tindentbegin.html @@ -27,7 +27,6 @@

    Syntax

    <TINDENTBEGIN>
    markup...
    </TINDENTBEGIN>
    -

    @@ -111,13 +110,13 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tindentend.html b/doc/resources/tindentend.html index 85cee6a..2976b8d 100644 --- a/doc/resources/tindentend.html +++ b/doc/resources/tindentend.html @@ -27,7 +27,6 @@

    Syntax

    <TINDENTEND>
    markup...
    </TINDENTEND>
    -

    @@ -88,13 +87,13 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/title.html b/doc/resources/title.html index 5a0aeff..e403f12 100644 --- a/doc/resources/title.html +++ b/doc/resources/title.html @@ -98,10 +98,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tlevels.html b/doc/resources/tlevels.html index e663353..20b2ac4 100644 --- a/doc/resources/tlevels.html +++ b/doc/resources/tlevels.html @@ -88,10 +88,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tliend.html b/doc/resources/tliend.html index 7236dee..86d65c8 100644 --- a/doc/resources/tliend.html +++ b/doc/resources/tliend.html @@ -99,10 +99,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tlinone.html b/doc/resources/tlinone.html index c62660c..ea746f4 100644 --- a/doc/resources/tlinone.html +++ b/doc/resources/tlinone.html @@ -102,10 +102,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tlinoneend.html b/doc/resources/tlinoneend.html index 0e676bc..33bb3d2 100644 --- a/doc/resources/tlinoneend.html +++ b/doc/resources/tlinoneend.html @@ -101,10 +101,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tlitxt.html b/doc/resources/tlitxt.html index 1f7acbd..2c9f92f 100644 --- a/doc/resources/tlitxt.html +++ b/doc/resources/tlitxt.html @@ -73,7 +73,6 @@

    Default Setting

    Resource Variables

    - @@ -98,6 +97,10 @@

    Resource Variables

    + + + + @@ -106,6 +109,14 @@

    Resource Variables

    + + + + + + + + @@ -142,6 +153,14 @@

    Resource Variables

    + + + + + + + + @@ -151,7 +170,7 @@

    Resource Variables

    - + @@ -161,7 +180,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -194,10 +212,10 @@

    See Also

    -98/09/19 18:27:17
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tnextbutton.html b/doc/resources/tnextbutton.html index 5a3e0c5..6fd93f4 100644 --- a/doc/resources/tnextbutton.html +++ b/doc/resources/tnextbutton.html @@ -56,7 +56,7 @@

    Default Setting

     <TNextButton chop>
 [<A HREF="$MSG(TNEXT)$">Thread Next</A>]
-<TNextButton>
+</TNextButton>
    @@ -64,7 +64,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +84,8 @@

    Resource Variables

    - - + + @@ -97,6 +96,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +140,6 @@

    Resource Variables

    - - - - @@ -173,6 +176,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +208,10 @@

    Resource Variables

    + + + + @@ -228,7 +243,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -241,8 +255,8 @@

    Examples

     <TNextButton chop>
-<A HREF="$MSG(TNEXT)$"><IMG SRC="tnext.gif" ALT="[Thread Next]"></A>
-<TNextButton>
+<A HREF="$MSG(TNEXT)$"><IMG SRC="tnext.gif" ALT="[Thread Next]"></A>
+</TNextButton>
    @@ -266,10 +280,10 @@

    See Also

    -98/09/19 18:27:18
    +01/03/03 11:18:19
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tnextbuttonia.html b/doc/resources/tnextbuttonia.html index ead5fd8..3039376 100644 --- a/doc/resources/tnextbuttonia.html +++ b/doc/resources/tnextbuttonia.html @@ -64,7 +64,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +84,8 @@

    Resource Variables

    - - + + @@ -97,6 +96,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +140,6 @@

    Resource Variables

    - - - - @@ -173,6 +176,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +208,10 @@

    Resource Variables

    + + + + @@ -228,7 +243,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -266,10 +280,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tnextlink.html b/doc/resources/tnextlink.html index 17ed854..db77548 100644 --- a/doc/resources/tnextlink.html +++ b/doc/resources/tnextlink.html @@ -72,7 +72,6 @@

    Default Setting

    Resource Variables

    - @@ -93,8 +92,8 @@

    Resource Variables

    - - + + @@ -105,6 +104,14 @@

    Resource Variables

    + + + + + + + + @@ -141,10 +148,6 @@

    Resource Variables

    - - - - @@ -181,6 +184,14 @@

    Resource Variables

    + + + + + + + + @@ -205,6 +216,10 @@

    Resource Variables

    + + + + @@ -236,7 +251,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -277,10 +291,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tnextlinkia.html b/doc/resources/tnextlinkia.html index e4a652b..e178e6a 100644 --- a/doc/resources/tnextlinkia.html +++ b/doc/resources/tnextlinkia.html @@ -64,7 +64,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +84,8 @@

    Resource Variables

    - - + + @@ -97,6 +96,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +140,6 @@

    Resource Variables

    - - - - @@ -173,6 +176,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +208,10 @@

    Resource Variables

    + + + + @@ -228,7 +243,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -259,10 +273,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tnextpglink.html b/doc/resources/tnextpglink.html index e6a9ee1..1ed63ba 100644 --- a/doc/resources/tnextpglink.html +++ b/doc/resources/tnextpglink.html @@ -68,7 +68,6 @@

    Default Setting

    Resource Variables

    - @@ -77,8 +76,8 @@

    Resource Variables

    - - + + @@ -105,10 +104,6 @@

    Resource Variables

    - - - - @@ -152,7 +147,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $VERSION$ Program version.
    @@ -184,10 +178,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tnextpglinkia.html b/doc/resources/tnextpglinkia.html index 71858bb..00fa82f 100644 --- a/doc/resources/tnextpglinkia.html +++ b/doc/resources/tnextpglinkia.html @@ -68,7 +68,6 @@

    Default Setting

    Resource Variables

    - @@ -77,8 +76,8 @@

    Resource Variables

    - - + + @@ -105,10 +104,6 @@

    Resource Variables

    - - - - @@ -152,7 +147,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $VERSION$ Program version.
    @@ -184,10 +178,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/toplinks.html b/doc/resources/toplinks.html index b4d8028..90c49c6 100644 --- a/doc/resources/toplinks.html +++ b/doc/resources/toplinks.html @@ -72,7 +72,6 @@

    Default Setting

    Resource Variables

    - @@ -93,8 +92,8 @@

    Resource Variables

    - - + + @@ -105,6 +104,14 @@

    Resource Variables

    + + + + + + + + @@ -141,10 +148,6 @@

    Resource Variables

    - - - - @@ -181,6 +184,14 @@

    Resource Variables

    + + + + + + + + @@ -205,6 +216,10 @@

    Resource Variables

    + + + + @@ -236,7 +251,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -283,10 +297,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tprevbutton.html b/doc/resources/tprevbutton.html index 0fddcaf..39138eb 100644 --- a/doc/resources/tprevbutton.html +++ b/doc/resources/tprevbutton.html @@ -55,7 +55,7 @@

    Default Setting

     <TPrevButton chop>
-[<A HREF="$MSG(PREV)$">Thread Prev</A>]
+[<A HREF="$MSG(TPREV)$">Thread Prev</A>]
 </TPrevButton>
    @@ -64,7 +64,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +84,8 @@

    Resource Variables

    - - + + @@ -97,6 +96,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +140,6 @@

    Resource Variables

    - - - - @@ -173,6 +176,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +208,10 @@

    Resource Variables

    + + + + @@ -228,7 +243,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -266,10 +280,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tprevbuttonia.html b/doc/resources/tprevbuttonia.html index 150f311..99c985b 100644 --- a/doc/resources/tprevbuttonia.html +++ b/doc/resources/tprevbuttonia.html @@ -64,7 +64,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +84,8 @@

    Resource Variables

    - - + + @@ -97,6 +96,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +140,6 @@

    Resource Variables

    - - - - @@ -173,6 +176,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +208,10 @@

    Resource Variables

    + + + + @@ -228,7 +243,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -266,10 +280,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tprevlink.html b/doc/resources/tprevlink.html index 542661d..0c41df0 100644 --- a/doc/resources/tprevlink.html +++ b/doc/resources/tprevlink.html @@ -72,7 +72,6 @@

    Default Setting

    Resource Variables

    - @@ -93,8 +92,8 @@

    Resource Variables

    - - + + @@ -105,6 +104,14 @@

    Resource Variables

    + + + + + + + + @@ -141,10 +148,6 @@

    Resource Variables

    - - - - @@ -181,6 +184,14 @@

    Resource Variables

    + + + + + + + + @@ -205,6 +216,10 @@

    Resource Variables

    + + + + @@ -236,7 +251,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -277,10 +291,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tprevlinkia.html b/doc/resources/tprevlinkia.html index 966f330..7980947 100644 --- a/doc/resources/tprevlinkia.html +++ b/doc/resources/tprevlinkia.html @@ -64,7 +64,6 @@

    Default Setting

    Resource Variables

    - @@ -85,8 +84,8 @@

    Resource Variables

    - - + + @@ -97,6 +96,14 @@

    Resource Variables

    + + + + + + + + @@ -133,10 +140,6 @@

    Resource Variables

    - - - - @@ -173,6 +176,14 @@

    Resource Variables

    + + + + + + + + @@ -197,6 +208,10 @@

    Resource Variables

    + + + + @@ -228,7 +243,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -259,10 +273,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tprevpglink.html b/doc/resources/tprevpglink.html index 7ecbe39..c11653d 100644 --- a/doc/resources/tprevpglink.html +++ b/doc/resources/tprevpglink.html @@ -68,7 +68,6 @@

    Default Setting

    Resource Variables

    - @@ -77,8 +76,8 @@

    Resource Variables

    - - + + @@ -105,10 +104,6 @@

    Resource Variables

    - - - - @@ -152,7 +147,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $VERSION$ Program version.
    @@ -184,10 +178,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tprevpglinkia.html b/doc/resources/tprevpglinkia.html index 7500ed7..2ca1c06 100644 --- a/doc/resources/tprevpglinkia.html +++ b/doc/resources/tprevpglinkia.html @@ -68,7 +68,6 @@

    Default Setting

    Resource Variables

    - @@ -77,8 +76,8 @@

    Resource Variables

    - - + + @@ -105,10 +104,6 @@

    Resource Variables

    - - - - @@ -152,7 +147,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $VERSION$ Program version.
    @@ -184,10 +178,10 @@

    See Also

    -98/09/19 18:27:18
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/treverse.html b/doc/resources/treverse.html index 7623b90..3634e14 100644 --- a/doc/resources/treverse.html +++ b/doc/resources/treverse.html @@ -96,10 +96,10 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tsingletxt.html b/doc/resources/tsingletxt.html index ce32b89..a0e5142 100644 --- a/doc/resources/tsingletxt.html +++ b/doc/resources/tsingletxt.html @@ -71,7 +71,6 @@

    Default Setting

    Resource Variables

    - @@ -96,6 +95,10 @@

    Resource Variables

    + + + + @@ -104,6 +107,14 @@

    Resource Variables

    + + + + + + + + @@ -140,6 +151,14 @@

    Resource Variables

    + + + + + + + + @@ -149,7 +168,7 @@

    Resource Variables

    - + @@ -159,7 +178,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -188,10 +206,10 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tslice.html b/doc/resources/tslice.html index bfeb23c..9ddd1d8 100644 --- a/doc/resources/tslice.html +++ b/doc/resources/tslice.html @@ -13,6 +13,7 @@

    TSLICE

    +

    Syntax

    @@ -40,6 +41,7 @@

    Syntax

    +

    Description

    TSLICE sets the size of the thread listing "slice" (ie. a portion @@ -52,6 +54,7 @@

    Description

    +

    Default Setting

    @@ -59,12 +62,14 @@ 
    Default Setting
    +

    Resource Variables

    N/A

    +

    Examples

    The default setting causes a thread slice to start with the @@ -82,12 +87,14 @@

    Examples

    +

    Version

    2.2.0

    +

    See Also

    @@ -98,13 +105,13 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tslicebeg.html b/doc/resources/tslicebeg.html index de2fdde..2014190 100644 --- a/doc/resources/tslicebeg.html +++ b/doc/resources/tslicebeg.html @@ -13,6 +13,7 @@

    TSLICEBEG

    +

    Syntax

    @@ -38,6 +39,7 @@

    Syntax

    +

    Description

    TSLICEBEG defines the starting markup of a thread listing @@ -59,6 +61,7 @@

    Description

    +

    Default Setting

    @@ -68,10 +71,10 @@ 
    Default Setting
    +

    Resource Variables

    - @@ -92,8 +95,8 @@

    Resource Variables

    - - + + @@ -104,6 +107,14 @@

    Resource Variables

    + + + + + + + + @@ -140,10 +151,6 @@

    Resource Variables

    - - - - @@ -180,6 +187,14 @@

    Resource Variables

    + + + + + + + + @@ -204,6 +219,10 @@

    Resource Variables

    + + + + @@ -235,22 +254,24 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    +

    Examples

    None.

    +

    Version

    2.2.0

    +

    See Also

    @@ -266,13 +287,13 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tsliceend.html b/doc/resources/tsliceend.html index 8e0727f..0871e7a 100644 --- a/doc/resources/tsliceend.html +++ b/doc/resources/tsliceend.html @@ -13,6 +13,7 @@

    TSLICEEND

    +

    Syntax

    @@ -38,6 +39,7 @@

    Syntax

    +

    Description

    TSLICEEND defines the end markup of a thread listing @@ -59,6 +61,7 @@

    Description

    +

    Default Setting

    @@ -68,10 +71,10 @@ 
    Default Setting
    +

    Resource Variables

    - @@ -92,8 +95,8 @@

    Resource Variables

    - - + + @@ -104,6 +107,14 @@

    Resource Variables

    + + + + + + + + @@ -140,10 +151,6 @@

    Resource Variables

    - - - - @@ -180,6 +187,14 @@

    Resource Variables

    + + + + + + + + @@ -204,6 +219,10 @@

    Resource Variables

    + + + + @@ -235,22 +254,24 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $FROM$ The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LINK$ Link markup linking to a message.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    Program name
    $SUBJECT$The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ The subject text of the message without the anchor element.
    $YYYYMMDD$ Message date in yyyy/mm/dd format.
    +

    Examples

    None.

    +

    Version

    2.2.0

    +

    See Also

    @@ -266,13 +287,13 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tsort.html b/doc/resources/tsort.html index a0403e0..f6b95d0 100644 --- a/doc/resources/tsort.html +++ b/doc/resources/tsort.html @@ -83,13 +83,13 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:10
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tsubjectbeg.html b/doc/resources/tsubjectbeg.html index fcb0911..dbb63c8 100644 --- a/doc/resources/tsubjectbeg.html +++ b/doc/resources/tsubjectbeg.html @@ -105,10 +105,10 @@

    See Also

    -98/10/10 15:33:10
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tsubjectend.html b/doc/resources/tsubjectend.html index 5d51f1c..352af67 100644 --- a/doc/resources/tsubjectend.html +++ b/doc/resources/tsubjectend.html @@ -52,7 +52,7 @@

    Description

    Default Setting

    Nil. - +

    @@ -88,10 +88,10 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tsublistbeg.html b/doc/resources/tsublistbeg.html index ae75ace..f4ceb2a 100644 --- a/doc/resources/tsublistbeg.html +++ b/doc/resources/tsublistbeg.html @@ -61,7 +61,6 @@

    Default Setting

    Resource Variables

    - @@ -70,8 +69,8 @@

    Resource Variables

    - - + + @@ -98,10 +97,6 @@

    Resource Variables

    - - - - @@ -145,7 +140,6 @@

    Resource Variables

    -
    VariableValue
    URL to documentation.
    $FIRSTPG$Filename of first page of main index.$ENV$Value of an environment variable.
    $GMTDATE$ The title of the main index page.
    $LASTPG$Filename of last page in of main index.
    $LOCALDATE$ Current local date.
    $VERSION$ Program version.
    @@ -177,10 +171,10 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tsublistend.html b/doc/resources/tsublistend.html index 411483b..a089244 100644 --- a/doc/resources/tsublistend.html +++ b/doc/resources/tsublistend.html @@ -91,10 +91,10 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/tsubsort.html b/doc/resources/tsubsort.html index 40bf566..5d6018d 100644 --- a/doc/resources/tsubsort.html +++ b/doc/resources/tsubsort.html @@ -13,6 +13,7 @@

    TSUBSORT

    +

    Syntax

    @@ -40,6 +41,7 @@

    Syntax

    +

    Description

    TSUBSORT, when on, instructs MHonArc to sort threads by @@ -47,30 +49,35 @@

    Description

    +

    Default Setting

    Off

    +

    Resource Variables

    N/A

    +

    Examples

    None.

    +

    Version

    2.1.0

    +

    See Also

    @@ -82,13 +89,13 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/ttitle.html b/doc/resources/ttitle.html index 0d91639..500648f 100644 --- a/doc/resources/ttitle.html +++ b/doc/resources/ttitle.html @@ -98,10 +98,10 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/ttopbegin.html b/doc/resources/ttopbegin.html index a312f8e..15ab4e0 100644 --- a/doc/resources/ttopbegin.html +++ b/doc/resources/ttopbegin.html @@ -63,7 +63,6 @@

    Default Setting

    Resource Variables

    - @@ -88,6 +87,10 @@

    Resource Variables

    + + + + @@ -96,6 +99,14 @@

    Resource Variables

    + + + + + + + + @@ -132,6 +143,14 @@

    Resource Variables

    + + + + + + + + @@ -141,7 +160,7 @@

    Resource Variables

    - + @@ -151,7 +170,6 @@

    Resource Variables

    -
    VariableValue
    Message date in dd/mm/yyyy format.
    $ENV$Value of an environment variable.
    $FROM$ The complete text in the From: field of the message.
    The e-mail address in the From: field of the message.
    $FROMADDRDOMAIN$The e-mail address domain of the From: field of the message.
    $FROMADDRNAME$The e-mail address "username" (or local-part) of the From: field of the message.
    $FROMNAME$ The human name of the person in the From: field of the message. If no human name is found, the username specified in the e-mail address is used.
    Filename prefix for message files.
    $MSGTORDNUM$The ordinal message number of the current discussion thread.
    $NOTE$Message annotation.
    $NUMFOLUP$ Number of explicit follow-ups to the message.
    $SUBJECT$The subject text of the message wrapped in an anchor element that hyperlinks to the message.The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
    $SUBJECTNA$ $YYYYMMDD$ Message date in yyyy/mm/dd format.
    @@ -247,10 +265,10 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/ttopend.html b/doc/resources/ttopend.html index 3fbc027..398d98b 100644 --- a/doc/resources/ttopend.html +++ b/doc/resources/ttopend.html @@ -90,10 +90,10 @@

    See Also

    -98/09/19 18:27:19
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/umask.html b/doc/resources/umask.html index b892f13..24cbae5 100644 --- a/doc/resources/umask.html +++ b/doc/resources/umask.html @@ -94,10 +94,10 @@

    See Also

    -98/09/19 18:27:20
    +00/10/28 11:13:11
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/uselocaltime.html b/doc/resources/uselocaltime.html index 315f179..1b26ff5 100644 --- a/doc/resources/uselocaltime.html +++ b/doc/resources/uselocaltime.html @@ -6,7 +6,7 @@
    -MHonArc Resource List
    +MHonArc Resource List
    @@ -98,13 +98,13 @@

    See Also

    -98/10/10 15:26:50
    +00/10/28 11:13:12
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/usinglastpg.html b/doc/resources/usinglastpg.html index 23c79e0..cbb7f21 100644 --- a/doc/resources/usinglastpg.html +++ b/doc/resources/usinglastpg.html @@ -92,13 +92,13 @@

    See Also

    -98/09/19 18:27:20
    +00/10/28 11:13:13
    -MHonArc
    -Copyright © 1998, Earl Hood, earlhood@usa.net
    +Copyright © 1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/varregex.html b/doc/resources/varregex.html new file mode 100644 index 0000000..ba73ec0 --- /dev/null +++ b/doc/resources/varregex.html @@ -0,0 +1,111 @@ + + + +MHonArc Resources: VARREGEX + + + +
    +MHonArc Resource List
    +
    + +
    +

    VARREGEX

    + + +
    +

    Syntax

    + +
    + +
    Envariable
    +

    +M2H_VARREGEX=Perl-regex +

    +
    + +
    Element
    +


    +<VARREGEX>
    +Perl-regex
    +</VARREGEX>
    +

    +
    + +
    Command-line Option
    +


    +-varregex Perl-regex +

    +
    + +
    + + +
    +

    Description

    + +

    VARREGEX defines the Perl regular expression matching +resource variables. The regex should +define a back reference that contains the name of the resource +variable and its arguments surround by parentheses. +

    +

    Do not mess with this resource unless you know what you are +doing. +

    + + +
    +

    Default Setting

    + +
    +\$([^\$]*)\$
+
    + + +
    +

    Resource Variables

    + +

    N/A +

    + + +
    +

    Examples

    + +

    The following does a more stricter match: +

    +
    +\$([^(\$]+(?:\([^)]+\))?)\$
+
    +

    Although slower than the default, it minimizes potential conflicts +in resource files encoded in multi-byte character sets like SJIS. +

    + + +
    +

    Version

    + +

    2.4.5 +

    + + +
    +

    See Also

    + +

    +

    + + +
    +
    +00/10/28 11:13:13
    + +MHonArc
    +Copyright © 2000, Earl Hood, mhonarc@pobox.com
    +
    + + + diff --git a/doc/resources/weekdays.html b/doc/resources/weekdays.html index b96ec8d..7eca089 100644 --- a/doc/resources/weekdays.html +++ b/doc/resources/weekdays.html @@ -103,10 +103,10 @@

    See Also

    -98/09/19 18:27:20
    +00/10/28 11:13:13
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/doc/resources/weekdaysabr.html b/doc/resources/weekdaysabr.html index 7b23fc9..109ee93 100644 --- a/doc/resources/weekdaysabr.html +++ b/doc/resources/weekdaysabr.html @@ -104,10 +104,10 @@

    See Also

    -98/09/19 18:27:20
    +00/10/28 11:13:13
    -MHonArc
    -Copyright © 1997-1998, Earl Hood, earlhood@usa.net
    +MHonArc
    +Copyright © 1997-1998, Earl Hood, mhonarc@pobox.com
    diff --git a/examples/date.mrc b/examples/date.mrc index 2c99655..c505ebe 100644 --- a/examples/date.mrc +++ b/examples/date.mrc @@ -1,6 +1,6 @@ - - - - -

    $SUBJECTNA$

    @@ -499,10 +496,7 @@ xref -
    diff --git a/examples/icons.mrc b/examples/icons.mrc index cfc19e4..66323d1 100644 --- a/examples/icons.mrc +++ b/examples/icons.mrc @@ -1,6 +1,6 @@ - \n", "\n", - "\n", + "\n", "\n", "\n", "\n"; @@ -969,8 +1029,41 @@ sub output_mail { ## Output message data if ($adding) { - $tmp2 = ''; + $tmp2 = ""; while (<$msginfh>) { + # check if subject header delimited + if (/\n"; + if (!$nocustom) { + ($template = $SUBJECTHEADER) =~ + s/$VarExp/&replace_li_var($1,$index)/geo; + print $msghandle $template; + } + print $msghandle "\n"; + next; + } + # check if head/body separator delimited + if (/\n"; + if (!$nocustom) { + ($template = $HEADBODYSEP) =~ + s/$VarExp/&replace_li_var($1,$index)/geo; + print $msghandle $template; + } + print $msghandle "\n"; + next; + } + $tmp2 .= $_; last if /\n"; ## Output title diff --git a/lib/mhinit.pl b/lib/mhinit.pl index 6d08273..1c59a3b 100644 --- a/lib/mhinit.pl +++ b/lib/mhinit.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhinit.pl 2.9 98/10/10 21:31:25 +## @(#) mhinit.pl 2.23 01/06/10 17:35:46 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Initialization stuff for MHonArc. ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1995-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1995-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -33,23 +33,100 @@ sub mhinit_vars { ## The %Zone array should be augmented to contain all timezone ## specifications with the positive/negative hour offset from UTC -## (GMT). (There has got to be a better way to handle timezones) +## (GMT). The zone value is *added* to the time containing the +## zone to determine GMT time. Hence, the values will be the +## negative inverse used in actual time specifications in messages. +## (There has got to be a better way to handle timezones) ## Array can be augmented/overridden via the resource file. - %Zone = ( - "UTC", 0, # Universal Coordinated Time - "GMT", 0, # Greenwich Mean Time - "AST", 4, # Atlantic Standard Time - "ADT", 3, # Atlantic Daylight Time - "EST", 5, # Eastern Standard Time - "EDT", 4, # Eastern Daylight Time - "CST", 6, # Central Standard Time - "CDT", 5, # Central Daylight Time - "MST", 7, # Mountain Standard Time - "MDT", 6, # Mountain Daylight Time - "PST", 8, # Pacific Standard Time - "PDT", 7, # Pacific Daylight Time + 'ACDT', '-1030', # Australian Central Daylight + 'ACST', '-0930', # Australian Central Standard + 'ADT', '0300', # (US) Atlantic Daylight + 'AEDT', '-1100', # Australian East Daylight + 'AEST', '-1000', # Australian East Standard + 'AHDT', '0900', + 'AHST', '1000', + 'AST', '0400', # (US) Atlantic Standard + 'AT', '0200', # Azores + 'AWDT', '-0900', # Australian West Daylight + 'AWST', '-0800', # Australian West Standard + 'BAT', '-0300', # Baghdad + 'BDST', '-0200', # British Double Summer + 'BET', '1100', # Bering Standard + 'BST', '-0100', # British Summer +# 'BST', '0300', # Brazil Standard + 'BT', '-0300', # Baghdad + 'BZT2', '0300', # Brazil Zone 2 + 'CADT', '-1030', # Central Australian Daylight + 'CAST', '-0930', # Central Australian Standard + 'CAT', '1000', # Central Alaska + 'CCT', '-0800', # China Coast + 'CDT', '0500', # (US) Central Daylight + 'CED', '-0200', # Central European Daylight + 'CET', '-0100', # Central European + 'CST', '0600', # (US) Central Standard + 'EAST', '-1000', # Eastern Australian Standard + 'EDT', '0400', # (US) Eastern Daylight + 'EED', '-0300', # Eastern European Daylight + 'EET', '-0200', # Eastern Europe + 'EEST', '-0300', # Eastern Europe Summer + 'EST', '0500', # (US) Eastern Standard + 'FST', '-0200', # French Summer + 'FWT', '-0100', # French Winter + 'GMT', '0000', # Greenwich Mean + 'GST', '-1000', # Guam Standard +# 'GST', '0300', # Greenland Standard + 'HDT', '0900', # Hawaii Daylight + 'HST', '1000', # Hawaii Standard + 'IDLE', '-1200', # Internation Date Line East + 'IDLW', '1200', # Internation Date Line West + 'IST', '-0530', # Indian Standard + 'IT', '-0330', # Iran + 'JST', '-0900', # Japan Standard + 'JT', '-0700', # Java + 'KST', '-0900', # Korean Standard + 'MDT', '0600', # (US) Mountain Daylight + 'MED', '-0200', # Middle European Daylight + 'MET', '-0100', # Middle European + 'MEST', '-0200', # Middle European Summer + 'MEWT', '-0100', # Middle European Winter + 'MST', '0700', # (US) Mountain Standard + 'MT', '-0800', # Moluccas + 'NDT', '0230', # Newfoundland Daylight + 'NFT', '0330', # Newfoundland + 'NT', '1100', # Nome + 'NST', '-0630', # North Sumatra +# 'NST', '0330', # Newfoundland Standard + 'NZ', '-1100', # New Zealand + 'NZST', '-1200', # New Zealand Standard + 'NZDT', '-1300', # New Zealand Daylight + 'NZT', '-1200', # New Zealand + 'PDT', '0700', # (US) Pacific Daylight + 'PST', '0800', # (US) Pacific Standard + 'ROK', '-0900', # Republic of Korea + 'SAD', '-1000', # South Australia Daylight + 'SAST', '-0900', # South Australia Standard + 'SAT', '-0900', # South Australia + 'SDT', '-1000', # South Australia Daylight + 'SST', '-0200', # Swedish Summer + 'SWT', '-0100', # Swedish Winter + 'USZ3', '-0400', # USSR Zone 3 + 'USZ4', '-0500', # USSR Zone 4 + 'USZ5', '-0600', # USSR Zone 5 + 'USZ6', '-0700', # USSR Zone 6 + 'UT', '0000', # Universal Coordinated + 'UTC', '0000', # Universal Coordinated + 'UZ10', '-1100', # USSR Zone 10 + 'WAT', '0100', # West Africa + 'WET', '0000', # West European + 'WST', '-0800', # West Australian Standard + 'YDT', '0800', # Yukon Daylight + 'YST', '0900', # Yukon Standard + 'ZP4', '-0400', # USSR Zone 3 + 'ZP5', '-0500', # USSR Zone 4 + 'ZP6', '-0600', # USSR Zone 5 ); +%ZoneUD = (); ## Assoc array listing mail header fields to exclude in output. ## Each key is treated as a regular expression with '^' prepended @@ -162,8 +239,11 @@ sub mhinit_vars { %readmail::MIMEFilters = ( # Content-type Filter #------------------------------------------------------------------- + "application/ms-tnef", "m2h_null::filter", + "application/octet-stream", "m2h_external::filter", "application/x-patch", "m2h_text_plain::filter", "message/delivery-status", "m2h_text_plain::filter", + "message/external-body", "m2h_msg_extbody::filter", "message/partial", "m2h_text_plain::filter", "text/enriched", "m2h_text_enriched::filter", "text/html", "m2h_text_html::filter", @@ -187,7 +267,11 @@ sub mhinit_vars { %readmail::MIMEFiltersSrc = ( # Content-type Filter #------------------------------------------------------------------- + "application/ms-tnef", "mhnull.pl", + "application/octet-stream", "mhexternal.pl", "application/x-patch", "mhtxtplain.pl", + "message/delivery-status", "mhtxtplain.pl", + "message/external-body", "mhmsgextbody.pl", "message/partial", "mhtxtplain.pl", "text/enriched", "mhtxtenrich.pl", "text/html", "mhtxthtml.pl", @@ -237,6 +321,13 @@ sub mhinit_vars { "iso-8859-8", "iso_8859::str2sgml", "iso-8859-9", "iso_8859::str2sgml", "iso-8859-10", "iso_8859::str2sgml", + "iso-2022-jp", "iso_2022_jp::str2html", + "latin1", "mhonarc::htmlize", + "latin2", "iso_8859::str2sgml", + "latin3", "iso_8859::str2sgml", + "latin4", "iso_8859::str2sgml", + "latin5", "iso_8859::str2sgml", + "latin6", "iso_8859::str2sgml", "default", "-ignore-", ); %readmail::MIMECharSetConvertersSrc = ( @@ -254,6 +345,13 @@ sub mhinit_vars { "iso-8859-8", "iso8859.pl", "iso-8859-9", "iso8859.pl", "iso-8859-10", "iso8859.pl", + "iso-2022-jp", "iso2022jp.pl", + "latin1", undef, + "latin2", "iso8859.pl", + "latin3", "iso8859.pl", + "latin4", "iso8859.pl", + "latin5", "iso8859.pl", + "latin6", "iso8859.pl", "default", undef, ); @@ -265,10 +363,10 @@ sub mhinit_vars { $MHeadCnvFunc = "mhonarc::htmlize"; ## Regexp for variable detection -$VarExp = '\$([^\$]*)\$'; +$VarExp = $ENV{'M2H_VARREGEX'} || '\$([^\$]*)\$'; -## Regexp for address/msg-id detection -$AddrExp = q%[^()<>@,;:\/\s"'&|]+@[^()<>@,;:\/\s"'&|]+%; +## Regexp for address/msg-id detection (looks like cussing in cartoons) +$AddrExp = '[^()<>@,;:\/\s"\'&|]+@[^()<>@,;:\/\s"\'&|]+'; ## Grab environment variable settings ## @@ -292,7 +390,8 @@ sub mhinit_vars { $MAILTOURL = $ENV{'M2H_MAILTOURL'} || ""; $FROM = $ENV{'M2H_MSGSEP'} || '^From '; $LOCKFILE = $ENV{'M2H_LOCKFILE'} || - (($MSDOS || $VMS) ? "mhonarc.lck": ".mhonarc.lck"); + ($MSDOS ? "mhonarc.lck" : + $VMS ? "mhonarc_lck" : ".mhonarc.lck"); $LOCKTRIES = $ENV{'M2H_LOCKTRIES'} || 10; $LOCKDELAY = $ENV{'M2H_LOCKDELAY'} || 3; $MAXSIZE = $ENV{'M2H_MAXSIZE'} || 0; @@ -304,6 +403,7 @@ sub mhinit_vars { $DefRcName = $ENV{'M2H_DEFRCNAME'} || (($MSDOS || $VMS) ? "mhonarc.rc": ".mhonarc.rc"); $GzipExe = $ENV{'M2H_GZIPEXE'} || 'gzip'; +$SpamMode = $ENV{'M2H_SPAMMODE'} || 0; $GMTDateFmt = $ENV{'M2H_GMTDATEFMT'} || ''; $LocalDateFmt = $ENV{'M2H_LOCALDATEFMT'} || ''; @@ -316,27 +416,37 @@ sub mhinit_vars { $NoteDir = $ENV{'M2H_NOTEDIR'} || 'notes'; -$CONLEN = defined($ENV{'M2H_CONLEN'}) ? $ENV{'M2H_CONLEN'} : 0; -$MAIN = defined($ENV{'M2H_MAIN'}) ? $ENV{'M2H_MAIN'} : 1; -$MULTIIDX = defined($ENV{'M2H_MULTIPG'}) ? $ENV{'M2H_MULTIPG'} : 0; -$MODTIME = defined($ENV{'M2H_MODTIME'}) ? $ENV{'M2H_MODTIME'} : 0; -$NODOC = defined($ENV{'M2H_DOC'}) ? !$ENV{'M2H_DOC'} : 0; -$NOMAILTO = defined($ENV{'M2H_MAILTO'}) ? !$ENV{'M2H_MAILTO'} : 0; -$NoMsgPgs = defined($ENV{'M2H_MSGPGS'}) ? !$ENV{'M2H_MSGPGS'} : 0; -$NONEWS = defined($ENV{'M2H_NEWS'}) ? !$ENV{'M2H_NEWS'} : 0; -$NOSORT = defined($ENV{'M2H_SORT'}) ? !$ENV{'M2H_SORT'} : 0; -$NOURL = defined($ENV{'M2H_URL'}) ? !$ENV{'M2H_SORT'} : 0; -$REVSORT = defined($ENV{'M2H_REVSORT'}) ? $ENV{'M2H_REVSORT'} : 0; -$SUBSORT = defined($ENV{'M2H_SUBSORT'}) ? $ENV{'M2H_SUBSORT'} : 0; -$AUTHSORT = defined($ENV{'M2H_AUTHSORT'}) ? $ENV{'M2H_AUTHSORT'} : 0; -$THREAD = defined($ENV{'M2H_THREAD'}) ? $ENV{'M2H_THREAD'} : 1; -$TNOSORT = defined($ENV{'M2H_TSORT'}) ? !$ENV{'M2H_TSORT'} : 0; -$TREVERSE = defined($ENV{'M2H_TREVERSE'}) ? $ENV{'M2H_TREVERSE'} : 0; -$TSUBSORT = defined($ENV{'M2H_TSUBSORT'}) ? $ENV{'M2H_TSUBSORT'} : 0; -$GzipFiles = defined($ENV{'M2H_GZIPFILES'}) ? $ENV{'M2H_GZIPFILES'} : 0; -$GzipLinks = defined($ENV{'M2H_GZIPLINKS'}) ? $ENV{'M2H_GZIPLINKS'} : 0; +$LockMethod = $ENV{'M2H_LOCKMETHOD'} || 'directory'; +$LockMethod = set_lock_mode($LockMethod); + +$CONLEN = defined($ENV{'M2H_CONLEN'}) ? $ENV{'M2H_CONLEN'} : 0; +$MAIN = defined($ENV{'M2H_MAIN'}) ? $ENV{'M2H_MAIN'} : 1; +$MULTIIDX = defined($ENV{'M2H_MULTIPG'}) ? $ENV{'M2H_MULTIPG'} : 0; +$MODTIME = defined($ENV{'M2H_MODTIME'}) ? $ENV{'M2H_MODTIME'} : 0; +$NODOC = defined($ENV{'M2H_DOC'}) ? !$ENV{'M2H_DOC'} : 0; +$NOMAILTO = defined($ENV{'M2H_MAILTO'}) ? !$ENV{'M2H_MAILTO'} : 0; +$NoMsgPgs = defined($ENV{'M2H_MSGPGS'}) ? !$ENV{'M2H_MSGPGS'} : 0; +$NONEWS = defined($ENV{'M2H_NEWS'}) ? !$ENV{'M2H_NEWS'} : 0; +$NOSORT = defined($ENV{'M2H_SORT'}) ? !$ENV{'M2H_SORT'} : 0; +$NOURL = defined($ENV{'M2H_URL'}) ? !$ENV{'M2H_URL'} : 0; +$REVSORT = defined($ENV{'M2H_REVSORT'}) ? $ENV{'M2H_REVSORT'} : 0; +$SUBSORT = defined($ENV{'M2H_SUBSORT'}) ? $ENV{'M2H_SUBSORT'} : 0; +$AUTHSORT = defined($ENV{'M2H_AUTHSORT'}) ? $ENV{'M2H_AUTHSORT'} : 0; +$THREAD = defined($ENV{'M2H_THREAD'}) ? $ENV{'M2H_THREAD'} : 1; +$TNOSORT = defined($ENV{'M2H_TSORT'}) ? !$ENV{'M2H_TSORT'} : 0; +$TREVERSE = defined($ENV{'M2H_TREVERSE'}) ? $ENV{'M2H_TREVERSE'} : 0; +$TSUBSORT = defined($ENV{'M2H_TSUBSORT'}) ? $ENV{'M2H_TSUBSORT'} : 0; +$GzipFiles = defined($ENV{'M2H_GZIPFILES'}) ? $ENV{'M2H_GZIPFILES'} : 0; +$GzipLinks = defined($ENV{'M2H_GZIPLINKS'}) ? $ENV{'M2H_GZIPLINKS'} : 0; +$KeepOnRmm = defined($ENV{'M2H_KEEPONRMM'}) ? $ENV{'M2H_KEEPONRMM'} : 0; $UseLocalTime= defined($ENV{'M2H_USELOCALTIME'}) ? $ENV{'M2H_USELOCALTIME'} : 0; +$NoSubjectThreads = defined($ENV{'M2H_SUBJECTTHREADS'}) ? + !$ENV{'M2H_SUBJECTTHREADS'} : 0; +$SaveRsrcs = defined($ENV{'M2H_SAVERESOURCES'}) ? + $ENV{'M2H_SAVERESOURCES'} : 1; +$POSIXstrftime = defined($ENV{'M2H_POSIXSTRFTIME'}) ? + $ENV{'M2H_POSIXSTRFTIME'} : 0; if ($UNIX) { eval { @@ -345,6 +455,8 @@ sub mhinit_vars { }; } +$CheckNoArchive = defined($ENV{'M2H_CHECKNOARCHIVE'}) ? + $ENV{'M2H_CHECKNOARCHIVE'} : 0; $DecodeHeads = defined($ENV{'M2H_DECODEHEADS'}) ? $ENV{'M2H_DECODEHEADS'} : 0; $DoArchive = defined($ENV{'M2H_ARCHIVE'}) ? $ENV{'M2H_ARCHIVE'} : 1; $DoFolRefs = defined($ENV{'M2H_FOLREFS'}) ? $ENV{'M2H_FOLREFS'} : 1; @@ -362,6 +474,9 @@ sub mhinit_vars { ($TSliceNBefore, $TSliceNAfter) = defined($ENV{'M2H_TSLICE'}) ? split(/:/, $ENV{'M2H_TSLICE'}) : (0, 0); +## Code for modify addresses in headers +$AddressModify = $ENV{'M2H_ADDRESSMODIFYCODE'} || ""; + ## Regex representing "article" words for stripping out when doing ## subject sorting. $SubArtRxp = $ENV{'M2H_SUBJECTARTICLERXP'} || @@ -374,6 +489,8 @@ sub mhinit_vars { ## Code for stripping subjects $SubStripCode = $ENV{'M2H_SUBJECTSTRIPCODE'} || ""; +$MsgExcFilter = $ENV{'M2H_MSGEXCFILTER'} || ""; + ## Arrays for months and weekdays. If empty, the default settings ## in mhtime.pl are used. @@ -391,6 +508,8 @@ sub mhinit_vars { $RMM = 0; # Flag if removing messages $SCAN = 0; # Flag if doing an archive scan +$SSMARKUP = ''; # Initial markup of all pages + $IDXLABEL = ''; # Label for main index $LIBEG = ''; # List open template for main index $LIEND = ''; # List close template for main index diff --git a/lib/mhlock.pl b/lib/mhlock.pl new file mode 100644 index 0000000..0e2f567 --- /dev/null +++ b/lib/mhlock.pl @@ -0,0 +1,193 @@ +##---------------------------------------------------------------------------## +## File: +## @(#) mhlock.pl 1.2 99/07/13 00:48:29 +## Author: +## Earl Hood mhonarc@pobox.com +## Description: +## Lock functions for MHonArc. +##---------------------------------------------------------------------------## +## MHonArc -- Internet mail-to-HTML converter +## Copyright (C) 1997-1999 Earl Hood, mhonarc@pobox.com +## +## This program is free software; you can redistribute it and/or modify +## it under the terms of the GNU General Public License as published by +## the Free Software Foundation; either version 2 of the License, or +## (at your option) any later version. +## +## This program is distributed in the hope that it will be useful, +## but WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +## GNU General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with this program; if not, write to the Free Software +## Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA +## 02111-1307, USA +##---------------------------------------------------------------------------## + +package mhonarc; + +############################################################################# +## Constants +############################################################################# + +sub MHA_LOCK_MODE_DIR () { 0; } + ## -- Directory method: Works on all platforms, but lock dir can be + ## left around if abnormal termination. +sub MHA_LOCK_MODE_FLOCK () { 1; } + ## -- flock() method: Works on select platforms. Can have problems + ## if writing to an NFS mount depending on how perl is built. + ## If available, and not writing to NFS (or reliable over NFS) + ## this method is better than directory method. + + +############################################################################# +## Variables +############################################################################# + +my $_lock_file = undef; +my $_flock_fh = undef; + +$LockFunc = undef; +$UnlockFunc = undef; + +############################################################################# +## Functions +############################################################################# + +##--------------------------------------------------------------------------- +## set_lock_mode(): Set locking method used by MHonArc. +## +sub set_lock_mode { + my $mode = shift; + if ($mode =~ /\D/) { + STR2NUM: { + if ($mode =~ /^\s*flock/) { + $mode = &MHA_LOCK_MODE_FLOCK; + last STR2NUM; + } + $mode = &MHA_LOCK_MODE_DIR; + last STR2NUM; + } + } + if ($mode == &MHA_LOCK_MODE_FLOCK) { + $LockFunc = \&flock_file; + $UnlockFunc = \&unflock_file; + return ; + } + $mode = &MHA_LOCK_MODE_DIR; + $LockFunc = \&create_lock_dir; + $UnlockFunc = \&remove_lock_dir; + + $mode; +} + +############################################################################# +## Directory Method of Locking Functions +############################################################################# + +##--------------------------------------------------------------------------- +## create_lock_dir() creates a directory to act as a lock. +## +sub create_lock_dir { + my($file, $tries, $sleep, $force) = @_; + my $prtry = 0; + my $ret = 0; + $_lock_file = $file; + while ($tries > 0) { + if (mkdir($file, 0777)) { $ISLOCK = 1; $ret = 1; last; } + sleep($sleep) if $sleep > 0; + $tries--; + if (!$prtry && ($tries > 0)) { + print STDOUT qq/Trying to create lock ...\n/ unless $QUIET; + $prtry = 1; + } + } + if ($force) { $ISLOCK = 1; $ret = 1; } + $ret; +} + +##--------------------------------------------------------------------------- +## remove_lock_dir removes the lock directory +## +sub remove_lock_dir { + if ($ISLOCK) { + if (!rmdir($_lock_file)) { + warn "Warning: Unable to remove $LOCKFILE: $!\n"; + return 0; + } + $ISLOCK = 0; + } + 1; +} + +############################################################################# +## Flock Functions +############################################################################# + +##--------------------------------------------------------------------------- +## flock_file(): Create archive lock using flock(2). +## +sub flock_file { + my($file, $tries, $sleep, $force) = @_; + + eval { + require Symbol; + require Fcntl; + Fcntl->import(':DEFAULT', ':flock'); + }; + if ($@) { + warn qq/Warning: Unable to require modules for flock() lock method: /, + qq/$@\n/, + qq/\tFalling back to directory method.\n/; + set_lock_mode(MHA_LOCK_MODE_DIR); + return &$LockFunc(@_); + } + + $_lock_file = $file; + $_flock_fh = Symbol::gensym; + + if (!sysopen($_flock_fh, $file, (&O_WRONLY|&O_CREAT), 0666)) { + warn(qq/ERROR: Unable to create "$file": $!\n/); + return 0; + } + + my $prtry = 0; + my $ret = 0; + while ($tries > 0) { + if (flock($_flock_fh, &LOCK_EX|&LOCK_NB)) { + $ISLOCK = 1; $ret = 1; last; + } + sleep($sleep) if $sleep > 0; + $tries--; + if (!$prtry && ($tries > 0)) { + print STDOUT qq/Trying to create lock ...\n/ unless $QUIET; + $prtry = 1; + } + } + if (!$ISLOCK && $force) { $_flock_fh = undef; $ISLOCK = 1; $ret = 1; } + + $ret; +} + +##--------------------------------------------------------------------------- + +sub unflock_file { + if (defined($_flock_fh)) { + flock($_flock_fh, &LOCK_UN); + close($_flock_fh); + $_flock_fh = undef; + } + $ISLOCK = 0; +} + + +##--------------------------------------------------------------------------- + +############################################################################# + +BEGIN { + set_lock_mode(MHA_LOCK_MODE_DIR); +} + +1; diff --git a/lib/mhmimetypes.pl b/lib/mhmimetypes.pl index 00468af..3fffeb4 100644 --- a/lib/mhmimetypes.pl +++ b/lib/mhmimetypes.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhmimetypes.pl 1.1 98/10/24 17:19:30 +## @(#) mhmimetypes.pl 1.6 01/06/10 17:37:44 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## MIME type mappings. ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1998,1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -43,6 +43,9 @@ package mhonarc; 'application/mathematica', 'ma:Mathematica Notebook document', 'application/mbedlet', 'mbd:mbedlet file', 'application/msword', 'doc:MS-Word document', + 'application/ms-excel', 'xls:MS-Excel spreadsheet', + 'application/ms-powerpoint', 'ppt:MS-Powerpoint presentation', + 'application/ms-project', 'mpp:MS-Project file', 'application/octet-stream', 'bin:Binary data', 'application/oda', 'oda:ODA file', 'application/pdf', 'pdf:Adobe PDF document', @@ -53,21 +56,27 @@ package mhonarc; 'application/sgml', 'sgml:SGML document', 'application/studiom', 'smp:Studio M file', 'application/timbuktu', 'tbt:timbuktu file', + 'application/vis5d', 'v5d:Vis5D dataset', 'application/vnd.framemaker', 'fm:FrameMaker document', 'application/vnd.hp-hpgl', 'hpg,hpgl:HPGL file', + 'application/vnd.lotus-1-2-3', '123,wk4,wk3,wk1:Lotus 1-2-3', + 'application/vnd.lotus-approach', 'apr,vew:Lotus Approach', + 'application/vnd.lotus-freelance', 'prz,pre:Lotus Freelance', + 'application/vnd.lotus-organizer', 'org,or3,or2:Lotus Organizer', + 'application/vnd.lotus-screencam', 'scm:Lotus Screencam', + 'application/vnd.lotus-wordpro', 'lwp,sam:Lotus WordPro', 'application/vnd.mif', 'mif:Frame MIF document', 'application/vnd.ms-excel', 'xls:MS-Excel spreadsheet', 'application/vnd.ms-powerpoint', 'ppt:MS-Powerpoint presentation', 'application/vnd.ms-project', 'mpp:MS-Project file', - 'application/vis5d', 'v5d:Vis5D dataset', 'application/winhlp', 'hlp:WinHelp document', 'application/wordperfect5.1', 'wp:WordPerfect 5.1 document', - 'application/x-net-install', 'ins:Net Install file', 'application/x-asap', 'asp:asap file', 'application/x-bcpio', 'bcpio:BCPIO file', + 'application/x-bzip2', 'bz2:BZip2 compressed data', + 'application/x-compress', 'Z:Unix compressed data', 'application/x-cpio', 'cpio:CPIO file', 'application/x-csh', 'csh:C-Shell script', - 'application/x-compress', 'Z:Unix compressed data', 'application/x-dot', 'dot:dot file', 'application/x-dvi', 'dvi:TeX dvi file', 'application/x-earthtime', 'etc:Earthtime file', @@ -92,6 +101,7 @@ package mhonarc; 'application/x-msschedule', 'scd:MS-Schedule file', 'application/x-msterminal', 'trm:MS-Terminal', 'application/x-mswrite', 'wri:MS-Write document', + 'application/x-net-install', 'ins:Net Install file', 'application/x-netcdf', 'cdf:Cdf file', 'application/x-ns-proxy-autoconfig','proxy:Netscape Proxy Auto Config', 'application/x-patch', 'patch:Source code patch', @@ -137,14 +147,17 @@ package mhonarc; 'chemical/chemdraw', 'chm:Chemdraw chemical test', 'chemical/cif', 'cif:CIF chemical test', 'chemical/cml', 'cml:CML chemical test', + 'chemical/cmsl', 'cml:Chemical Structure Markup', 'chemical/cxf', 'cxf:Chemical Exhange Format file', 'chemical/daylight-smiles', 'smi:SMILES format file', 'chemical/embl-dl-nucleotide', 'emb,embl:EMBL nucleotide format file', - 'chemical/gaussian-input', 'gau:Gaussian chemical test', + 'chemical/gaussian', 'gau:Gaussian data', + 'chemical/gaussian-input', 'gau:Gaussian input data', + 'chemical/gaussian-log', 'gal:Gaussian log', 'chemical/gcg8-sequence', 'gcg:GCG format file', 'chemical/genbank', 'gen:GENbank data', 'chemical/jcamp-dx', 'jdx:Jcamp chemical spectra test', - 'chemical/kinemage', 'kin:Kinemage chemical test', + 'chemical/kinemage', 'kin:Kinemage', 'chemical/macromodel-input', 'mmd,mmod:Macromodel chemical test', 'chemical/mopac-input', 'gau:Mopac chemical test', 'chemical/mdl-molfile', 'mol:MOL mdl chemical test', @@ -153,10 +166,12 @@ package mhonarc; 'chemical/mdl-sdf', 'sdf:SDF chemical test', 'chemical/mdl-tgf', 'tgf:TGF chemical test', 'chemical/mif', 'mif:MIF chemical test', + 'chemical/mmd', 'mmd:Macromodel data', 'chemical/mopac-input', 'mop:MOPAC data ', 'chemical/ncbi-asn1', 'asn:NCBI data', - 'chemical/pdb', 'pdb:PDB chemical test', + 'chemical/pdb', 'pdb:Protein Databank data', 'chemical/rosdal', 'ros:Rosdal data', + 'chemical/xyz', 'xyz:Xmol XYZ data', 'image/bmp', 'bmp:Windows bitmap', 'image/cgm', 'cgm:Computer Graphics Metafile', @@ -240,12 +255,14 @@ sub get_mime_ext { ## to a file. ## sub write_attachment { - my $ctype = lc shift; + my $content = lc shift; my $sref = shift; my $path = shift; my $fname = shift; my $inext = shift; - my($cnt, $pre, $ext, $pathname); + my($ctype, $cnt, $pre, $ext, $pathname); + + ($ctype) = $content =~ m%^\s*([\w-\./]+)%; # Extract content-type local(*OUTFILE); @@ -269,7 +286,7 @@ sub write_attachment { $pathname .= $DIRSEP . $fname; if (open(OUTFILE, "> $pathname")) { - binmode(OUTFILE); # For MS-DOS + binmode(OUTFILE); # For WinDog print OUTFILE $$sref; close(OUTFILE); } else { diff --git a/lib/mhmsgextbody.pl b/lib/mhmsgextbody.pl new file mode 100644 index 0000000..4f496a7 --- /dev/null +++ b/lib/mhmsgextbody.pl @@ -0,0 +1,151 @@ +##---------------------------------------------------------------------------## +## File: +## @(#) mhmsgextbody.pl 1.1 99/09/28 23:17:50 +## Author: +## Earl Hood mhonarc@pobox.com +## Description: +## Library defines routine to filter message/external-body parts to +## HTML for MHonArc. +## Filter routine can be registered with the following: +## +## message/external-body;m2h_msg_extbody::filter;mhmsgextbody.pl +## +##---------------------------------------------------------------------------## +## MHonArc -- Internet mail-to-HTML converter +## Copyright (C) 1999 Earl Hood, mhonarc@pobox.com +## +## This program is free software; you can redistribute it and/or modify +## it under the terms of the GNU General Public License as published by +## the Free Software Foundation; either version 2 of the License, or +## (at your option) any later version. +## +## This program is distributed in the hope that it will be useful, +## but WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +## GNU General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with this program; if not, write to the Free Software +## Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA +## 02111-1307, USA +##---------------------------------------------------------------------------## + +package m2h_msg_extbody; + +##---------------------------------------------------------------------------## +## message/external-body filter for MHonArc. +## The following filter arguments are recognized ($args): +## +## local-file Support local-file access-type. This option +## is best used for internal local mail archives +## where it is known that readers will have +## direct access to the file. +## +sub filter { + local($header, *fields, *data, $isdecode, $args) = @_; + + # grab content-type + my $ctype = (split(/$readmail::FieldSep/o, $fields{'content-type'}))[0]; + return '' unless $ctype =~ /\S/; + + # parse argument string + my $b_lfile = $args =~ /\blocal-file\b/i; + + my $ret = ""; + my $parms = readmail::MAILparse_parameter_str($ctype, 1); + my $access_type = lc $parms->{'access-type'}{'value'}; + $access_type =~ s/\s//g; + my $cdesc = $fields{'content-description'} || ""; + + local(%dfields, %dfl2o); + $data =~ s/\A\s+//; + my $dheader = readmail::MAILread_header(*data, *dfields, *dfl2o); + my $dctype = $dfields{'content-type'} || ""; + my $dcte = $dfields{'content-transfer-encoding'} || ""; + my $dmd5 = $dfields{'content-md5'} || ""; + my $size = $parms->{'size'}{'value'} || ""; + my $perms = $parms->{'permission'}{'value'} || ""; + my $expires = $parms->{'expiration'}{'value'} || ""; + my $name = $parms->{'name'}{'value'} || ""; + + ATYPE: { + ## FTP, TFTP, ANON-FTP + if ( $access_type eq 'ftp' || + $access_type eq 'anon-ftp' || + $access_type eq 'tftp' ) { + my $site = $parms->{'site'}{'value'}; + my $dir = $parms->{'directory'}{'value'} || ""; + $dir = '/'.$dir unless $dir =~ m|^/| || $dir eq ""; + my $mode = $parms->{'mode'}{'value'} || ""; + my $proto = $access_type eq 'tftp' ? 'tftp' : 'ftp'; + my $url = "$proto://" . + mhonarc::urlize($site) . + $dir . '/' . + mhonarc::urlize($name); + $ret = '
    '; + $ret .= qq|$cdesc
    \n| + if $cdesc; + $ret .= qq|<$url>
    \n|; + $ret .= qq|Content-type: $dctype
    \n| + if $dctype; + $ret .= qq|MD5: $dmd5
    \n| + if $dmd5; + $ret .= qq|Size: $size bytes
    \n| + if $size; + $ret .= qq|Transfer-mode: $mode
    \n| + if $mode; + $ret .= qq|Username/password may be required.
    \n| + if $access_type eq 'ftp'; + $ret .= "
    \n"; + last ATYPE; + } + + ## Local file + if ($access_type eq 'local-file') { + last ATYPE unless $b_lfile; + my $site = $parms->{'site'}{'value'} || ""; + my $url = mhonarc::urlize("file://$name"); + $ret = '
    '; + $ret .= qq|$cdesc
    \n| if $cdesc; + $ret .= qq|<$url>
    \n|; + $ret .= qq|Content-type: $dctype
    \n| + if $dctype; + $ret .= qq|MD5: $dmd5
    \n| + if $dmd5; + $ret .= qq|Size: $size bytes
    \n| if $size; + $ret .= qq|File accessible from the following domain: | . + qq|$site
    \n| if $site; + $ret .= "
    \n"; + last ATYPE; + } + + ## Mail server + if ($access_type eq 'mail-server') { + # not supported + last ATYPE; + } + + ## URL + if ($access_type eq 'url') { + my $url = $parms->{'url'}{'value'}; + $url =~ s/\s+//g; + $ret = '
    '; + $ret .= qq|$cdesc
    \n| if $cdesc; + $ret .= qq|<$url>
    \n|; + $ret .= qq|Content-type: $dctype
    \n| + if $dctype; + $ret .= qq|MD5: $dmd5
    \n| + if $dmd5; + $ret .= qq|Size: $size bytes
    \n| if $size; + $ret .= "
    \n"; + last ATYPE; + } + + last ATYPE; + } + + ($ret); +} + +##---------------------------------------------------------------------------## +1; diff --git a/lib/mhmsgfile.pl b/lib/mhmsgfile.pl index 66b7d31..483f47b 100644 --- a/lib/mhmsgfile.pl +++ b/lib/mhmsgfile.pl @@ -1,15 +1,15 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhmsgfile.pl 1.1 98/08/10 23:56:33 +## @(#) mhmsgfile.pl 1.4 99/08/04 23:14:15 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## MHonArc library for dealing with HTML message files. Mainly ## for parsing existing message files inorder to extract archive ## related data. ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1998-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -31,8 +31,9 @@ package mhonarc; ##---------------------------------------------------------------------------## ## Dependent libraries: -## ewhutil.pl, mhtime.pl ##---------------------------------------------------------------------------## +require 'ewhutil.pl'; +require 'mhtime.pl'; ##---------------------------------------------------------------------------## ## parse_data_from_msg(): Function to parse the initial comment @@ -94,8 +95,13 @@ sub load_data_from_msg_file { ## Assign data to hashes $Date{$index} = $date; $Subject{$index} = $href->{'subject'}[0]; - $From{$index} = defined($href->{'from'}) ? $href->{'from'}[0] : - 'No author'; + if (defined($href->{'from-r13'})) { + $From{$index} = &mrot13($href->{'from-r13'}[0]); + } elsif (defined($href->{'from'})) { + $From{$index} = $href->{'from'}[0]; + } else { + $From{$index} = 'Anonymous'; + } if (defined($href->{'message-id'})) { $Index2MsgId{$index} = $href->{'message-id'}[0]; $MsgId{$href->{'message-id'}[0]} = $index; diff --git a/lib/mhnote.pl b/lib/mhnote.pl index 1c9c42c..e1f5fbc 100644 --- a/lib/mhnote.pl +++ b/lib/mhnote.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhnote.pl 1.1 98/08/10 23:56:33 +## @(#) mhnote.pl 1.2 99/06/25 14:21:43 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Annotation routine for MHonArc. ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1995-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1995-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by diff --git a/lib/mhnull.pl b/lib/mhnull.pl index 4902e11..63cb570 100644 --- a/lib/mhnull.pl +++ b/lib/mhnull.pl @@ -1,8 +1,8 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhnull.pl 1.2 98/09/30 22:51:11 +## @(#) mhnull.pl 1.5 01/06/10 17:35:03 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Library defines the null filter routine for MHonArc. Its use ## is for dropping unwanted data from messages. @@ -12,7 +12,7 @@ ## ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1998,1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -33,7 +33,13 @@ package m2h_null; sub filter { - " "; # Return a bogus space to denote success for readmail.pl + local($header, *fields, *data, $isdecode, $args) = @_; + my($ctype) = $fields{'content-type'} =~ m%^\s*([\w\-\./]+)%; + my($disp, $nameparm) = &readmail::MAILhead_get_disposition(*fields); + join("", '

    <<', + ($disp ? "$disp: " : ""), + ($nameparm ? $nameparm : $ctype), + '>>

    '); } ##---------------------------------------------------------------------------## diff --git a/lib/mhopt.pl b/lib/mhopt.pl index c8b3581..0ee8cb2 100644 --- a/lib/mhopt.pl +++ b/lib/mhopt.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhopt.pl 2.8 98/11/08 11:55:42 +## @(#) mhopt.pl 2.20 01/04/10 21:36:41 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Routines to set options for MHonArc. ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1997-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1997-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -28,6 +28,7 @@ package mhonarc; use Getopt::Long; +use Time::Local; ##--------------------------------------------------------------------------- ## get_resources() is responsible for grabbing resource settings from @@ -42,10 +43,14 @@ sub get_resources { GetOptions(\%opt, "add", # Add a message to archive "afs", # Bypass file permission checks + "addressmodifycode=s", + # Perl expression for modifying displayed addresses "annotate", # Add a note to message(s) "authsort", # Sort by author "archive", # Create an archive (the default) "conlen", # Honor Content-Length fields + "checknoarchive", + # Check for "no archive" flag in messages "datefields=s", # Fields that contains the date of a message "dbfile=s", # Database/state filename for mhonarc archive "decodeheads", # Decode all 1522 encoded data in message headers @@ -70,10 +75,12 @@ sub get_resources { "idxfname=s", # Filename of index page "idxprefix=s", # Filename prefix for multi-page main index "idxsize=i", # Maximum number of messages shown in indexes + "keeponrmm", # Do not delete message files on archive remove "localdatefmt=s", # Date specification for local date "lock", # Do archive locking (default) "lockdelay=i", # Time delay in seconds between lock tries + "lockmethod=s", # Set the method of locking "locktries=i", # Number of tries in locking an archive "mailtourl=s", # URL to use for e-mail address hyperlinks "main", # Create a main index @@ -84,6 +91,8 @@ sub get_resources { "modtime", # Set modification time on files to message date "months=s", # Month names "monthsabr=s", # Abbreviated month names + "msgexcfilter=s", + # Perl expression(s) for selective message exclusion "msgpgs", # Create message pages "msgsep=s", # Message separator for mailbox files "msgprefix=s", # Filename prefix for message files @@ -91,6 +100,8 @@ sub get_resources { "news", # Add links to newsgroups "noauthsort", # Do not sort by author "noarchive", # Do not create an archive + "nochecknoarchive", + # Do not check for "no archive" flag in messages "noconlen", # Ignore Content-Length fields "nodecodeheads", # Do not decode 1522 encoded data in message headers @@ -98,6 +109,7 @@ sub get_resources { "nofolrefs", # Do not print links to explicit follow-ups/references "nogzipfiles", # Do not Gzip files "nogziplinks", # Do not add ".gz" extensions to files + "nokeeponrmm", # Delete message files on archive remove "nolock", # Do no archive locking "nomailto", # Do not add in mailto links for e-mail addresses "nomain", # Do not create a main index @@ -105,33 +117,55 @@ sub get_resources { "nomodtime", # Do no set modification time on files to message date "nomultipg", # Do not generate multi-page indexes "nonews", # Do not add links to newsgroups + "noposixstrftime", + # Use own implementation for time format process "noreverse", # List messages in normal order + "nosaveresources", + # Do not save resource values in db "nosort", # Do not sort + "nospammode", # Do not run in (anti)spam mode "nosubsort", # Do not sort by subject + "nosubjectthreads", + # Do not do subject based threading "notedir", # Location of notes "notetext=s@", # Text data of note "nothread", # Do not create threaded index "notreverse", # List oldest thread first + "notsubsort|tnosubsort", + # Do not list threads by subject + "notsort|tnosort", + # List threads by ordered processed "nourl", # Do not make URL hyperlinks "otherindex|otherindexes=s@", # List of other rcfiles for extra indexes "outdir=s", # Destination of HTML files "pagenum=s", # Page to output if -genidx "perlinc=s@", # List of paths to search for MIME filters + "posixstrftime", + # Use POSIX strftime() "quiet", # No status messages while running "rcfile=s@", # Resource file for mhonarc + "varregex=s", # Regex matching resource variables "reverse", # List messages in reverse order "rmm", # Remove messages from an archive "savemem", # Write message data while processing + "saveresources", + # Save resource values in db "scan", # List out archive contents to terminal "single", # Convert a single message to HTML "sort", # Sort messages in increasing date order + "spammode", # Run in (anti)spam mode + "stderr=s", # Set file for stderr + "stdin=s", # Set file for stdin + "stdout=s", # Set file for stdout "subjectarticlerxp=s", # Regex for leading articles in subjects "subjectreplyrxp=s", # Regex for leading reply string in subjects "subjectstripcode=s", # Perl expression for modifying subjects + "subjectthreads", + # Check subjects for threads "subsort", # Sort message by subject "tidxfname=s", # File name of threaded index page "tidxprefix=s", # Filename prefix for multi-page thread index @@ -143,9 +177,7 @@ sub get_resources { "treverse", # Reverse order of thread listing "tslice=s", # Set size of thread slice listing "tsort", # List threads by date - "tnosort", # List threads by ordered processed "tsubsort", # List threads by subject - "tnosubsort", # Do not list threads by subject "umask=i", # Set umask of process "url", # Make URL hyperlinks "weekdays=s", # Weekday names @@ -164,9 +196,40 @@ sub get_resources { if ($opt{'help'}) { &usage(); return 0; } if ($opt{'v'}) { &version(); return 0; } + ## Check std{in,out,err} options + DUP: { + $MhaStdin = \*STDIN; + STDOUTERR: { + if (defined($opt{'stdout'}) && !ref($opt{'stdout'})) { + open(STDOUT, ">>$opt{'stdout'}") || + die qq/ERROR: Unable to create "$opt{'stdout'}": $!\n/; + if ($opt{'stderr'} eq $opt{'stdout'}) { + open(STDERR, ">&STDOUT") || + die qq/ERROR: Unable to dup STDOUT: $!\n/; + last STDOUTERR; + } + } + if (defined($opt{'stderr'}) && !ref($opt{'stderr'})) { + open(STDERR, ">>$opt{'stderr'}") || + die qq/ERROR: Unable to create "$opt{'stderr'}": $!\n/; + } + } + if (defined($opt{'stdin'})) { + if (ref($opt{'stdin'})) { + $MhaStdin = $opt{'stdin'}; + } else { + open(STDIN, "<$opt{'stdin'}") || + die qq/ERROR: Unable to open "$opt{'stdin'}": $!\n/; + $MhaStdin = \*STDIN; + } + } + my $curfh = select(STDOUT); $| = 1; + select(STDERR); $| = 1; + select($curfh); + } + ## Initialize variables - require 'mhinit.pl' || die("ERROR: Unable to require mhinit.pl\n"); - &mhinit_vars(); + require 'mhinit.pl'; &mhinit_vars(); ## These options have NO resource file equivalent. $NoArg = $opt{'noarg'}; @@ -178,6 +241,7 @@ sub get_resources { $QUIET = $opt{'quiet'}; $EDITIDX = $opt{'editidx'}; $ANNOTATE= $opt{'annotate'}; + $AFS = $opt{'afs'}; if ($opt{'genidx'}) { $IDXONLY = 1; $QUIET = 1; $ADD = 0; } else { @@ -193,7 +257,7 @@ sub get_resources { $DoArchive = 1 if $opt{'archive'}; $DoArchive = 0 if $opt{'noarchive'}; - my $dolock = !$opt{'nolock'}; + my $dolock = !$NoArg && !$opt{'nolock'}; ## Check argv unless (($#ARGV >= 0) || $ADD || $SINGLE || $EDITIDX || $SCAN || @@ -203,25 +267,33 @@ sub get_resources { } ## Require needed libraries - require 'timelocal.pl' || die("ERROR: Unable to require timelocal.pl\n"); - require 'ewhutil.pl' || die("ERROR: Unable to require ewhutil.pl\n"); - require 'mhtime.pl' || die("ERROR: Unable to require mhtime.pl\n"); - require 'mhfile.pl' || die("ERROR: Unable to require mhfile.pl\n"); - require 'mhutil.pl' || die("ERROR: Unable to require mhutil.pl\n"); - require 'mhscan.pl' || die("ERROR: Unable to require mhscan.pl\n") - if $SCAN; - require 'mhsingle.pl' || die("ERROR: Unable to require mhsingle.pl\n") - if $SINGLE; - require 'mhrmm.pl' || die("ERROR: Unable to require mhrmm.pl\n") - if $RMM; - require 'mhnote.pl' || die("ERROR: Unable to require mhnote.pl\n") - if $ANNOTATE; - + require 'ewhutil.pl'; + require 'mhtime.pl'; + require 'mhfile.pl'; + require 'mhutil.pl'; + require 'mhscan.pl' if $SCAN; + require 'mhsingle.pl' if $SINGLE; + require 'mhrmm.pl' if $RMM; + require 'mhnote.pl' if $ANNOTATE; + + ## Evaluate site local initialization + delete($INC{'mhasiteinit.pl'}); # force re-evaluation + eval { require 'mhasiteinit.pl'; }; # ignore status + + ## Read default resource file if ($DefRcFile) { &read_fmt_file($DefRcFile); } else { $tmp = join($DIRSEP, $ENV{'HOME'}, $DefRcName); - $tmp = join($DIRSEP, $INC[0], $DefRcName) unless (-e $tmp); + if (! -e $tmp) { + local $_; + foreach (@INC) { + if (-e join($DIRSEP, $_, 'mhamain.pl')) { + $tmp = join($DIRSEP, $_, $DefRcName); + last; + } + } + } if (-e $tmp) { &read_fmt_file($tmp); } @@ -235,10 +307,13 @@ sub get_resources { ($opt{'lockdelay'} > 0); $FORCELOCK = $opt{'force'}; + $LockMethod = &set_lock_mode($opt{'lockmethod'}) + if defined($opt{'lockmethod'}); + ## These options must be grabbed before reading the database file ## since these options may tells us where the database file is. $OUTDIR = $opt{'outdir'} if $opt{'outdir'}; - if (!$NoArg && !($SCAN || $IDXONLY)) { + if (!$NoArg && !($SCAN || $IDXONLY || $SINGLE)) { die qq/ERROR: "$OUTDIR" does not exist\n/ unless -e $OUTDIR; if (!$AFS) { die qq/ERROR: "$OUTDIR" is not readable\n/ unless -r $OUTDIR; @@ -248,20 +323,12 @@ sub get_resources { } $DBFILE = $opt{'dbfile'} if $opt{'dbfile'}; - ## Create lockfile - &set_handler(); + ## Create lock $LOCKFILE = join($DIRSEP, $OUTDIR, $LOCKFILE); - if ($dolock && $DoArchive && !$SINGLE && - !&create_lock_file($LOCKFILE, 1, 0, 0)) { - - print STDOUT qq/Trying to lock mail archive in "$OUTDIR" ...\n/ - unless $QUIET; - if (!&create_lock_file($LOCKFILE, - $LOCKTRIES-1, - $LOCKDELAY, - $FORCELOCK)) { + if ($dolock && $DoArchive && !$SINGLE) { + if (!&$LockFunc($LOCKFILE, $LOCKTRIES, $LOCKDELAY, $FORCELOCK)) { $! = 75; # EX_TEMPFAIL (for sendmail) - die("ERROR: Unable to create $LOCKFILE after $LOCKTRIES tries\n"); + die("ERROR: Unable to lock $OUTDIR after $LOCKTRIES tries\n"); } } @@ -300,16 +367,19 @@ sub get_resources { if (!$IDXONLY) { if ($#ARGV < 0) { $ADDSINGLE = 1; } # See if adding single mesg else { $ADDSINGLE = 0; } - $ADD = 'STDIN'; + $ADD = $MhaStdin; } } my($OldMULTIIDX) = $MULTIIDX; - ## Remove lock file if db not going to be changed + ## Remove lock if db not going to be changed if ($SCAN || $IDXONLY) { - &remove_lock_file(); + &$UnlockFunc(); } + ## Clear thread flag if genidx, must be explicitly set + $THREAD = 0 if $IDXONLY; + ## Read resource file(s) (I initially used the term 'format file'). ## Look for resource in outdir unless existing according to ## current value. @@ -377,6 +447,7 @@ sub get_resources { $TTITLE = $opt{'ttitle'} if $opt{'ttitle'}; $MsgPrefix = $opt{'msgprefix'} if defined($opt{'msgprefix'}); $GzipExe = $opt{'gzipexe'} if $opt{'gzipexe'}; + $VarExp = $opt{'varregex'} if $opt{'varregex'}; $IDXNAME = $opt{'idxfname'} || $IDXNAME || $ENV{'M2H_IDXFNAME'} || "maillist.$HtmlExt"; @@ -390,9 +461,11 @@ sub get_resources { $GMTDateFmt = $opt{'gmtdatefmt'} if $opt{'gmtdatefmt'}; $LocalDateFmt = $opt{'localdatefmt'} if $opt{'localdatefmt'}; - $SubArtRxp = $opt{'subjectarticlerxp'} if $opt{'subjectarticlerxp'}; - $SubReplyRxp = $opt{'subjectreplyrxp'} if $opt{'subjectreplyrxp'}; - $SubStripCode = $opt{'subjectstripcode'} if $opt{'subjectstripcode'}; + $AddressModify = $opt{'addressmodifycode'} if $opt{'addressmodifycode'}; + $SubArtRxp = $opt{'subjectarticlerxp'} if $opt{'subjectarticlerxp'}; + $SubReplyRxp = $opt{'subjectreplyrxp'} if $opt{'subjectreplyrxp'}; + $SubStripCode = $opt{'subjectstripcode'} if $opt{'subjectstripcode'}; + $MsgExcFilter = $opt{'msgexcfilter'} if defined($opt{'msgexcfilter'}); $IdxPageNum = $opt{'pagenum'} if defined($opt{'pagenum'}); @@ -443,11 +516,25 @@ sub get_resources { $GzipLinks = 0 if $opt{'nogziplinks'}; $NoMsgPgs = 0 if $opt{'msgpgs'}; $NoMsgPgs = 1 if $opt{'nomsgpgs'}; + $SaveRsrcs = 1 if $opt{'saveresources'}; + $SaveRsrcs = 0 if $opt{'nosaveresources'}; + $SpamMode = 1 if $opt{'spammode'}; + $SpamMode = 0 if $opt{'nospammode'}; + $KeepOnRmm = 1 if $opt{'keeponrmm'}; + $KeepOnRmm = 0 if $opt{'nokeeponrmm'}; + + $CheckNoArchive = 1 if $opt{'checknoarchive'}; + $CheckNoArchive = 0 if $opt{'nochecknoarchive'}; + $POSIXstrftime = 1 if $opt{'posixstrftime'}; + $POSIXstrftime = 0 if $opt{'noposixstrftime'}; $DecodeHeads = 1 if $opt{'decodeheads'}; $DecodeHeads = 0 if $opt{'nodecodeheads'}; $readmail::DecodeHeader = $DecodeHeads; + ## Clear main flag if genidx and thread specified + $MAIN = 0 if $IDXONLY && $THREAD; + @DateFields = split(/:/, $opt{'datefields'}) if $opt{'datefields'}; foreach (@DateFields) { s/\s//g; tr/A-Z/a-z/; } @FromFields = split(/:/, $opt{'fromfields'}) if $opt{'fromfields'}; @@ -486,14 +573,16 @@ sub get_resources { ## Check for thread listing order $TSUBSORT = 1 if $opt{'tsubsort'}; - $TSUBSORT = 0 if $opt{'tnosubsort'}; - $TNOSORT = 1 if $opt{'tnosort'}; + $TSUBSORT = 0 if $opt{'notsubsort'}; + $TNOSORT = 1 if $opt{'notsort'}; $TNOSORT = 0 if $opt{'tsort'}; $TREVERSE = 1 if $opt{'treverse'}; $TREVERSE = 0 if $opt{'notreverse'}; if ($TNOSORT) { $TSUBSORT = 0; } + $NoSubjectThreads = 1 if $opt{'nosubjectthreads'}; + $NoSubjectThreads = 0 if $opt{'subjectthreads'}; ## Check if all messages must be updated (this has been simplified; ## any serious change should be done via editidx). @@ -504,20 +593,20 @@ sub get_resources { } ## Set date names - &set_date_names(*weekdays, *Weekdays, *months, *Months); + &set_date_names(\@weekdays, \@Weekdays, \@months, \@Months); - ## Require some more libaries - require 'mhidxrc.pl' || die("ERROR: Unable to require mhidxrc.pl\n"); - &mhidxrc_set_vars(); - - require 'mhdysub.pl' || die("ERROR: Unable to require mhdysub.pl\n"); - &create_routines(); + ## Set %Zone with user-specified timezones + while (($zone, $offset) = each(%ZoneUD)) { + $Zone{$zone} = $offset; + } - require 'mhrcvars.pl' || die("ERROR: Unable to require mhrcvars.pl\n"); - require 'mhindex.pl' || die("ERROR: Unable to require mhindex.pl\n"); - require 'mhthread.pl' || die("ERROR: Unable to require mhthread.pl\n"); - require 'mhdb.pl' || die("ERROR: Unable to require mhdb.pl\n") - unless $SCAN || $IDXONLY || !$DoArchive; + ## Require some more libaries + require 'mhidxrc.pl'; &mhidxrc_set_vars(); + require 'mhdysub.pl'; &create_routines(); + require 'mhrcvars.pl'; + require 'mhindex.pl'; + require 'mhthread.pl'; + require 'mhdb.pl' unless $SCAN || $IDXONLY || !$DoArchive; ## Predefine %Index2TLoc in case of message deletion if (@TListOrder) { @@ -574,61 +663,16 @@ sub version { ## Usage routine ## sub usage { - require 'mhusage.pl' || - die("ERROR: Unable to require mhusage.pl.\n", - "Did you install MHonArc properly?\n"); + require 'mhusage.pl'; &mhusage(); } -##--------------------------------------------------------------------------- -## create_lock_file() creates a directory to act as a lock. -## -sub create_lock_file { - my($file, $tries, $sleep, $force) = @_; - my($umask, $ret); - $ret = 0; - while ($tries > 0) { - if (mkdir($file, 0777)) { - $ISLOCK = 1; - $ret = 1; - last; - } - sleep($sleep) if $sleep > 0; - $tries--; - } - if ($force) { - $ISLOCK = 1; $ret = 1; - } - $ret; -} - -##--------------------------------------------------------------------------- -## remove_lock_file removes the lock on the archive -## -sub remove_lock_file { - if ($ISLOCK) { - if (-d $LOCKFILE) { - if (!rmdir($LOCKFILE)) { - warn "Warning: Unable to remove $LOCKFILE: $!\n"; - return 0; - } - } else { - if (!unlink($LOCKFILE)) { - warn "Warning: Unable to remove $LOCKFILE\n"; - return 0; - } - } - $ISLOCK = 0; - } - 1; -} - ##--------------------------------------------------------------------------- ## read_fmt_file() requires the library with the resource file ## read subroutine and calls the routine. ## sub read_fmt_file { - require 'mhrcfile.pl' || die("ERROR: Unable to require mhrcfile.pl\n"); + require 'mhrcfile.pl'; &read_resource_file($_[0]); } diff --git a/lib/mhrcfile.pl b/lib/mhrcfile.pl index ee35ddd..c2f2b1a 100644 --- a/lib/mhrcfile.pl +++ b/lib/mhrcfile.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhrcfile.pl 2.6 98/10/10 16:29:34 +## @(#) mhrcfile.pl 2.15 01/06/10 17:39:12 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Routines for parsing resource files ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1996-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1996-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -57,6 +57,10 @@ sub read_resource_file { $chop = ($attr =~ /chop/i); FMTSW: { + if ($elem eq "addressmodifycode") { # Code to strip subjects + $AddressModify = &get_elem_content($handle, $elem, $chop); + last FMTSW; + } if ($elem eq "authorbegin") { # Begin for author group $AUTHBEG = &get_elem_content($handle, $elem, $chop); last FMTSW; @@ -95,6 +99,9 @@ sub read_resource_file { } last FMTSW; } + if ($elem eq "checknoarchive") { + $CheckNoArchive = 1; last FMTSW; + } if ($elem eq "conlen") { $CONLEN = 1; last FMTSW; } @@ -323,6 +330,10 @@ sub read_resource_file { } last FMTSW; } + if ($elem eq "keeponrmm") { # Keep files on rmm + $KeepOnRmm = 1; + last FMTSW; + } if ($elem eq "labelbeg") { # Begin markup of label $LABELBEG = &get_elem_content($handle, $elem, $chop); last FMTSW; @@ -359,6 +370,12 @@ sub read_resource_file { } last FMTSW; } + if ($elem eq "lockmethod") { # Locking method + if ($line = &get_elem_last_line($handle, $elem)) { + $LockMethod = &set_lock_mode($line); + } + last FMTSW; + } if ($elem eq "mailto") { # Convert e-mail addrs $NOMAILTO = 0; last FMTSW; } @@ -384,6 +401,10 @@ sub read_resource_file { $MSGBODYEND = &get_elem_content($handle, $elem, $chop); last FMTSW; } + if ($elem eq "msgexcfilter") { # Code selectively exclude msgs + $MsgExcFilter = &get_elem_content($handle, $elem, $chop); + last FMTSW; + } if ($elem eq "msgpgs") { # Output message pages $NoMsgPgs = 0; last FMTSW; } @@ -400,6 +421,26 @@ sub read_resource_file { } last FMTSW; } + if ($elem eq "mimedecoders") { # Mime decoders + if ($override) { + %readmail::MIMEDecoders = (); + %readmail::MIMEDecodersSrc = (); + } + while (defined($line = <$handle>)) { + last if $line =~ /^\s*<\/mimedecoders\s*>/i; + next unless $line =~ /\S/; + $line =~ s/\s//g; + if ($line =~ /;/) { # using Perl 5 qualification + ($type,$routine,$plfile) = split(/;/,$line,3); + } else { + ($type,$routine,$plfile) = split(/:/,$line,3); + } + $type =~ tr/A-Z/a-z/; + $readmail::MIMEDecoders{$type} = $routine; + $readmail::MIMEDecodersSrc{$type} = $plfile if $plfile =~ /\S/; + } + last FMTSW; + } if ($elem eq "mimefilters") { # Mime filters if ($override) { %readmail::MIMEFilters = (); @@ -436,6 +477,15 @@ sub read_resource_file { } last FMTSW; } + if ($elem eq 'mimeexcs') { # Mime exclusions + %readmail::MIMEExcs = () if $override; + while (defined($line = <$handle>)) { + last if $line =~ /^\s*<\/mimeexcs\s*>/i; + $line =~ s/\s//g; $line =~ tr/A-Z/a-z/; + $readmail::MIMEExcs{$line} = 1 if $line; + } + last FMTSW; + } if ($elem eq "months") { # Full month names @a = &get_list_content($handle, $elem); if (scalar(@a)) { @@ -525,6 +575,9 @@ sub read_resource_file { $AUTHSORT = 0; last FMTSW; } + if ($elem eq "nochecknoarchive") { + $CheckNoArchive = 0; last FMTSW; + } if ($elem eq "noconlen") { # Ignore content-length $CONLEN = 0; last FMTSW; } @@ -543,6 +596,10 @@ sub read_resource_file { if ($elem eq "nogziplinks") { # Don't add ".gz" to links $GzipLinks = 0; last FMTSW; } + if ($elem eq "nokeeponrmm") { # Remove files on rmm + $KeepOnRmm = 0; + last FMTSW; + } if ($elem eq "nomailto") { # Do not convert e-mail addrs $NOMAILTO = 1; last FMTSW; } @@ -561,13 +618,28 @@ sub read_resource_file { if ($elem eq "nonews") { # Ignore news for linking $NONEWS = 1; last FMTSW; } + if ($elem eq "noposixstrftime") { # Do not use POSIX::strftime() + $POSIXstrftime = 0; + last FMTSW; + } if ($elem eq "noreverse") { # Sort in normal order $REVSORT = 0; last FMTSW; } + if ($elem eq "nosaveresources") { # Do not save resources + $SaveRsrcs = 0; + last FMTSW; + } if ($elem eq "nosort") { # Do not sort messages $NOSORT = 1; last FMTSW; } + if ($elem eq "nospammode") { # Do not do anti-spam stuff + $SpamMode = 0; last FMTSW; + } + if ($elem eq "nosubjectthreads") { # No check subjects for threads + $NoSubjectThreads = 1; + last FMTSW; + } if ($elem eq "nosubsort") { # Do not sort msgs by subject $SUBSORT = 0; last FMTSW; @@ -600,6 +672,16 @@ sub read_resource_file { if ($elem eq "notreverse") { # Thread sort in normal order $TREVERSE = 0; last FMTSW; } + if ($elem eq 'notsubsort' || + $elem eq "tnosubsort") { # No subject order for threads + $TSUBSORT = 0; + last FMTSW; + } + if ($elem eq 'notsort' || + $elem eq "tnosort") { # Raw order for threads + $TNOSORT = 1; $TSUBSORT = 0; + last FMTSW; + } if ($elem eq "nourl") { # Ignore URLs $NOURL = 1; last FMTSW; } @@ -619,6 +701,10 @@ sub read_resource_file { unshift(@PerlINC, &get_pathname_content($handle, $elem)); last FMTSW; } + if ($elem eq "posixstrftime") { # Use POSIX::strftime() + $POSIXstrftime = 1; + last FMTSW; + } if ($elem eq "prevbutton") { # Prev button link in message $PREVBUTTON = &get_elem_content($handle, $elem, $chop); last FMTSW; @@ -659,11 +745,22 @@ sub read_resource_file { $REVSORT = 1; last FMTSW; } + if ($elem eq "saveresources") { # Save resources in db + $SaveRsrcs = 1; + last FMTSW; + } if ($elem eq "sort") { # Sort messages by date $NOSORT = 0; $AUTHSORT = 0; $SUBSORT = 0; last FMTSW; } + if ($elem eq "spammode") { # Obfsucate/hide addresses + $SpamMode = 1; last FMTSW; + } + if ($elem eq "ssmarkup") { # Initial page markup + $SSMARKUP = &get_elem_content($handle, $elem, $chop); + last FMTSW; + } if ($elem eq "subjectarticlerxp") { # Regex for language articles if ($line = &get_elem_last_line($handle, $elem)) { $SubArtRxp = $line; @@ -680,6 +777,10 @@ sub read_resource_file { $SubStripCode = &get_elem_content($handle, $elem, $chop); last FMTSW; } + if ($elem eq "subjectthreads") { # Check subjects for threads + $NoSubjectThreads = 0; + last FMTSW; + } if ($elem eq "subsort") { # Sort messages by subject $SUBSORT = 1; $AUTHSORT = 0; $NOSORT = 0; @@ -740,13 +841,13 @@ sub read_resource_file { last FMTSW; } if ($elem eq "timezones") { # Time zones - %Zone = () if $override; + if ($override) { %ZoneUD = (); } while (defined($line = <$handle>)) { last if $line =~ /^\s*<\/timezones\s*>/i; $line =~ s/\s//g; $line =~ tr/a-z/A-Z/; ($acro,$hr) = split(/:/,$line); $acro =~ tr/a-z/A-Z/; - $Zone{$acro} = $hr; + $ZoneUD{$acro} = $hr; } last FMTSW; } @@ -788,14 +889,6 @@ sub read_resource_file { $TOPLINKS = &get_elem_content($handle, $elem, $chop); last FMTSW; } - if ($elem eq "tnosubsort") { # No subject order for threads - $TSUBSORT = 0; - last FMTSW; - } - if ($elem eq "tnosort") { # Raw order for threads - $TNOSORT = 1; $TSUBSORT = 0; - last FMTSW; - } if ($elem eq "tslice") { ($TSliceNBefore, $TSliceNAfter) = &get_list_content($handle, $elem); @@ -916,6 +1009,10 @@ sub read_resource_file { if ($elem eq "usinglastpg") { $UsingLASTPG = 1; last FMTSW; } + if ($elem eq "varregex") { # Regex matching rc vars + $VarExp = &get_elem_last_line($handle, $elem); + last FMTSW; + } if ($elem eq "weekdays") { # Full weekday name @a = &get_list_content($handle, $elem); if (scalar(@a)) { @@ -988,7 +1085,7 @@ sub get_list_content { last if /^\s*<\/$gi\s*>/i; next unless /\S/; s/\r?\n?$//; - push(@items, split(/[:;]/, $_)); + push(@items, split(/[:]/, $_)); } @items; } diff --git a/lib/mhrcvars.pl b/lib/mhrcvars.pl index 97e3239..593fd19 100644 --- a/lib/mhrcvars.pl +++ b/lib/mhrcvars.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhrcvars.pl 2.5 98/11/02 22:32:45 +## @(#) mhrcvars.pl 2.13 01/04/10 21:36:41 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Defines routine for expanding resource variables. ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1996-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1996-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -151,13 +151,28 @@ sub replace_li_var { $tmp = defined($key) ? &$esub($From{$key}) : "(nil)"; last REPLACESW; } + if ( ($cnd1 = ($var eq 'FROMADDRNAME')) || + ($cnd2 = ($var eq 'FROMADDRDOMAIN')) ) { + ($lref, $key, $pos) = compute_msg_pos($index, $var, $arg); + if (!defined($key)) { + $tmp = ""; + last REPLACESW; + } + my @a = split(/@/, extract_email_address($From{$key}), 2); + if ($cnd1) { + $tmp = $a[0]; + last REPLACESW; + } + $tmp = defined($a[1]) ? $a[1] : ""; + last REPLACESW; + } if ($var eq 'ICON') { ## Message icon ($lref, $key, $pos) = compute_msg_pos($index, $var, $arg); if (!defined($key)) { $tmp = ""; last REPLACESW; } $tmp = $Icons{$ContentType{$key}} ? - join(qq||) : - qq|[unknown]|; + join("", qq||) : + qq|[unknown]|; last REPLACESW; } if ($var eq 'ICONURL') { ## URL to message icon @@ -197,6 +212,19 @@ sub replace_li_var { $tmp = defined($key) ? &fmt_msgnum($IndexNum{$key}) : ""; last REPLACESW; } + if ($var eq 'MSGTORDNUM') { ## Message ordinal num in cur thread + # Some form of optimization should be done here since + # computation can degrade to n^2 (where n is size of thread) + # if variable is referenced for each message on thread index + # page. + ($lref, $key, $pos) = compute_msg_pos($index, $var, $arg, 1); + $tmp = 1; + my $level = $ThreadLevel{$key}; + for (--$pos ; ($level > 0) && ($pos >= 0); --$pos, ++$tmp ) { + $level = $ThreadLevel{$TListOrder[$pos]}; + } + last REPLACESW; + } if ($var eq 'NOTE') { ## Annotation template markup $expand = 1; ($lref, $key, $pos) = compute_msg_pos($index, $var, $arg); @@ -290,8 +318,8 @@ sub replace_li_var { $isurl = 0; ($lref, $key, $pos) = compute_msg_pos($index, $var, $arg); if (!defined($key)) { $tmp = ""; last REPLACESW; } - $tmp = qq/NAME="/ . &fmt_msgnum($IndexNum{$key}) . - qq/" HREF="/ . + $tmp = qq/name="/ . &fmt_msgnum($IndexNum{$key}) . + qq/" href="/ . &msgnum_filename($IndexNum{$key}) . qq/"/; last REPLACESW; @@ -300,14 +328,14 @@ sub replace_li_var { $isurl = 0; ($lref, $key, $pos) = compute_msg_pos($index, $var, $arg); if (!defined($key)) { $tmp = ""; last REPLACESW; } - $tmp = qq/NAME="/ . &fmt_msgnum($IndexNum{$key}) . qq/"/; + $tmp = qq/name="/ . &fmt_msgnum($IndexNum{$key}) . qq/"/; last REPLACESW; } if ($var eq 'A_HREF') { ## Anchor href to link to message $isurl = 0; ($lref, $key, $pos) = compute_msg_pos($index, $var, $arg); if (!defined($key)) { $tmp = ""; last REPLACESW; } - $tmp = qq/HREF="/ . &msgnum_filename($IndexNum{$key}) . qq/"/; + $tmp = qq/href="/ . &msgnum_filename($IndexNum{$key}) . qq/"/; last REPLACESW; } if ($var eq 'IDXFNAME') { ## Filename of index page @@ -333,7 +361,7 @@ sub replace_li_var { $tmp = $TITLE; last REPLACESW; } - if ($var eq 'NUMOFIDXMSG') { ## Number of item on the index page + if ($var eq 'NUMOFIDXMSG') { ## Number of items on the index page $tmp = $PageSize; last REPLACESW; } @@ -400,6 +428,34 @@ sub replace_li_var { } last REPLACESW; } + if ($var eq 'PGLINKLIST') { + my $num = $PageNum; + my $t = $arg =~ s/T//gi; + my($before, $after) = split(/;/, $arg); + my $prefix = $t ? $TIDXPREFIX : $IDXPREFIX; + my $suffix = $HtmlExt; + $suffix .= '.gz' if $GzipLinks; + $before = $num - abs($before); + $after = $num + abs($after); + $tmp = ""; + for ($i=$before; $i < $num; ++$i) { + next if $i < 1; + if ($i < 2) { + $tmp .= sprintf('%d | ', + ($t ? $TIDXNAME : $IDXNAME), + ($GzipLinks ? '.gz' : ""), $i); + next; + } + $tmp .= sprintf('%d | ', + $prefix, $i, $suffix, $i); + } + $tmp .= $num; + for ($i=$num+1; $i <= $after && $i <= $NumOfPages; ++$i) { + $tmp .= sprintf(' | %d', + $prefix, $i, $suffix, $i); + } + last REPLACESW; + } if ($var eq 'PAGENUM') { $tmp = $PageNum; @@ -439,10 +495,18 @@ sub replace_li_var { $tmp = $DOCURL; last REPLACESW; } + if ($var eq 'ENV') { + $tmp = htmlize($ENV{$arg}); + last REPLACESW; + } if ($var eq 'GMTDATE') { $tmp = &time2str($arg || $GMTDateFmt, time, 0); last REPLACESW; } + if ($var eq 'HTMLEXT') { + $tmp = $HtmlExt; + last REPLACESW; + } if ($var eq 'IDXPREFIX') { $tmp = $IDXPREFIX; last REPLACESW; @@ -491,7 +555,7 @@ sub replace_li_var { ## Check if string needs to be expanded again if ($expand) { - $tmp =~ s/\$([^\$]*)\$/&replace_li_var($1,$index)/ge; + $tmp =~ s/$VarExp/&replace_li_var($1,$index)/geo; } ## Check if URL text specifier is set @@ -506,24 +570,24 @@ sub replace_li_var { } # Check for clipping - if ($len > 0 && $canclip) { - # Check for entity refs and modify clip length accordingly - foreach ($ret =~ /(\&[^;\s]*;)/g) { - $len += length($_) -1; - } - $ret = substr($ret, 0, $len); - } + $ret = join("", ($ret =~ /(\&[^;\s]*;|.)/g)[0 .. $len - 1]) + if ($len > 0 && $canclip); # Check if JavaScript string - $ret =~ s/(["'])/\\$1/g if $jstr; + if ($jstr) { + $ret =~ s/\\/\\\\/g; # escape backslashes + $ret =~ s/(["'])/\\$1/g; # escape quotes + $ret =~ s/\n/\\n/g; # escape newlines + $ret =~ s/\r/\\r/g; # escape returns + } } ## Check for subject link - $ret = qq|$ret| + qq|">$ret| if $var eq 'SUBJECT' && $arg eq ""; $ret; @@ -533,13 +597,13 @@ sub replace_li_var { ## compute_msg_pos(): Get message location data. ## sub compute_msg_pos { - my($idx, $var, $arg) = @_; + my($idx, $var, $arg, $usethread) = @_; my($ofs, $pos, $aref, $href, $key); my $opt = undef; my $flip = 0; ## Determine what list type - if ($arg =~ s/^T//) { + if (($arg =~ s/^T//) || $usethread) { $aref = \@TListOrder; $href = \%Index2TLoc; } else { @@ -558,19 +622,43 @@ sub compute_msg_pos { if $arg eq 'PREV'; $ofs = ($flip ? -1 : 1), last SW if $arg eq 'NEXT'; - $ofs = ($flip ? $aref->[$#$aref] : $aref->[0]), last SW - if $arg eq 'FIRST'; - $ofs = ($flip ? $aref->[$#$aref] : $aref->[0]), last SW - if $arg eq 'LAST'; $ofs = ($flip ? -$arg : $arg), last SW if $arg =~ /^-?\d+$/; + + if ($arg eq 'FIRST') { + $pos = $flip ? $#$aref : 0; + undef $ofs; + last SW; + } + if ($arg eq 'LAST') { + $pos = $flip ? 0 : $#$aref; + undef $ofs; + last SW; + } if ($arg eq 'PARENT') { + undef $ofs; my $level = $ThreadLevel{$idx}; $pos = $Index2TLoc{$idx}; - for ( ; $pos >= 0; --$pos) { + last SW if ($level <= 0); + for (--$pos; $pos >= 0; --$pos) { last if $ThreadLevel{$TListOrder[$pos]} < $level; } + last SW; + } + if ($arg eq 'TOP') { undef $ofs; + $pos = $Index2TLoc{$idx}; + for (; $pos >= 0; --$pos) { + last if $ThreadLevel{$TListOrder[$pos]} <= 0; + } + last SW; + } + if ($arg eq 'END') { + undef $ofs; + $pos = $Index2TLoc{$idx}; + for (; $pos < $#TListOrder; ++$pos) { + last if $ThreadLevel{$TListOrder[$pos+1]} <= 0; + } last SW; } warn qq/Warning: $var: Unrecognized variable argument: "$arg"\n/; diff --git a/lib/mhrmm.pl b/lib/mhrmm.pl index 90726c6..bb4ce31 100644 --- a/lib/mhrmm.pl +++ b/lib/mhrmm.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhrmm.pl 1.2 98/10/31 11:50:17 +## @(#) mhrmm.pl 1.4 00/04/24 00:03:36 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Rmm routine for MHonArc. ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1995-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1995-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -70,7 +70,7 @@ sub rmm { ## Remove messages foreach $num (@numbers) { - if (($key = $Num2Index{$num}) || $MsgId{$num}) { + if (($key = $Num2Index{$num}) || ($key = $MsgId{$num})) { &delmsg($key); # Need to flag messages that link to deleted message so diff --git a/lib/mhscan.pl b/lib/mhscan.pl index 9961824..423aa2a 100644 --- a/lib/mhscan.pl +++ b/lib/mhscan.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhscan.pl 1.1 98/08/10 23:56:33 +## @(#) mhscan.pl 1.2 99/06/25 14:23:50 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Scan routine for MHonArc ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1995-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1995-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by diff --git a/lib/mhsingle.pl b/lib/mhsingle.pl index 96f6767..a2211c0 100644 --- a/lib/mhsingle.pl +++ b/lib/mhsingle.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhsingle.pl 1.2 98/10/31 12:10:13 +## @(#) mhsingle.pl 1.5 99/08/04 23:39:52 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Routines for converting a single message to HTML ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1995-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1995-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -44,7 +44,7 @@ sub single { die("ERROR: Unable to open $ARGV[0]\n"); $filename = $ARGV[0]; } else { - $handle = 'STDIN'; + $handle = $MhaStdin; } ## Read header @@ -63,9 +63,11 @@ sub single { @Index2MLoc{@MListOrder} = (0 .. $#MListOrder); ## Output mail - &output_mail($index, 1, 0); + if ($DoArchive) { + &output_mail($index, 1, 0); + } - close($handle); + close($handle) unless -t $handle; } ##--------------------------------------------------------------------------- diff --git a/lib/mhthread.pl b/lib/mhthread.pl index 390702b..dd3ab5a 100644 --- a/lib/mhthread.pl +++ b/lib/mhthread.pl @@ -1,13 +1,13 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhthread.pl 2.4 98/10/10 16:29:57 +## @(#) mhthread.pl 2.6 99/06/25 14:18:25 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Thread routines for MHonArc ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1995-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1995-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -93,6 +93,9 @@ sub write_thread_index { } print STDOUT "Writing $TIDXPATHNAME ...\n" unless $QUIET; + ($tmpl = $SSMARKUP) =~ s/$VarExp/&replace_li_var($1,'')/geo; + print $handle $tmpl; + print $handle "\n"; ($tmpl = $TIDXPGBEG) =~ s/$VarExp/&replace_li_var($1,'')/geo; @@ -211,19 +214,21 @@ sub compute_threads { %SReplies = (); ## Sort by date first for subject based threads - @ThreadList = sort increase_index keys %Subject; + @ThreadList = sort_messages(0,0,0,0); ## Find first occurrances of subjects - foreach $index (@ThreadList) { - $tmp = lc $Subject{$index}; - 1 while (($tmp =~ s/^$SubReplyRxp//io) || - ($tmp =~ s/\s*-\s*re(ply|sponse)\s*$//io)); - - $stripsub{$index} = $tmp; - $FirstSub2Index{$tmp} = $index - unless defined($FirstSub2Index{$tmp}) || - (defined($Refs{$index}) && - grep($MsgId{$_}, split(/$X/o, $Refs{$index}))); + if (!$NoSubjectThreads) { + foreach $index (@ThreadList) { + $tmp = lc $Subject{$index}; + 1 while (($tmp =~ s/^$SubReplyRxp//io) || + ($tmp =~ s/\s*-\s*re(ply|sponse)\s*$//io)); + + $stripsub{$index} = $tmp; + $FirstSub2Index{$tmp} = $index + unless defined($FirstSub2Index{$tmp}) || + (defined($Refs{$index}) && + grep($MsgId{$_}, split(/$X/o, $Refs{$index}))); + } } ## Compute thread data @@ -251,7 +256,7 @@ sub compute_threads { } continue { # Check for subject-based threading - if (!$HasRef{$index}) { + if (!$NoSubjectThreads && !$HasRef{$index}) { if (($refindex = $FirstSub2Index{$stripsub{$index}}) && ($refindex ne $index)) { @@ -267,7 +272,7 @@ sub compute_threads { } ## Calculate thread listing order - @ThreadList = &t_sort_messages(); + @ThreadList = sort_messages($TNOSORT, $TSUBSORT, 0, $TREVERSE); foreach $index (@ThreadList) { unless ($Counted{$index} || $HasRef{$index}) { &do_thread($index, 0); @@ -317,8 +322,9 @@ sub do_thread { ## sub print_thread { local($handle, $idx, $top) = ($_[0], $_[1], $_[2]); - local(@repls, @srepls) = (); - local($attop, $haverepls, $hvnirepls, $single, $depth, $i); + my(@repls, @srepls) = (); + my($attop, $haverepls, $hvnirepls, $single, $depth, $i); + my $didtliend = 0; ## Get replies @repls = sort increase_index split(/$bs/o, $Replies{$idx}) @@ -351,8 +357,8 @@ sub print_thread { } else { ## Check for missing messages if ($DoMissingMsgs) { - for ($i = $depth; $i > 0; $i--) { - $level++; + for ($i=$depth; $i > 0; --$i) { + ++$level; &print_thread_var($handle, $idx, *TLINONE); &print_thread_var($handle, $idx, *TSUBLISTBEG) if $level <= $TLEVELS; @@ -362,8 +368,12 @@ sub print_thread { } ## Increment level count if their are replies - if ($haverepls) { - $level++; + ++$level if ($haverepls); + + ## Print list item close if hit max depth + if (!$attop && !$single && ($level > $TLEVELS)) { + &print_thread_var($handle, $idx, *TLIEND); + $didtliend = 1; } ## Mark message printed @@ -386,23 +396,22 @@ sub print_thread { } ## Decrement level count if their were replies - if ($haverepls) { - $level--; - } + --$level if ($haverepls); + ## Check for missing messages if ($DoMissingMsgs && !($attop || $single)) { - for ($i = $depth; $i > 0; $i--) { + for ($i=$depth; $i > 0; --$i) { &print_thread_var($handle, $idx, *TLINONEEND); &print_thread_var($handle, $idx, *TSUBLISTEND) if $level <= $TLEVELS; - $level--; + --$level; } } ## Close entry text if ($attop) { &print_thread_var($handle, $idx, *TTOPEND); - } elsif (!$single) { + } elsif (!$single && !$didtliend) { &print_thread_var($handle, $idx, *TLIEND); } } diff --git a/lib/mhtime.pl b/lib/mhtime.pl index 904b292..d24a79e 100644 --- a/lib/mhtime.pl +++ b/lib/mhtime.pl @@ -1,12 +1,12 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhtime.pl 2.2 98/08/10 23:43:24 +## @(#) mhtime.pl 2.8 00/01/15 17:51:12 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Time related routines for mhonarc ##---------------------------------------------------------------------------## -## Copyright (C) 1996-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1996-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -24,49 +24,45 @@ ## 02111-1307, USA ##---------------------------------------------------------------------------## +package mhonarc; + ##---------------------------------------------------------------------------## ## Date variables for date routines ## -{ - package mhtime; - - %Month2Num = ( - 'jan', 0, 'feb', 1, 'mar', 2, 'apr', 3, 'may', 4, 'jun', 5, 'jul', 6, - 'aug', 7, 'sep', 8, 'oct', 9, 'nov', 10, 'dec', 11, - ); - %WDay2Num = ( - 'sun', 0, 'mon', 1, 'tue', 2, 'wed', 3, 'thu', 4, 'fri', 5, 'sat', 6, - ); - - @weekdays = ('Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'); - @Weekdays = ('Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', - 'Friday', 'Saturday'); - @months = ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', - 'Sep', 'Oct', 'Nov', 'Dec'); - @Months = ('January', 'February', 'March', 'April', 'May', 'June', - 'July', 'August', 'September', 'October', 'November', - 'December'); - - $p_weekdays = "Mon|Tue|Wed|Thu|Fri|Sat|Sun"; - $p_months = "Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec"; - $p_hrminsec = '\d{1,2}:\d\d:\d\d'; - $p_hrmin = '\d{1,2}:\d\d'; - $p_day = '\d{1,2}'; - $p_year = '\d\d\d\d|\d\d'; -} +my %Month2Num = ( + 'jan', 0, 'feb', 1, 'mar', 2, 'apr', 3, 'may', 4, 'jun', 5, 'jul', 6, + 'aug', 7, 'sep', 8, 'oct', 9, 'nov', 10, 'dec', 11, +); +my %WDay2Num = ( + 'sun', 0, 'mon', 1, 'tue', 2, 'wed', 3, 'thu', 4, 'fri', 5, 'sat', 6, +); + +my @wdays = ('Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'); +my @Wdays = ('Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', + 'Friday', 'Saturday'); +my @mons = ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', + 'Sep', 'Oct', 'Nov', 'Dec'); +my @Mons = ('January', 'February', 'March', 'April', 'May', 'June', + 'July', 'August', 'September', 'October', 'November', + 'December'); + +my $p_weekdays = "Mon|Tue|Wed|Thu|Fri|Sat|Sun"; +my $p_months = "Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec"; +my $p_hrminsec = '\d{1,2}:\d\d:\d\d'; +my $p_hrmin = '\d{1,2}:\d\d'; +my $p_day = '\d{1,2}'; +my $p_year = '\d\d\d\d|\d\d'; ##--------------------------------------------------------------------------- ## Set weekday and month names. This allows localization of ## names. ## sub set_date_names { - package mhtime; - - local(*in_wd, *in_Wd, *in_m, *in_M) = @_; - @weekdays = @in_wd if scalar(@in_wd); - @Weekdays = @in_Wd if scalar(@in_Wd); - @months = @in_m if scalar(@in_m); - @Months = @in_M if scalar(@in_M); + my($in_wd, $in_Wd, $in_m, $in_M) = @_; + @wdays = @$in_wd if defined($in_wd) && scalar(@$in_wd); + @Wdays = @$in_Wd if defined($in_Wd) && scalar(@$in_Wd); + @mons = @$in_m if defined($in_m) && scalar(@$in_m); + @Mons = @$in_M if defined($in_M) && scalar(@$in_M); } ##--------------------------------------------------------------------------- @@ -78,11 +74,9 @@ sub getdate { } ##--------------------------------------------------------------------------- -## Convert a calander time to a string. Similar to strftime(3). +## Convert a calander time to a string. ## sub time2str { - package mhtime; - my($fmt, $time, $local) = @_; my($date) = ""; @@ -90,54 +84,66 @@ sub time2str { my($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = ($local ? localtime($time) : gmtime($time)); + ## If format string blank, use default format + if ($fmt !~ /\S/) { + $fmt = '%a %b %d %H:%M:%S'; + $fmt .= ' GMT' unless $local; + $fmt .= ' %Y'; + } + + POSIXMODCHK: { + last POSIXMODCHK unless $POSIXstrftime; + eval { require POSIX; }; + last POSIXMODCHK if ($@) || !defined(&POSIX::strftime); + return POSIX::strftime($fmt, $sec,$min,$hour,$mday,$mon,$year, + $wday,$yday,$isdst); + } + + ## Get here, we have to do it ourselves. my($yearfull, $hour12); $yearfull = $year + 1900; + $year = $year % 100; $hour12 = $hour > 12 ? $hour-12 : $hour; ## Format output - if ($fmt =~ /\S/) { - $fmt =~ s/\%a/$weekdays[$wday]/g; - $fmt =~ s/\%A/$Weekdays[$wday]/g; - $fmt =~ s/\%b/$months[$mon]/g; - $fmt =~ s/\%B/$Months[$mon]/g; - - $sec = sprintf("%02d", $sec); - $min = sprintf("%02d", $min); - $hour = sprintf("%02d", $hour); - $hour12 = sprintf("%02d", $hour12); - $mday = sprintf("%02d", $mday); - $mon = sprintf("%02d", $mon+1); - $year = sprintf("%02d", $year); - $yearfull = sprintf("%04d", $yearfull); - $wday = sprintf("%02d", $wday+1); - $yday = sprintf("%03d", $yday); - - $fmt =~ s/\%d/$mday/g; - $fmt =~ s/\%H/$hour/g; - $fmt =~ s/\%I/$hour12/g; - $fmt =~ s/\%j/$yday/g; - $fmt =~ s/\%m/$mon/g; - $fmt =~ s/\%M/$min/g; - $fmt =~ s/\%n/\n/g; - $fmt =~ s/\%p/am/g if ($hour < 12); - $fmt =~ s/\%p/pm/g if ($hour >= 12); - $fmt =~ s/\%P/AM/g if ($hour < 12); - $fmt =~ s/\%P/PM/g if ($hour >= 12); - $fmt =~ s/\%S/$sec/eg; - $fmt =~ s/\%w/$wday/g; - $fmt =~ s/\%y/$year/g; - $fmt =~ s/\%Y/$year+1900/ge; - - $fmt =~ s/\%\%/\%/g ; - - $date = $fmt ; + $fmt =~ s/\%c/\%a \%b \%d \%H:\%M:\%S \%Y/g; + + $fmt =~ s/\%a/$wdays[$wday]/g; + $fmt =~ s/\%A/$Wdays[$wday]/g; + $fmt =~ s/\%[bh]/$mons[$mon]/g; + $fmt =~ s/\%B/$Mons[$mon]/g; + + $sec = sprintf("%02d", $sec); + $min = sprintf("%02d", $min); + $hour = sprintf("%02d", $hour); + $hour12 = sprintf("%02d", $hour12); + $mday = sprintf("%02d", $mday); + $mon = sprintf("%02d", $mon+1); + $year = sprintf("%02d", $year); + $yearfull = sprintf("%04d", $yearfull); + $wday = sprintf("%02d", $wday+1); + $yday = sprintf("%03d", $yday); + + $fmt =~ s/\%d/$mday/g; + $fmt =~ s/\%H/$hour/g; + $fmt =~ s/\%I/$hour12/g; + $fmt =~ s/\%j/$yday/g; + $fmt =~ s/\%m/$mon/g; + $fmt =~ s/\%M/$min/g; + $fmt =~ s/\%n/\n/g; + $fmt =~ s/\%p/am/g if ($hour < 12); + $fmt =~ s/\%p/pm/g if ($hour >= 12); + $fmt =~ s/\%P/AM/g if ($hour < 12); + $fmt =~ s/\%P/PM/g if ($hour >= 12); + $fmt =~ s/\%S/$sec/g; + $fmt =~ s/\%w/$wday/g; + $fmt =~ s/\%y/$year/g; + $fmt =~ s/\%Y/$yearfull/g; + + $fmt =~ s/\%\%/\%/g ; + + $date = $fmt ; - } else { - $date = sprintf("%s %s %02d %02d:%02d:%02d ". - ($local ? "%d" : "GMT %d"), - $weekdays[$wday], $months[$mon], - $mday, $hour, $min, $sec, $yearfull); - } $date ; } @@ -170,12 +176,10 @@ sub time2str { ## Contributer(s): Frank J. Manion ## sub parse_date { - package mhtime; - - local($date) = $_[0]; - local($wday, $mday, $mon, $yr, $time, $hr, $min, $sec, $zone); - local(@array); - local($start, $rest); + my($date) = $_[0]; + my($wday, $mday, $mon, $yr, $time, $hr, $min, $sec, $zone); + my(@array); + my($start, $rest); # Try to find the date by focusing on the "\d\d:\d\d" field. # All parsing is then done relative to this location. @@ -219,7 +223,7 @@ sub parse_date { } elsif ( $rest =~ /^($p_year)/o ) { # YYYY ($yr) = ($1); } else { # zilch, use current year - warn "Warning: No year in date, using current\n"; + warn "Warning: No year in date ($date), using current\n"; $yr = (localtime(time))[5]; } @@ -241,10 +245,8 @@ sub parse_date { ## year can be specifed as "yyyy" if a 4 digit year is needed. ## sub time2mmddyy { - package mhtime; - - local($time, $fmt) = ($_[0], $_[1]); - local($day,$mon,$year,$ylen); + my($time, $fmt) = ($_[0], $_[1]); + my($day,$mon,$year,$ylen,$tmp); if ($time) { ($day,$mon,$year) = (localtime($time))[3,4,5]; $year += 1900; @@ -274,22 +276,25 @@ sub time2mmddyy { ## seconds. ## sub zone_offset_to_secs { - local($off) = shift; - local($sign, $min); + my($off) = shift; + my($sign, $min); + ## Check if just an hour specification if (length($off) < 4) { - warn qq{Warning: "$off" not a valid timezone offset\n}; - return 0; + return $off * 3600; } - if ($off =~ s/-//) { # Check for sign + ## Check for sign + if ($off =~ s/-//) { $sign = -1; } else { $sign = 1; s/\+//; } - $min = substr($off, -2, 2); # Extract minutes - substr($off, -2, 2) = ""; # Just leave hour in $off - $sign * (($off * 3600) + ($min * 60)); + ## Extract minutes + $min = substr($off, -2, 2); + substr($off, -2, 2) = ""; # Just leave hour in $off + ## Translate to seconds + $sign * (($off * 3600) + ($min * 60)); } ##---------------------------------------------------------------------------## diff --git a/lib/mhtxtenrich.pl b/lib/mhtxtenrich.pl index d3ccb7a..dd7099b 100644 --- a/lib/mhtxtenrich.pl +++ b/lib/mhtxtenrich.pl @@ -1,8 +1,8 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhtxtenrich.pl 2.2 98/08/10 23:50:38 +## @(#) mhtxtenrich.pl 2.4 00/02/08 10:04:43 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@pobox.com ## Description: ## Library defines a routine for MHonArc to filter text/enriched ## data. @@ -16,7 +16,7 @@ ## ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1997-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1997-1999 Earl Hood, mhonarc@pobox.com ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -81,7 +81,7 @@ sub filter { ## (we already did '<' and '&' characters) if ($charset =~ /iso-8859-([2-9]|10)/i) { require 'iso8859.pl'; - $ret = &iso_8859'str2sgml($ret, $charset, 1); + $ret = &iso_8859::str2sgml($ret, $charset, 1); } $ret; diff --git a/lib/mhtxthtml.pl b/lib/mhtxthtml.pl index 09dc8d8..e7653a8 100644 --- a/lib/mhtxthtml.pl +++ b/lib/mhtxthtml.pl @@ -1,18 +1,18 @@ ##---------------------------------------------------------------------------## ## File: -## @(#) mhtxthtml.pl 2.6 98/10/25 13:58:15 +## @(#) mhtxthtml.pl 2.15 01/06/10 17:36:57 ## Author: -## Earl Hood earlhood@usa.net +## Earl Hood mhonarc@mhonarc.org ## Description: ## Library defines routine to filter text/html body parts ## for MHonArc. ## Filter routine can be registered with the following: -## -## text/html:m2h_text_html'filter:mhtxthtml.pl -## +## +## text/html:m2h_text_html'filter:mhtxthtml.pl +## ##---------------------------------------------------------------------------## ## MHonArc -- Internet mail-to-HTML converter -## Copyright (C) 1995-1998 Earl Hood, earlhood@usa.net +## Copyright (C) 1995-2000 Earl Hood, mhonarc@mhonarc.org ## ## This program is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by @@ -32,23 +32,53 @@ package m2h_text_html; -$Url = '(\w+://|\w+:)'; # Beginning of URL match expression +# Beginning of URL match expression +my $Url = '(\w+://|\w+:)'; +# Script related attributes +my $SAttr = q/(?:onload|onunload|onclick|ondblclick|/. + q/onmouse(?:down|up|over|move|out)|/. + q/onkey(?:press|down|up))/; +# Script/questionable related elements +my $SElem = q/(?:applet|base|embed|form|ilayer|input|layer|link|meta|object|/. + q/option|param|select|textarea)/; ##--------------------------------------------------------------------------- ## The filter must modify HTML content parts for merging into the ## final filtered HTML messages. Modification is needed so the ## resulting filtered message is valid HTML. ## +## Arguments: +## +## allowscript Preserve any markup associated with scripting. +## This includes elements and attributes related +## to scripting. The default is to delete any +## scripting markup for security reasons. +## +## nofont Remove tags. +## +## allowcomments Preserve any comment declarations. Normally +## Comment declarations are munged to prevent +## SSI attacks or comments that can conflict +## with MHonArc processing. Use this option +## with care. +## sub filter { local($header, *fields, *data, $isdecode, $args) = @_; - local($base, $title, $tmp); - local(@files) = (); # !!!Used by resolve_cid - $base = ''; - $title = ''; - $tmp = ''; + local(@files) = (); # !!!Used by resolve_cid!!! + my $base = ''; + my $title = ''; + my $noscript = 1; + $noscript = 0 if $args =~ /\ballowscript\b/i; + my $nofont = $args =~ /\bnofont\b/i; + my $tmp; + + ## Check comment declarations: may screw-up mhonarc processing + ## and avoids someone sneaking in SSIs. + #$data =~ s///go; # can crash perl + $data =~ s/