Commit | Line | Data |
---|---|---|
86530b38 AT |
1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN"> |
2 | <HTML> | |
3 | <HEAD> | |
4 | <TITLE>MHonArc FAQ: General Information</TITLE></HEAD> | |
5 | <BODY> | |
6 | ||
7 | <!--X-NavButtons-Start--> | |
8 | <p align=center> | |
9 | [<a href="about.html">Prev</a>][<a href="envs.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/">Home</a>] | |
10 | </p> | |
11 | <!--X-NavButtons-End--> | |
12 | ||
13 | <!-- ===================================================================== --> | |
14 | <hr> | |
15 | <H2><a name="general">General</a></H2> | |
16 | ||
17 | <!--X-TOC-Start--> | |
18 | <ul> | |
19 | <li><a href="#whatis">What is MHonArc?</a></li> | |
20 | <li><a href="#mhversion">What's the latest version of MhonArc?</a></li> | |
21 | <li><a href="#get">Where can I get MHonArc?</a></li> | |
22 | <li><a href="#cost">What restrictions are there on MHonArc usage?</a></li> | |
23 | <li><a href="#help">Where can I get help on MHonArc?</a></li> | |
24 | <li><a href="#compare">How does MHonArc compare to other email archivers, like Hypermail?</a></li> | |
25 | <li><a href="#vscommercial">Why I should use MHonArc over some of the Internet-based mailing list archive services?</a></li> | |
26 | <li><a href="#studies">Are their "real-world" examples of MHonArc usage?</a></li> | |
27 | <li><a href="#whynonperl">Why are list archives about Perl-related topics not maintained with a Perl-based program, like MHonArc?</a></li> | |
28 | <li><a href="#y2k">Is MHonArc Y2K (Year 2000) compliant?</a></li> | |
29 | </ul> | |
30 | <!--X-TOC-End--> | |
31 | ||
32 | <!-- ??????????????????????????????????????????????????????????????? --> | |
33 | <hr noshade size=1> | |
34 | <table border=0> | |
35 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
36 | <h3><b><a name="whatis">What is MHonArc?</a></b></h3> | |
37 | </td></tr></table> | |
38 | ||
39 | <P>MHonArc is a <A HREF="http://perl.com/perl/">Perl</A> | |
40 | program for converting e-mail messages as specified in RFC 822 and | |
41 | <A HREF="http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html">the | |
42 | MIME standard</A> to <A | |
43 | HREF="http://www.w3.org/pub/WWW/MarkUp/">HTML</A>. | |
44 | MHonArc can perform the following tasks: </P> | |
45 | ||
46 | <UL> | |
47 | <LI>Convert <a href="http://www.ics.uci.edu/~mh/"><em>MH</em></a> | |
48 | mail folders or UUCP/Unix style mailboxes into an HTML mail archive. | |
49 | <LI>Add or remove messages to an existing HTML mail archive generated | |
50 | by MHonArc. | |
51 | <LI>Convert a single message to HTML. | |
52 | </UL> | |
53 | ||
54 | <P>Along with these tasks, MHonArc provides the following: | |
55 | </P> | |
56 | ||
57 | <UL> | |
58 | <LI>A main customizable index for mail messages archived. | |
59 | <LI>A customizable thread index listing messages by thread. | |
60 | <LI>Control over message formatting. | |
61 | <LI>The ability to hook in your own custom message filters. | |
62 | <LI>And other things to numerous to mention here. | |
63 | </UL> | |
64 | ||
65 | ||
66 | <!-- ??????????????????????????????????????????????????????????????? --> | |
67 | <hr noshade size=1> | |
68 | <table border=0> | |
69 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
70 | <h3><b><a name="mhversion">What's the latest version of MhonArc?</a></b></h3> | |
71 | </td></tr></table> | |
72 | ||
73 | <p>Latest version information is available at | |
74 | <a href="http://www.mhonarc.org/" | |
75 | ><http://www.mhonarc.org/></a>. | |
76 | </p> | |
77 | ||
78 | <!-- ??????????????????????????????????????????????????????????????? --> | |
79 | <hr noshade size=1> | |
80 | <table border=0> | |
81 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
82 | <h3><b><a name="get">Where can I get MHonArc?</a></b></h3> | |
83 | </td></tr></table> | |
84 | ||
85 | <P>The latest information on MHonArc, | |
86 | and its availability, may be obtained at | |
87 | <a href="http://www.mhonarc.org/" | |
88 | ><http://www.mhonarc.org/></a>. | |
89 | </P> | |
90 | ||
91 | <p>MHonArc requires Perl to run. If you do not have Perl, it can | |
92 | be obtained from | |
93 | <a href="http://www.perl.com/"><http://www.perl.com/></a>. | |
94 | </p> | |
95 | ||
96 | <!-- ??????????????????????????????????????????????????????????????? --> | |
97 | <hr noshade size=1> | |
98 | <table border=0> | |
99 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
100 | <h3><b><a name="cost">What restrictions are there on MHonArc usage?</a></b></h3> | |
101 | </td></tr></table> | |
102 | ||
103 | <P>MHonArc is free software. MHonArc is distributed under | |
104 | the GNU General Public License (GPL). A copy of the license is included in | |
105 | the distribution. Please read it for more information, or go | |
106 | to <a href="http://www.gnu.org/"><http://www.gnu.org/></a>. | |
107 | Note, that the word <em>"free"</em> means something | |
108 | different than <em>"no cost"</em>. See the GPL and | |
109 | <a href="http://www.gnu.org/"><http://www.gnu.org/></a> for more | |
110 | information. | |
111 | </p> | |
112 | ||
113 | <p>Note, donations are welcome. And will help insure the continued | |
114 | development of MHonArc. | |
115 | </p> | |
116 | ||
117 | <p>If you do not feel comfortable with the current licensing | |
118 | of MHonArc, GPL, then contact the | |
119 | <a href="mailto:mhonarc@mhonarc.org">developer</a> of MHonArc if you | |
120 | want to make alternate licensing arrangements. | |
121 | </p> | |
122 | ||
123 | <table border=0 cellpadding=4> | |
124 | <tr valign=top><td></td><td><hr noshade></td></tr> | |
125 | </tr> | |
126 | <tr valign=top> | |
127 | <td><strong>NOTE</strong></td> | |
128 | <td><p>MHonArc is <strong>NOT</strong> | |
129 | in the public domain. Any mention of MHonArc in the public domain | |
130 | is <strong>WRONG</strong>. Applicable copyrights still apply. | |
131 | </p> | |
132 | </td> | |
133 | </tr> | |
134 | <tr valign=top><td></td><td><hr noshade></td></tr> | |
135 | </table> | |
136 | ||
137 | <!-- ??????????????????????????????????????????????????????????????? --> | |
138 | <hr noshade size=1> | |
139 | <table border=0> | |
140 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
141 | <h3><b><a name="help">Where can I get help on MHonArc?</a></b></h3> | |
142 | </td></tr></table> | |
143 | ||
144 | <P>The first place to try is the documentation that comes with | |
145 | MHonArc. The documentation is quite extensive, and may | |
146 | provide answers to most of your questions. </P> | |
147 | ||
148 | <P>Second, you can read this FAQ. | |
149 | </P> | |
150 | ||
151 | <P>Third, a mailing list, <A | |
152 | HREF="mailto:mhonarc-users@mhonarc.org" | |
153 | >mhonarc-users@mhonarc.org</A>, is available to | |
154 | provide a discussion forum on the usage and development of | |
155 | MHonArc. Appropriate topics for the list include: usage | |
156 | questions, bug reports, behavioral enhancements, documentation bugs, | |
157 | and general help. </P> | |
158 | ||
159 | <P>To subscribe to the mailing list, send mail to <A | |
160 | HREF="mailto:majordomo@mhonarc.org" | |
161 | >majordomo@mhonarc.org</A> | |
162 | with the command, </P> | |
163 | ||
164 | <pre> | |
165 | subscribe mhonarc-users</pre> | |
166 | ||
167 | <P>as the message body. | |
168 | </P> | |
169 | ||
170 | <P>If you send mail | |
171 | <A HREF="mailto:mhonarc-users@mhonarc.org" >mhonarc-users@mhonarc.org</A>, | |
172 | your message will be | |
173 | distributed to all subscribers on the list. </P> | |
174 | ||
175 | <table border=0 cellpadding=4> | |
176 | <tr valign=top> | |
177 | <td><strong>NOTE</strong></td> | |
178 | <td><p>The mailing list is restricted to subscribers only. Any | |
179 | non-subscriber message sent to the list is manually filtered. | |
180 | Due to the nature | |
181 | of manual filtering, non-subscriber messages may have long delays | |
182 | before getting distributed to all subscribers. | |
183 | </p> | |
184 | <p><b>ABSOLUTELY NO SPAM IS TOLERATED</b>. Any spam is happily | |
185 | redirected to /dev/null. | |
186 | </p> | |
187 | </td> | |
188 | </tr> | |
189 | </table> | |
190 | ||
191 | <P>The mailing list is archived by | |
192 | Majordomo. You can also use the WWW to access | |
193 | the archive (with full text search using | |
194 | <a href="http://glimpse.cs.arizona.edu/">Glimpse</a>) at | |
195 | <A HREF="http://www.xray.mpe.mpg.de/mailing-lists/" | |
196 | ><http://www.xray.mpe.mpg.de/mailing-lists/></A>. | |
197 | An alternative web archive of the mailing list is at | |
198 | <A HREF="http://www.mail-archive.com/mhonarc-users@mhonarc.org/" | |
199 | ><http://www.mail-archive.com/mhonarc-users@mhonarc.org/></A>. | |
200 | </P> | |
201 | ||
202 | <!-- ??????????????????????????????????????????????????????????????? --> | |
203 | <hr noshade size=1> | |
204 | <table border=0> | |
205 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
206 | <h3><b><a name="compare">How does MHonArc compare to other email archivers, like Hypermail?</a></b></h3> | |
207 | </td></tr></table> | |
208 | ||
209 | <p><a href="http://www.landfield.com/hypermail/">Hypermail</a> | |
210 | is probably the only other major free program (distributed under the | |
211 | <a href="http://www.gnu.org/">GPL</a>) for archiving | |
212 | e-mail on the Web. There are other free programs available, | |
213 | but Hypermail and MHonArc appear to be the two major programs | |
214 | in use. | |
215 | </p> | |
216 | ||
217 | <p>The best comparison that can be made is by yourself, since the | |
218 | choosing between which tool to use will depend on your needs. | |
219 | The following is a brief list of some of the advantages of MHonArc | |
220 | over Hypermail: | |
221 | </p> | |
222 | ||
223 | <table border=0 cellpadding=4> | |
224 | <tr valign=top> | |
225 | <td><strong>NOTE</strong></td> | |
226 | <td><p>If you notice any errors regarding the information related | |
227 | to Hypermail, please contact the FAQ maintainer. | |
228 | </p> | |
229 | </td> | |
230 | </tr> | |
231 | </table> | |
232 | ||
233 | <ul> | |
234 | <li><p>Support variant mail folders types. Hypermail supports only | |
235 | UUCP-style mailboxes. | |
236 | </p> | |
237 | </li> | |
238 | <li><p>MHonArc has fairly robust MIME support, including the ability to | |
239 | extend the list of media-types supported. | |
240 | Hypermail is supposed to have some | |
241 | some support for MIME, but it still appears to be a work in progress. | |
242 | </p> | |
243 | </li> | |
244 | <li><p>Page customization. MHonArc gives you complete control | |
245 | on how pages are formatted. Hypermail has some page customization | |
246 | features, but not at the level of MHonArc's. With MHonArc, you | |
247 | can create archives with frame navigation or incorporate JavaScript | |
248 | to provided more sophisticated archives. | |
249 | </p> | |
250 | </li> | |
251 | <li><p>Multi-platform support. MHonArc basically runs on any system | |
252 | that Perl runs. Hypermail is only known to run on Unix systems, | |
253 | however, there may be a WinNT port. | |
254 | </p> | |
255 | </li> | |
256 | <li><p>Single message conversion. MHonArc can be used to convert | |
257 | a message to HTML independent of archive processing. Hence, MHonArc can | |
258 | be used as general MIME decoder. | |
259 | </p> | |
260 | </li> | |
261 | </ul> | |
262 | ||
263 | <p>The other major difference is that MHonArc is written in | |
264 | Perl, and Hypermail is written in C. | |
265 | There are pros and cons of both languages. In sum, Perl allows | |
266 | for easier modification, portability, and extensiblility. C | |
267 | provides better execution speed. | |
268 | </p> | |
269 | ||
270 | <p>There are other differences, so consult the documentation of | |
271 | both programs to get a more complete list. Your needs willl | |
272 | ultimately decide which program is best for you. | |
273 | </p> | |
274 | ||
275 | <p>For some time, there | |
276 | was a lack of development on Hypermail. However, there is | |
277 | currently a maintainer. Information about Hypermail can | |
278 | be obtained from | |
279 | <a href="http://www.landfield.com/hypermail/" | |
280 | ><http://www.landfield.com/hypermail/></a>. | |
281 | </p> | |
282 | ||
283 | <!-- ??????????????????????????????????????????????????????????????? --> | |
284 | <hr noshade size=1> | |
285 | <table border=0> | |
286 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
287 | <h3><b><a name="vscommercial">Why I should use MHonArc over some of the Internet-based mailing list archive services?</a></b></h3> | |
288 | </td></tr></table> | |
289 | ||
290 | <p>The exact "why" depends on your needs. Here are some possible reasons | |
291 | why you may want to use MHonArc over Internet-based mailing list | |
292 | archive services: | |
293 | </p> | |
294 | <ul> | |
295 | <li>MHonArc is <a href="#cost">free</a> software. Internet services | |
296 | may charge a fee and/or include commercial | |
297 | advertisements in your list archives. | |
298 | </li> | |
299 | <li>With MHonArc, you have complete control on how your archive looks | |
300 | and feel, and operates. | |
301 | This can be important if you want your archives to follow a specific style, | |
302 | and/or you need the option to be able to change how your archives function | |
303 | over time. | |
304 | </li> | |
305 | <li>You have mailing lists that are behind a firewall. Therefore, | |
306 | an Internet based service is not an option. | |
307 | </li> | |
308 | <li>You just need something for personal use. | |
309 | </li> | |
310 | </ul> | |
311 | ||
312 | <p>Note, there is a nice Internet-based mailing list archive service | |
313 | that is available at no charge, and it uses MHonArc and the | |
314 | <a href="http://www.htdig.org">htDig</a> search engine. See | |
315 | <a href="http://www.mail-archive.com/" | |
316 | ><http://www.mail-archive.com/></a> for more information. | |
317 | </p> | |
318 | ||
319 | <!-- ??????????????????????????????????????????????????????????????? --> | |
320 | <hr noshade size=1> | |
321 | <table border=0> | |
322 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
323 | <h3><b><a name="studies">Are their "real-world" examples of MHonArc usage?</a></b></h3> | |
324 | </td></tr></table> | |
325 | ||
326 | <p>Take your pick: | |
327 | </p> | |
328 | <ul> | |
329 | <li>WWW Mailing List Archives & References:<br> | |
330 | <a href="http://www.xray.mpe.mpg.de/mailing-lists/" | |
331 | ><http://www.xray.mpe.mpg.de/mailing-lists/></a> | |
332 | <li>The Mail Archive:<br> | |
333 | <a href="http://www.mail-archive.com/" | |
334 | ><http://www.mail-archive.com/></a> | |
335 | <li>Mallorn Archived Email Lists:<br> | |
336 | <a href="http://www.mallorn.com/lists/" | |
337 | ><http://www.mallorn.com/lists/></a> | |
338 | <li>Debian Mailing List Archives:<br> | |
339 | <a href="http://lists.debian.org/" | |
340 | ><http://lists.debian.org/></a> | |
341 | <li>FreeLists:<br> | |
342 | <a href="http://www.freelists.org/" | |
343 | ><http://www.freelists.org/></a> | |
344 | <li>Majordomo Users Mailing List Interface:<br> | |
345 | <a href="http://www.hpc.uh.edu/majordomo-users" | |
346 | ><http://www.hpc.uh.edu/majordomo-users></a> | |
347 | <li>Sourceware.cygnus.com Mailing Lists:<br> | |
348 | <a href="http://sourceware.cygnus.com/ml/" | |
349 | ><http://sourceware.cygnus.com/ml/></a> | |
350 | <li>Liblicense-L List Archives:<br> | |
351 | <a href="http://www.library.yale.edu/~llicense/ListArchives/" | |
352 | ><http://www.library.yale.edu/~llicense/ListArchives/></a> | |
353 | <li>FVWM Archives:<br> | |
354 | <a href="http://www.hpc.uh.edu/fvwm/archive/" | |
355 | ><http://www.hpc.uh.edu/fvwm/archive/></a> | |
356 | <li>Lists Archived at Kanga.Nu:<br> | |
357 | <a href="http://www.kanga.nu/archives/" | |
358 | ><http://www.kanga.nu/archives/></a> | |
359 | <li>Apsfilter Archives:<br> | |
360 | <a href="http://www.apsfilter.org/Lists-Archives/" | |
361 | ><http://www.apsfilter.org/Lists-Archives/></a> | |
362 | <li>Giant Java Tree Archives:<br> | |
363 | <a href="http://www.git.org/servlets/MailingLists/ListOfLists.html" | |
364 | ><http://www.git.org/servlets/MailingLists/ListOfLists.html></a> | |
365 | </ul> | |
366 | ||
367 | <!-- ??????????????????????????????????????????????????????????????? --> | |
368 | <hr noshade size=1> | |
369 | <table border=0> | |
370 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
371 | <h3><b><a name="whynonperl">Why are list archives about Perl-related topics not maintained with a Perl-based program, like MHonArc?</a></b></h3> | |
372 | </td></tr></table> | |
373 | ||
374 | <p>The answer is something I would like to know myself. | |
375 | </p> | |
376 | ||
377 | <!-- ??????????????????????????????????????????????????????????????? --> | |
378 | <hr noshade size=1> | |
379 | <table border=0> | |
380 | <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td> | |
381 | <h3><b><a name="y2k">Is MHonArc Y2K (Year 2000) compliant?</a></b></h3> | |
382 | </td></tr></table> | |
383 | ||
384 | <p>There is no known Y2K issues with the current release of MHonArc. | |
385 | Message dates are translated to Unix <b>time(2)</b> format which are | |
386 | currently valid until 2038. If MHonArc is still in use by then, | |
387 | I would be amazed. | |
388 | </p> | |
389 | ||
390 | <p>There has been no official Y2K certification of MHonArc. Since | |
391 | MHonArc is free software, I see noone paying the money for certification. | |
392 | Hence, do not go looking for someone to sue if something breaks. | |
393 | </p> | |
394 | ||
395 | <p>You may want to check | |
396 | <a href="http://language.perl.com/news/y2k.html" | |
397 | ><http://language.perl.com/news/y2k.html></a> about Y2K | |
398 | from a Perl point-of-view. | |
399 | </p> | |
400 | ||
401 | <!-- ===================================================================== --> | |
402 | <hr> | |
403 | ||
404 | <!--X-NavButtons-Start--> | |
405 | <p align=center> | |
406 | [<a href="about.html">Prev</a>][<a href="envs.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/">Home</a>] | |
407 | </p> | |
408 | <!--X-NavButtons-End--> | |
409 | ||
410 | <hr> | |
411 | <address> | |
412 | $Date: 2002/06/21 22:28:16 $ <br> | |
413 | <img align="top" src="monicon.png" alt=""> | |
414 | <a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br> | |
415 | Copyright © 1997-2001, <a href="http://www.mhonarc.org/~ehood/" | |
416 | >Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org" | |
417 | >mhonarc@mhonarc.org</a><br> | |
418 | </address> | |
419 | </body> | |
420 | </html> |