minor readme update
[mharc.git] / NEWS
1 ===========================================================================
2 2003/08/09: v0.7.3
3
4 Bugs Fixed:
5
6   Bug ID  Summary
7   ------  ------------------------------------------------------------
8    4319   Order of list archive defs in lists.def not reflected in
9           procmail.mharc.
10   ------  ------------------------------------------------------------
11   <http://savannah.nongnu.org/bugs/index.php?group_id=1968
12    &set=custom&advsrch=&msort=&report_id=105&go_report=Browse
13    &category_id=110&fix_release=0.7.3&chunksz=50>
14
15 * lib/common.mrc.in.dist:
16   . Changed the default value of BOOKMARK-LINK-LABEL custom resource
17     variable to "Permanent&nbsp;Link".  This appears to be more
18     descriptive and less ambiguous than "Bookmark&nbsp;Link".
19     The resource variable name will stay the same for compatibility
20     reasons.
21
22 + lib/common.mrc.{da,en,pl}.in.dist:
23   . Localized resource settings for common.mrc.  These replace
24     the mrc/_lang* files.  These new files fit with the new Lang
25     option for lib/lists.def that leverages the new LANG resource
26     support in MHonArc (v2.6.7 and later) for providing easier
27     localization management of archives.
28
29   . The Polish localization is new to mharc and contributed by
30     Bartosz Feski.
31
32 - lib/mrc/_lang_*.mrc.in.dist:
33   . Removed (see previous item).
34
35 * bin/web-archive:
36   . Added support for the following lists.def options:
37
38       All-Lists-Name:       Archive name to use in all-lists index
39       Lang:                 Language of archive
40                             (requires MHonArc v2.6.7 or later).
41       Hide-From-All-Lists:  Do not list archive in all-lists index
42
43     See the mk-procmailrc manpage for more information about these
44     options.
45
46 * bin/mk-procmailrc:
47   . Archives can now be defined solely by Procmail-Condition, without
48     the requirement of defining an Address or From-Address option.
49
50 * etc/crontab.in.dist,
51   etc/logrotate.conf.in.dist:
52   . Sample logrotate(8) configuration file and template crontab entry
53     added to facilitate mharc log file rotation.  Logrotate is provided
54     under most linux distros and is widely used on Unix systems.
55
56 * etc/apache.conf.in.dist:
57   + Added commented Alias directive for ROOT_URL.
58
59 ===========================================================================
60 2003/04/07: v0.7.2
61
62 * bin/apply-config, bin/mh-month-pack:
63   . Removed 'use Pod::Usage' statement.  It is required only when
64     needed.  This should allow script execution on systems that do
65     not have Pod::Usage installed (but user will not be able to get
66     help from the command-line).
67
68 * bin/apply-config:
69   . Minor change which should make apply-config run under older versions
70     of Perl with older versions of File::Find module.
71
72 * cgi-bin/mnav.cgi.in.dist:
73   . Https check added so redirect URL sent to client will start with
74     'https://' if secure HTTP is being used (thanks to Jonathon Padfield
75     for catching this).
76
77 * bin/mk-procmailrc:
78   . Some optimization cleanup on procmailrc generation.
79
80 * bin/web-archive:
81   . Added -keepsearch option to preserve the search index when
82     -rebuild is specified.
83
84 * install.pl:
85   . Added $HOME/libexec, /usr/lib/cgi-bin, and /usr/local/lib/cgi-bin
86     paths when searching for namazu.cgi.
87
88 ===========================================================================
89 2002/10/02: v0.7.1
90
91 * lib/lists.def, bin/mk-procmailrc, bin/web-archive:
92   . Added support for Check-No-Archive for lists.def.
93     The author can request no archiving should be done by defining
94     one of the the following header fields:
95
96       Restrict: no-external-archive
97       X-no-archive: yes
98
99     If Check-No-Archive is enabled, a message to the list with either
100     field defined will not be archived.
101
102 * lib/mk-procmailrc:
103   . Can now specify a mail address to receive all unmatched messages
104     via the CATCH_ADDRESS config.sh variable.  This serves as a
105     (better?) alternative to the .catch archive.
106
107 * bin/logcmd:
108   . New script to help provide better logging of crontab commands.
109
110 * etc/crontab.in.dist:
111   . Entries changed to use new logcmd script for dumping any command
112     output to @@SW_ROOT@@/log/cron.log.
113
114 * lib/config.sh.in.dist:
115   . Added CATCH_ADDRESS: Specify mail address to receive all unmatched
116     messages.  If defined, it supercedes $CATCH_ARCHIVE.
117
118 ===========================================================================
119 2002/09/28: v0.7.0
120
121 * Extracting the mharc distribution will now generate a directory
122   called "mharc-X.X.X", where X.X.X is the version of mharc.  A new
123   install script (see next change item) is now provided to install
124   mharc into the location you desire.
125
126   Existing users should be aware of that you no longer just extract
127   a distribution in the location of your existing mharc installation
128   to perform upgrades.  You will now extract in a temporary location,
129   and then use the install script provided (see next change item)
130   to upgrade an existing installation.
131
132 * install.pl:
133   . New Perl installation program for mharc.  It should make the
134     installation easier and more automated, and for new installations,
135     it will preset some config.sh variables.
136
137     NOTE: Not all installation steps can be automated, like crontab
138     editing, web server configure, etc.  See the installation document
139     for more information on the new installation process.
140
141 * bin/apply-config:
142   . BUG FIX: Fixed handling of case when no directories are supplied
143     on the command-line.  Cases where HTML_DIR, or other directory
144     variables, are defined to pathnames not under $SW_ROOT are now
145     handled.  Thanks to Eugene Eric Kim for spotting this problem.
146
147 * bin/filter-spool:
148   . Updated to use new PROCMAIL, FORMAIL, and LOCKFILE variables
149     representing the pathnames to the respective programs used by
150     filter-spool.
151
152 * bin/web-archive:
153   . BUG FIX: The ALL_LISTS_FILE variable in config.sh was not
154     supported.  web-archive was looking up the wrong variable name.
155
156 * lib/config.sh.dist:
157   . Added CGI_DIR variable to represent pathname to CGI bin directory
158     (default value is $SW_ROOT/cgi-bin).  Various CGI variables now
159     reference this variable in the default values.  CGI_DIR exists
160     mainly for use by the new install.pl script.
161
162   . Added PROCMAIL variable to represent pathname to procmail program.
163   . Added LOCKFILE variable to represent pathname to lockfile program.
164   . Added FORMAIL variable to represent pathname to formail program.
165
166 ===========================================================================
167 2002/09/19: v0.6.4
168
169 * bin/web-archive:
170   . BUG FIX: Changes to fix backdoor to raw mail messages for
171     archives with No-Raw-Link enabled.  For archives with No-Raw-Link
172     enabled, a file called ".noraw" will appear for the archives
173     under the raw mailbox data.  This file is used by extract-mesg.cgi
174     to determine if retrieval of original messages is allowed.
175
176     Also, a .htaccess file will be created to deny access via direct
177     HTTP access by a client for those that are using the Apache
178     HTTP server with .htaccess support enabled.  If .htaccess is not
179     supported (or you are using a non-Apache web server), you will need
180     to modify the server configuration file directly to deny access.
181
182   . Added support for localizing labels in all-lists archive listing
183     table via new lib/config.sh variables.
184
185 * cgi-bin/extract-mesg.cgi.in.dist:
186   . BUG FIX: Changes to fix backdoor to raw mail messages for
187     archives with No-Raw-Link enabled.  In order to enable the new
188     fixed version, you MUST do the following:
189
190       prompt> rm cgi-bin/extract-mesg.cgi.in
191       prompt> make configure
192
193   . BUG FIX: Fixed regex pattern checking for valid period argument.
194     Extraction of yearly-based archives should now work properly.
195
196 * lib/config.sh.dist:
197   . Added the following variables to support localization of all-lists
198     page (default values shown):
199
200       ALL_LISTS_LABEL_NAME='Name'
201       ALL_LISTS_LABEL_INDEXES='Current&nbsp;Index'
202       ALL_LISTS_LABEL_LAST_UPDATED='Last&nbsp;Updated'
203       ALL_LISTS_LABEL_INFO='[info]'
204       ALL_LISTS_LABEL_DATE='[Date]'
205       ALL_LISTS_LABEL_THREADS='[Thread]'
206       ALL_LISTS_DATE_FORMAT='%Y-%m-%d %H:%M:%S'
207
208 * lib/mrc/_lang_da.mrc.in.dist:
209   . NEW: Danish localization file.  Thanks goto Lars Jorgensen for
210     the contribution.
211
212 * lib/mrc/_nospam.mrc.in.dist:
213   . Added definition of FIELDORDER to provide a minimal message header.
214     This is to minimize the potential of addresses showing up in
215     unexpected header fields.
216
217 * bin/config-check:
218   . NEW: New script to dump expanded variable values of lib/config.sh
219     to standard output.
220
221 * lib/MHArc/Config.pm:
222   . A Perl cache file is now created to make subsequent loads faster.
223     Hence, you will see a file called lib/config.sh.cache.pl appear.
224     This file should not be edited.  The module auto-detects when
225     lib/config.sh is modified.
226
227 * doc/:
228   . Some documentation fixes and enhancements.
229     
230 ===========================================================================
231 2002/09/15: v0.6.3
232
233 * Makefile:
234   . BUG FIX: Fixed bug with 'make configure' where mhonarc-check
235     should be done after config.sh exists.
236
237 ===========================================================================
238 2002/09/14: v0.6.2
239
240 * doc/:
241   . NEW: HTML documentation now exists, including documentation for
242     the scripts and modules and an updated, and improved, installation
243     document.
244
245     Existing mharc users are encouraged to read through the new
246     documentation, especially the installation document, since some
247     helpful new information has been added.
248
249 * bin/web-archive:
250   . Added definition of $NMZ-SUBJECT-QUERY$ resource variable.  It
251     expands to a namazu query string that will find all messages with
252     the same subject as the current message.
253
254     This variable is referenced in the updated lib/common.mrc.in.dist
255     resource for use with the new  [More on this subject...] link
256     at the end of the message body.
257
258 * lib/common.mrc.in.dist:
259   . Added "[More on this subject...]" to message page layout that
260     will provide a list of archive messages with the same subject as
261     the current message.  This is an alternative navigational aid
262     to discussion threads since it is not limited to the current
263     period as thread listings are.
264
265   . Some restructuring to support localization.  For an example on how
266     localization can be done for a language, see
267     lib/mrc/_lang_en.mrc.in.dist.
268
269 * etc/apache.conf.in.dist, etc/.htaccess.in.dist:
270   . Added access denial to working/temporary ".newmail" file used by
271     filter-spool.
272   . apache.conf directives adjusted to separate cgi-bin into its own
273     Directory directive to provide better granularity of access.
274
275 * lib/mrc/_lang_en.mrc.in.dist:
276   . NEW: Includable resource file for English localization
277     (defaults in common.mrc.in.dist are already in English, so this
278     file mainly serves as a template for creating resource files
279     for other languages).
280
281 * lib/mrc/_logo.mrc.in.dist:
282   . NEW: Includable resource file to allow for the addition of
283     a logo, or small image, at the top of archive pages.
284
285 * lib/mrc/_nosearch.mrc.in.dist:
286   . NEW: Includable resource file for archives with searching disabled.
287
288 * lib/mrc/_nospam.mrc.in.dist:
289   . NEW: Includable resource file for those who want to deter
290     address harvesters.
291
292 * bin/*:
293   . Programs in bin directory all perform a check if invoked in a
294     CGI context.  If so, the program will abort execution.
295     This is done to provide some extra security incase of server
296     misconfiguration.
297
298 ===========================================================================
299 2002/09/04: v0.6.1
300
301 * bin/extract-mesg-date:
302   . Added check for new MSG_DATE_FIELDS config.sh variable denoting
303     the message header fields to extract the date from.  The
304     value of MSG_DATE_FIELDS is used if -datefields is not specified.
305
306 * bin/filter-spool:
307   . If there is no mail in the spool, but .newmail exists,
308     filter-spool will still process .newmail.  .newmail is the
309     messages copied from the spool when filter-spool is executing.
310     In the past, even if .newmail exists, no mail in the spool
311     will cause filter-spool to exit.
312
313 * bin/web-archive:
314   . Added check for MSG_DATE_FIELDS config.sh variable.  If set,
315     its value will passed to MHonArc via the DATEFIELDS resource.
316   . Define $MESG-CGI$ resource variable for use within MHonArc
317     resource files.
318
319 * cgi-bin/extract-mesg.cgi.in.dist:
320   . Internal changes so its uses new MHArc::CGI utility routines.
321   . POD added.
322
323 * cgi-bin/mesg.cgi.in.dist:
324   . NEW: New CGI program to extract a message from an archive based
325     upon message-id.  This allows for persistent URLs to messages
326     that are immune to archive rebuilds that could change MHonArc
327     message numbers.
328
329     This CGI is referenced in the updated lib/common.mrc.in.dist
330     resource file via the $MESG-CGI$ resource variable.  It is
331     used for the new [Bookmark Link] on message pages.
332
333 * cgi-bin/mnav.cgi.in.dist:
334   . Added some sanity checks to argument input.
335   . Internal changes so its uses new MHArc::CGI utility routines.
336   . POD added.
337
338 * lib/common.mrc.in.dist:
339   . Added "[Bookmark Link]" to message page layout to provide a
340     persistent link to the message.  The link provided makes use
341     of the new mesg.cgi CGI script.
342
343 * lib/config.sh.dist:
344   . Added MSG_DATE_FIELDS: List of message header fields to extract
345     the date for a message.
346   . Added MESG_CGI: URL to persistent message reference CGI program
347     (mesg.cgi).
348
349 * lib/MHArc/CGI.pm:
350   . NEW: Shared CGI utility routines for mharc CGI scripts.
351
352 * lib/MHArc/MailUtil.pm:
353   . extract_date() routine changed to handle indexed header fields
354     in date fields argument.
355
356     CAUTION: Only use indexed field specification if you are using
357     a version of MHonArc *newer than* 2.5.11.  MHonArc v2.5.11,
358     and earlier versions, do not support indexed fields for the
359     DATEFIELDS resource.
360
361 * lib/MHArc/Namazu.pm:
362   . NEW: Collection of routines related to Namazu.
363
364 ===========================================================================
365 2002/08/26: v0.6.0
366
367 * bin/compress-files, bin/compress-mboxes:
368   . BUG FIX: Added -mbox-mode to compress-files.  This is to fix a bug
369     with compress-mboxes for archives that have yearly archives.
370     If a mailbox is in YYYY format, a year is added to -mtime to
371     determine if the file should be compressed.
372
373 * bin/web-archive:
374   . NEW: Added auto-generation of all-lists index.  The index will
375     contain the list of archives with links to the latest indexes
376     and showing the last update time for each archive.
377
378     The all-lists index file can be specified by the -alllistidx
379     option or ALL_LISTS_INDEX lib/config.sh variable.  The default
380     value is lists.html within the html/ archive directory.
381     Equivalent options exists to set the URL to the file.
382
383     Run web-archive program with -man option to view the manpage
384     to get more information about this feature and other related
385     options.
386
387 * lib/common.mrc.in.dist:
388   . Several layout changes to provide a nicer appearance to archive
389     pages.  Layout is now controled via stylesheet settings.
390     Tags have been added with CLASS attributes to allow control
391     of the visual appearance of pages without having to re-edit
392     the pages.  An initial stylesheet (html/stylesheet.css.in.dist)
393     has been provided with some default styles (more information
394     about stylesheet below).
395
396     Attempts have been made to keep pages usable with text-based
397     browsers.  Table-aware browsers like w3m and links, handle
398     the pages fine.  Lynx does not handle the tables well, but
399     the pages should still be readable and usable with Lynx.
400
401     To see an example of the layout style, you can checkout the
402     mhonarc.org mailing lists at
403     <http://www.mhonarc.org/archive/html/>.
404
405     If you want to use the new layout, you must delete your local
406     copy of "lib/common.mrc.in" and run "make configure".
407
408 * html/stylesheet.css.in.dist:
409   . NEW: This is the main stylesheet controling the appearance
410     of archive pages generated by MHArc.  Stylesheet settings are
411     based upon the CSS2 specification.  The styles are supported by
412     Netscape 6+, Mozilla, and Mozilla-based browsers.  Some styles
413     appear to not work with IE6, however, the failures of IE6 do not
414     affect the readability of pages.
415
416 * lib/mrc/_nothread.mrc.in.dist:
417   . NEW: MHonArc resource file use by archives that have threads
418     disabled, either by specifying -nothreads in the MHonArc-Options
419     option in lib/lists.def for a list or by a list-specific resource
420     file.
421
422     NOTE: There is a feature in MHArc that has not been explicitly
423           documented that allows you to provide additional
424           MHonArc resource settings on a per-list archive basis.
425           In lib/config.sh is a variable called MHA_RC_DIR that
426           specifies the location of archive-specific resource files.
427           By default, it is "<mharc-root>/lib/mrc".  If you add a
428           file called "<list-name>.mrc", where "<list-name>" is the
429           name of the list as defined in lib/lists.def, MHArc will
430           pass that file to MHonArc when processing the HTML archive
431           for the list.
432
433           When creating a list-specific resource file, it is
434           recommended to create the file
435           "<mharc-root>/lib/mrc/<list-name>.mrc.in" and then run
436           "make configure".  This allows you to use lib/config.sh
437           variables (e.g. "@@HTML_URL@@") in your resource file.
438
439     A way to reference _nothread.mrc in a resource file is to have
440     the following in the ".in" template version of a list resource
441     file:
442
443       <Include>
444       @@MHA_RC_DIR@@/_nothread.mrc
445       </Include>
446
447     When "make configure" is executed, the "@@MHA_RC_DIR@@" will get
448     expanded to the pathname location where archive-specific resource
449     files are kept.
450
451 * lib/config.sh.in.dist:
452   . Added the following variables:
453
454       # Pathname of archive lists index page.
455       ALL_LISTS_FILE=$HTML_DIR/lists.html
456
457       # Pathname of header template for archive lists index page.
458       ALL_LISTS_HEADER=$HTML_DIR/.PNM.all-head
459
460       # Pathname of header template for archive lists index page.
461       ALL_LISTS_FOOTER=$HTML_DIR/.PNM.all-foot
462
463       # Directory containing informational pages about each list archive.
464       INFO_DIR=$SW_ROOT/info
465
466       # Base URL containing informational pages about each list archive.
467       INFO_URL=$ROOT_URL/info
468
469     The INFO_DIR and INFO_URL are used when generating the
470     all-lists index page.  They give the ability for you to create
471     an informational page for each list archive.  Run web-archive
472     program with -man option to view the manpage add read about the
473     -infodir and -infourl options for more information.
474
475 * cgi-bin/template/NMZ.head.in.dist, html/.PNM.head.in.dist:
476   . Minor change to labels for sorting search results by date.
477     Newer labels should be clearer about the ordering of dates since
478     previous wording can be ambiguous.
479
480     If you want to use the newer versions, delete
481     "cgi-bin/template/NMZ.head.in" and "html/.PNM.head.in" and run
482     "make configure".
483
484 ===========================================================================
485 2002/07/31: v0.5.1
486
487 * cgi-bin/extract-mesg.cgi.in.dist:
488   . Changed returned media-type from message/rfc822 to text/plain.
489     message/rfc822 is nice since some browsers can render it directly,
490     but it does open potential XSS HTML email attacks.
491
492     IMPORTANT NOTE: User upgrading are encouraged to delete
493                     "cgi-bin/extract-mesg.cgi.in" and run 'make
494                     configure' after extracting this release.  If you
495                     really want the message/rfc822 behavior, you can
496                     edit "cgi-bin/extract-mesg.cgi.in" and redefine
497                     the $message_media_type variable.
498
499 * bin/mk-procmailrc:
500   . Added -final-dest option: The destination of messages that make
501     it to the end of the procmailrc.  Generally, this option can
502     be ignored.
503
504     Run mk-procmailrc program with -man option to view the manpage
505     to get more information about this option.
506
507 * etc/apache.conf.in.dist:
508   . Security related comments added.  Users are encourage to read
509     if using etc/apache.conf.
510
511 * lib/config.sh.dist:
512   . Added FINAL_MSG_DESTINATION variable to repesent destination
513     mailbox for end rule in procmailrc (checked by mk-procmailrc if
514     -final-dest not specified).
515
516 ===========================================================================
517 2002/07/24: v0.5.0
518
519 * bin/mk-procmailrc
520   . Added -out option that can be used to specify the name of
521     the procmailrc file to generate.  If not specified, the PROCMAILRC
522     variable in lib/config.sh is used.  Otherwise, the default value is
523     "$SW_ROOT/procmailrc.mharc";
524
525     IMPORTANT NOTE: This implies that the name of the main procmailrc
526                     used by mharc has changed from
527                     $SW_ROOT/.procmailrc.  This is to avoid potential
528                     conflict with environments that use Procmail as a
529                     local delivery agent and MHArc has been extracted
530                     in the home directory of the archiving account.
531
532                     If upgrading, all you should have to do is
533                     invoke "make" to create the procmailrc with
534                     the newer filename.  Then, you can remove the
535                     old .procmailrc.
536
537 * bin/web-archive:
538   . BUG FIX: Restored older semantics for $LIST-NAME$: It equals the
539     list name as represented by the directory name for the list
540     archives.  This change back only has an effect for complimentary
541     CVS commit archives since the $LIST-NAME$ is used as the search
542     index name.
543
544     A new resource variable, $LIST-TITLE$, is used to represent the
545     displayable list name.  For CVS commit archives, this variable
546     will have the "[CVS] " prefix.
547
548     In sum, everywhere the list name is used in links or form input
549     elements, use $LIST-NAME$.  Anywhere else, $LIST-TITLE$ can
550     be used.
551
552   . Added $EXTRACT-CGI$ resource variable
553     (see cgi-bin/extract-mesg.cgi.in.dist change entry below for
554     more information).
555
556 * cgi-bin/extract-mesg.cgi.in.dist:
557   . NEW: CGI program to extract original raw message.  It is intended
558     to be used in HTML archive message pages to allow the reader to
559     retrieve the original mail message.
560
561     The file lib/common.mrc.in.dist has been modified to include
562     an "[Original]" link on messages pages.  If you would like this
563     feature in an existing mharc archive, you will need to edit
564     your lib/common.mrc.in an add the link.  Here is the resource
565     setting added to lib/common.mrc.in.dist:
566
567     <TopLinks>
568     <hr>
569     $BUTTON(PREV)$$BUTTON(NEXT)$$BUTTON(TPREV)$$BUTTON(TNEXT)$[<a
570     href="$IDXFNAME$#$MSGNUM$">Date Index</a>][<a
571     href="$TIDXFNAME$#$MSGNUM$">Thread Index</a>][<a
572     href="$EXTRACT-CGI$?a=$LIST-NAME:U$&amp;m=$CUR-PERIOD$&amp;i=$MSGID:U$"
573     >Original</a>]
574     </TopLinks>
575
576 * lib/config.sh.dist:
577   . Added EXTRACT_CGI variable that represents URL to extract-mesg.cgi.
578   . Added PROCMAILRC variable to define main procmailrc file used
579     by bin/mk-procmailrc and bin/filter-spool.
580   . Added ORGMAIL_LOCK_TIMEOUT to set lock timeout used by filter-spool.
581   . Added LOG_DIR variable to represent location to place log files.
582
583 * lib/common.mrc.in.dist:
584   . Replaced $LIST-NAME$ with $LIST-TITLE$ in MSGPGBEGIN resource.
585
586 * etc/apache.conf.in.dist, etc/.htaccess.conf.in.dist:
587   . Added denial of files starting with "procmail".
588
589 * bin/apply-conf:
590   . Explicitly remove group and other write bit on generated files
591     that are executable.  This helps avoid Apache HTTP server suEXEC
592     problems with CGI programs.
593
594 * bin/filter-spool:
595   . Rewritten in Perl.  Run program with -man option to view manpage.
596
597 * bin/read-mail:
598   . Rewritten in Perl.  Run program with -man option to view manpage.
599
600 ===========================================================================
601 2002/07/19: v0.4.0
602
603 * bin/compress-mboxes:
604   . FIX: Fixed handling of -n and -debug options.
605
606 * lib/config.sh.dist:
607   . FIX: Default PROCMAIL_PATH setting uses $SW_ROOT/bin instead of
608     $HOME/bin.  Installations should update local config.sh
609     to reflect change.
610
611   . Added MHONARC_LIB: Directory pathname to where MHonArc libraries
612     are installed.  If MHonArc libraries are in a location not included
613     in perl's library search path, this variable should be set to
614     that location.
615
616   . Added MSGID_CACHE_SIZE: Maximum size, in bytes, of msgid cache
617     for detecting duplicate messages.
618
619   . Reorganized file to put key variables at top of file and to
620     provide a comment description before each variable.
621
622 * bin/mbox-month-pack:
623   . NEW: New utility program for breaking up a mailbox file into
624     monthly, or yearly, mailbox files.  This program can be useful
625     for importing existing mailbox files into MHArc.  Run program with
626     the -man option to view manpage.
627
628 * bin/mk-procmailrc:
629   . Added support for "From-Address: " option in lists.def.  This
630     option allows you to denote a list by the "From: " field of
631     messages.  Run mk-procmailrc with -man option for more information.
632
633   . "Cleaned-up" the procmailrc file generated.  The "Extraneous
634     copy flag" warnings should be gone.  Also, rules changed to use
635     new bin/extract-mesg-date to determine which raw mailbox to file
636     to instead of the current time.  This insures that messages go
637     into the proper period mailbox regardless of when incoming mail
638     is processed.
639
640 * bin/extract-mesg-date:
641   . NEW: New utility to print out the date of a message.  This
642     program is mainly used in newer procmailrc format generated
643     by mk-procmailrc.
644
645 ===========================================================================
646 2002/07/08: v0.3.0
647
648 * mk-procmailrc:
649   . Can now specify name of catch archive and if catch archive should
650     be disabled via the CATCH_ARCHIVE and DISABLE_CATCH_ARCHIVE config.sh
651     variables.
652
653   . POD added to script along with -help and -man options to display
654     usage information.
655
656 * web-archive:
657   . Added check for <!--x-search-form--> and <!--/x-search-form-->
658     comment declarations in period index header/footer templates:
659     .PNM.head.in and .PNM.foot.in.  If an archive is designated
660     to not have searching enabled, any markup between these two
661     comments will be stripped out when generating the period index.
662
663     If upgrading, and if you are using the default .PNM.*.in files,
664     you will need to delete them so the newer versions with the above
665     comments will be applied.  If you have customized versions of
666     .PNM.*.in files, you will need to add the above comments around
667     the search form markup if you want the form to not appear in the
668     top period indexes for non-searchable archives.
669
670   . CVS commit archive of a list properly uses list options defined
671     in lib/lists.def.
672
673   . Short title of CVS commit archives has changed from
674     "<list-name>.CVS" to "[CVS] <list-name>".
675
676 * bin/compress-files:
677   . Add POD.  Execute './bin/compress-files -man' to view
678     documentation.
679
680 * bin/compress-mboxes:
681   . Converted to Perl.  POD added along with some command-line options.
682     Execute './bin/compress-mboxes -man' to view documentation.
683
684 * bin/gc-search-indexes
685   . Converted to Perl.  POD added along with some command-line options.
686     Execute './bin/gc-search-indexes -man' to view documentation.
687
688 * etc/apache.conf.in.dist:
689   . Updated to add <File> directives to deny access to various files
690     that you may not want visible to the public.
691
692 * etc/.htaccess.in.dist:
693   . NEW: Contains the same <File> directives added to
694     etc/apache.conf.in.dist.  This file is useful if you do not have
695     write access to Apache's main configuration file.
696
697     The .htaccess file generated after 'make configure' can be copied
698     into the root install directory, or better, create a symlink
699     to it from the root by executing the following command in the
700     root install directory.
701
702       ln -s ./etc/.htaccess
703
704 * Makefile:
705   . Added editrootidx target: Rebuild top period indexes only.
706
707 ===========================================================================
708 2002/05/30: v0.2.2
709
710 * apply-config: Modified interaction with File::Find module so it
711   will work with older versions that do not support the -no_chdir
712   option.
713
714 ===========================================================================
715 2002/05/24: v0.2.1
716
717 * mk-procmailrc: Fixed bug where setting an archive to a Period of
718   a year had no effect: archive would have a monthly period.
719
720 ===========================================================================
721 2002/05/22: v0.2.0
722
723 * web-archive: Added -mharcdir option to specify location of list
724   specific resource files.  If the file <-mharcdir>/<list-name>.mrc
725   exists, it will be passed into mhonarc, after common.mrc.
726
727 * web-archive: Added support for additional mhonarc options to be
728   specified in lists.def by defining the MHonArc-Options field.
729
730 * web-archive: If the No-Search lists.def field is set to 1 for
731   a list, then searching will be disabled for the archive: no search
732   index will be created and the $SEARCH-FORM$ custom resource variable
733   will be set to the empty string.
734
735 * web-archive: Changed some of the default pathname values of some
736   options.  In sum, default pathnames that include "../archive/.."
737   had the "archive/" component removed.
738
739 * web-archive: The following resource variables set have different
740   names:
741
742     $MNAV-CGI$  => $PNAV-CGI$
743     $CUR-MONTH$ => $CUR-PERIOD$
744
745   The old names are still set for backwards compatibility.
746
747 * web-archive: The "[Raw]" link on the top index page of a list
748   archive is now "[mbox]".  Also, it will show the size of the mbox
749   in bytes and if the mbox is gzipped.
750
751 * lib/common.mrc.in.dist:
752
753   . Removed options in MIMEARGS that could cause security problems.
754     Users can add options that fit their level of comfort.
755
756   . Added definition of $PREV-PERIOD-LABEL$ and $NEXT-PERIOD-LABEL$
757     which are defined as "Prev&nbsp;Period" and "Next&nbsp;Period",
758     respectively.
759
760     These variables are used for the next/prev period links on the
761     index pages.  Note, these values are a change from the
762     "Prev&nbsp;Month" and "Next&nbsp;Month".
763
764   . The next/prev resource variables for the next/prev period links
765     have different names:
766
767       $NEXT-MONTH-LINK$ => $NEXT-PERIOD-LINK$
768       $PREV-MONTH-LINK$ => $PREV-PERIOD-LINK$
769
770 * read-mail:  Added explicit "exit 0" at end of script.  This is
771   to avoid a bogus non-zero exit status of filter-spool finds nothing
772   to do.
773
774 ===========================================================================
775 2002/02/14: v0.1.3
776
777 * web-archive: Went back to calling namazu for each list folder
778   processed.  The change in v0.1.2 defeats the ability to conserve
779   resources by keeping namazu from re-indexing the entire list
780   each time.
781
782 * web-archive: Check status of mhonarc processing.
783
784 * web-archive: Skip search index update if no new messages added.
785
786 ===========================================================================
787 2002/02/14: v0.1.2
788
789 * Added new program 'mh-month-pack' that can process MH/nmh folders
790   and copy messages into monthly-based mailbox files.  Although this
791   program is not used by default by MHArc archiving system, it can
792   be used to customize MHArc to work with MH/nmh-based setups.
793
794 * Updated web-archive to only call namazu once on all archive
795   folders changed for a list instead of calling it for each archive
796   folder processed.  Also added a cleanup check on namazu to make
797   sure it does not leave a stale lock around.
798
799 ===========================================================================
800 2002/02/11: v0.1.1
801
802 * BUG FIX: Fixed regex generation bug in mk-procmailrc where ()'s
803   were not matched.
804
805 ===========================================================================
806 2002/02/11: v0.1.0
807
808 First tagged release of mharc.  Code imported into CVS from the RCS
809 files used previously.  The following changes exist in this release:
810
811 * Mailing list definition file can now be specified in lib/config.sh.
812
813 * BUG FIX: Fixed bug in mk-procmailrc that created duplicate
814   recipies for lists defined with multiple addresses.
815
816 * The Description: option in lists.def is now used as the title
817   for archive index pages.
818
819 * Added No-Raw-Link: boolean option in lists.def.  It can be used
820   to specify that a links to the raw archive data should not be
821   made in the main period index of a list archive.
822
823 * Added new variable $LIST-DESC$ for .PNM.head and .PNM.foot
824   process for main period index generation.  The variable will
825   expand to the Description: value in lists.def.  If no
826   description available, it will expand to the list name.
827
828 * read-mail will source .env.sh in same directory if it exists.
829   It is an easy way to sent envariables needed for the archiving
830   process to run properly.
831
832 * Modified distribution bundle creation to fit in with internal
833   project release process.
834
835 ===========================================================================
836 2002/03/08:
837
838   Initial release.
839
840 ===========================================================================
841 $Id: NEWS,v 1.48 2003/08/09 18:46:19 ehood Exp $