Update of mhonarc/MHonArc/doc/resources
Modified Files:
lang.html mimealtprefs.html mimeexcs.html posixstrftime.html
rcfile.html
Log Message:
Doc updates and cleanup.
======================================================================
FILE: mhonarc/MHonArc/doc/resources/lang.html
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/*checkout*/mhonarc/MHonArc/doc/resources/lang.html?rev=1.3>
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/mhonarc/MHonArc/doc/resources/lang.html.diff?r1=1.2&r2=1.3&diff_format=h>
--- lang.html 6 Oct 2003 22:04:17 -0000 1.2
+++ lang.html 7 Jun 2005 19:15:44 -0000 1.3
@@ -66,9 +66,16 @@
</p>
-<li><p>Resource file loading: If a locale is specified, locale
- defined variations will be checked for. See
+<li><p>Resource file loading: Locale-specific resource files
+ will be checked for. See
<a href="rcfile.html#locale">RCFILE</a> for more information.
</p>
+<li><p>POSIX date/time formating: If
+ <a href="posixstrftime.html">POSIXSTRFTIME</a> is enabled,
+ locale-specific formatting will be applied.
+ See your system's <b><tt>strftime()</tt></b> manual page
+ for more information.
+ </p>
+
</ul>
@@ -79,12 +86,25 @@
<p>Where <tt><var>codeset</var></tt></tt> and
<tt><var>country</var></tt> are optional. The <tt><var>language</var></tt>
-and <tt><var>country</var></tt> are usually from the standards
-ISO 3166 and ISO 639, the two-letter abbreviations for the
-countries and the languages of the world, respectively. The
-<tt><var>codeset</var></tt></tt> represents a specific character
-encoding, like ISO8859-1. You will need to consult your local system
-documentation for what locales, and their formats, are supported
-on your system.
-</p>
+and <tt><var>country</var></tt> are short codes
+defined by the standards
+<a href="http://www.wikipedia.org/wiki/ISO_639";>ISO 639</a>
+(language) and
+<a href="http://www.wikipedia.org/wiki/Country_code";>ISO 3166</a>
+(country),
+The <tt><var>codeset</var></tt></tt> represents a specific character
+encoding, like ISO8859-1. You will need to consult your system
+documentation for what locales, and their formats, are supported.
+</p>
+<table class="note" width="100%">
+<tr valign="baseline">
+<td><strong>NOTE:</strong></td>
+<td width="100%"><p>On Unix-based system, the command
+<b><tt>locale</tt></b> may be available to get list of all supported
+locales for you system.
+</p>
+</td>
+</tr>
+</table>
+<p> </p>
<!-- *************************************************************** -->
@@ -107,6 +127,29 @@
<h2><a name="examples">Examples</a></h2>
-<p>None.
-</p>
+<p>LANG gives you the ability to create locale-specific
+archives on a single system. For example, let's say the you
+manage several English-based archives and the default locale for
+your system is <tt>en_US</tt>. However, you would now like to
+host a Japanese-based archive on the same system.
+</p>
+<p>For the Japanese archive, you may want to set LANG as follows:
+</p>
+<pre class="code">
+<b><Lang></b>
+ja_JP
+<b></Lang></b>
+</pre>
+<p>If you plan on using a specific codeset
+(see
+<a href="textencode.html">TEXTENCODE</a> and
+<a href="charsetconverters.html">CHARSETCONVERTERS</a>)
+you should specify the codeset. For example, if the archives will
+be in UTF-8, you should use:
+</p>
+<pre class="code">
+<b><Lang></b>
+ja_JP.utf8
+<b></Lang></b>
+</pre>
<!-- *************************************************************** -->
@@ -122,9 +165,10 @@
<p>
-<a href="rcfile.html">RCFILE</a>,
+<a href="charsetconverters.html">CHARSETCONVERTERS</a>,
+<a href="rcfile.html#locale">RCFILE</a>,
<a href="textencode.html">TEXTENCODE</a>
</p>
<p>
-<a href="http://www.perldoc.com/perl5.8.0/pod/perllocale.html";>perllocale</a>
+<a href="http://perldoc.perl.org/perllocale.html";>perllocale</a>
manual page.
</p>
@@ -141,5 +185,5 @@
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/";><strong>MHonArc</strong></a><br>
-Copyright © 2003, <a href="http://www.earlhood.com/";
+Copyright © 2003,2005 <a href="http://www.earlhood.com/";
>Earl Hood</a>, <a href="mailto:mhonarc%40mhonarc.org";
>mhonarc<!--
======================================================================
FILE: mhonarc/MHonArc/doc/resources/mimealtprefs.html
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/*checkout*/mhonarc/MHonArc/doc/resources/mimealtprefs.html?rev=1.9>
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/mhonarc/MHonArc/doc/resources/mimealtprefs.html.diff?r1=1.8&r2=1.9&diff_format=h>
--- mimealtprefs.html 13 May 2005 18:50:38 -0000 1.8
+++ mimealtprefs.html 7 Jun 2005 19:15:44 -0000 1.9
@@ -84,5 +84,5 @@
the <tt>text/html</tt> part with the following setting:
</p>
-<pre>
+<pre class="code">
<b><MIMEAltPrefs></b>
text/plain
@@ -106,5 +106,5 @@
<p>and we are using the MIMEALTPREFS setting,
</p>
-<pre>
+<pre class="code">
<b><MIMEAltPrefs></b>
text/plain
@@ -124,5 +124,5 @@
MIMEALTPREFS setting would be needed,
</p>
-<pre>
+<pre class="code">
<b><MIMEAltPrefs></b>
text/plain
@@ -147,4 +147,6 @@
</tr>
</table>
+<p>
+</p>
<!-- *************************************************************** -->
@@ -181,5 +183,7 @@
<p>
-<a href="mimeexcs.html">MIMEEXCS</a>
+<a href="mimeexcs.html">MIMEEXCS</a>,
+<a href="mimefilters.html">MIMEFILTERS</a>,
+<a href="mimeincs.html">MIMEINCS</a>
</p>
======================================================================
FILE: mhonarc/MHonArc/doc/resources/mimeexcs.html
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/*checkout*/mhonarc/MHonArc/doc/resources/mimeexcs.html?rev=1.16>
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/mhonarc/MHonArc/doc/resources/mimeexcs.html.diff?r1=1.15&r2=1.16&diff_format=h>
--- mimeexcs.html 2 Jun 2005 05:50:25 -0000 1.15
+++ mimeexcs.html 7 Jun 2005 19:15:44 -0000 1.16
@@ -58,18 +58,32 @@
The exclusion occurs before the data is processed to any filters
registered via the <a href="mimefilters.html">MIMEFILTERS</a> resource.
-If a message body part is excluded, the converted message will have
-a note that the part was excluded.
</p>
-<table class="note" width="100%">
-<tr valign="baseline">
-<td><strong>NOTE:</strong></td>
-<td width="100%"><p>Base types can also be listed in order exclude all
+<p>For example, if MIMEEXCS is set to the following:
+</p>
+<pre class="code">
+<b><MIMEExcs></b>
+image/jpg
+image/gif
+<b></MIMEExcs></b>
+</pre>
+<p>Then JPEG and GIF images will be excluded.
+</p>
+
+<p>Base types can be listed in order exclude all
content-types
-with a give base. For example, <tt>image/jpg</tt> will only exclude
-JPEG images, but <tt>image</tt> will exclude all images.
+with a give base. For example,
+</p>
+<pre class="code">
+<b><MIMEExcs></b>
+image
+<b></MIMEExcs></b>
+</pre>
+<p>will exclude all images.
+</p>
+
+<p>If all you want to do is include a specified set of media-types, then
+use the
+<a href="mimeincs.html">MIMEINCS</a> resource instead.
</p>
-</td>
-</tr>
-</table>
<!-- *************************************************************** -->
======================================================================
FILE: mhonarc/MHonArc/doc/resources/posixstrftime.html
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/*checkout*/mhonarc/MHonArc/doc/resources/posixstrftime.html?rev=1.14>
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/mhonarc/MHonArc/doc/resources/posixstrftime.html.diff?r1=1.13&r2=1.14&diff_format=h>
--- posixstrftime.html 6 Oct 2003 22:04:20 -0000 1.13
+++ posixstrftime.html 7 Jun 2005 19:15:44 -0000 1.14
@@ -67,6 +67,7 @@
<a href="weekdaysabr.html">WEEKDAYSABR</a> will have no
effect. Month names and weekday names will be determined
-by your systems locale. See your system's manual page on
-<b><tt>strftime()</tt></b> for more information.
+by your <a href="lang.html">systems locale</a>.
+See your system's manual page on <b><tt>strftime()</tt></b> for more
+information.
</p>
@@ -111,4 +112,5 @@
<p>
<a href="gmtdatefmt.html">GMTDATEFMT</a>,
+<a href="lang.html">LANG</a>,
<a href="localdatefmt.html">LOCALDATEFMT</a>,
<a href="msggmtdatefmt.html">MSGGMTDATEFMT</a>,
======================================================================
FILE: mhonarc/MHonArc/doc/resources/rcfile.html
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/*checkout*/mhonarc/MHonArc/doc/resources/rcfile.html?rev=1.18>
<http://www.mhonarc.org/cgi-bin/viewcvs.cgi/mhonarc/MHonArc/doc/resources/rcfile.html.diff?r1=1.17&r2=1.18&diff_format=h>
--- rcfile.html 13 May 2005 00:00:36 -0000 1.17
+++ rcfile.html 7 Jun 2005 19:15:44 -0000 1.18
@@ -344,4 +344,9 @@
<h2><a name="examples">Examples</a></h2>
+<p>The following illustrates what a resource file looks like.
+For more examples of resource files, see
+<a href="../app-rcfileexs.html"><cite>Appendix: Resource File Examples</cite></a>.
+</p>
+
<PRE class="code">
<!-- MHonArc resource file
@@ -495,8 +500,4 @@
<b></ICONS></b>
</PRE>
-
-<p>More examples are available under
-<a href="../app-rcfileexs.html"><cite>Appendix: Resource File Examples</cite></a>.
-</p>
<!-- *************************************************************** -->
---------------------------------------------------------------------
To sign-off this list, send email to majordomo(_at_)mhonarc(_dot_)org with the
message text UNSUBSCRIBE MHONARC-COMMITS