<html>
<head>
<title>MHonArc Resources: LANG</title>
<link rel="stylesheet" type="text/css" href="../docstyles.css">
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev: <a href="labelstyles.html">LABELSTYLES</a>]</td><td><nobr>[<a href="../resources.html#lang">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="lastpglink.html">LASTPGLINK</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>LANG</h1>
<!--X-TOC-Start-->
<ul>
<li><a href="#syntax">Syntax</a>
<li><a href="#description">Description</a>
<li><a href="#default">Default Setting</a>
<li><a href="#rcvars">Resource Variables</a>
<li><a href="#examples">Examples</a>
<li><a href="#version">Version</a>
<li><a href="#seealso">See Also</a>
</ul>
<!--X-TOC-End-->
<!-- *************************************************************** -->
<hr>
<h2><a name="syntax">Syntax</a></h2>
<dl>
<dt><strong>Envariable</strong></dt>
<dd><p>
<code>M2H_LANG=</code><var>locale</var>
</p>
</dd>
<dt><strong>Element</strong></dt>
<dd><p>
<code><LANG></code><br>
<var>locale</var><br>
<code></LANG></code><br>
</p>
</dd>
<dt><strong>Command-line Option</strong></dt>
<dd><p>
<code>-lang </code><var>locale</var>
</p>
</dd>
</dl>
<!-- *************************************************************** -->
<hr>
<h2><a name="description">Description</a></h2>
<p>LANG sets the locale. Setting the locale affects the following
MHonArc operations:
</p>
<ul>
<li><p>Message sorting: Locale properties for string collation are
applied when sorting messages by subject or author.
</p>
<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>
<p>The basic format for specifying a locale is:
</p>
<pre><var>language</var>_<var>country</var>.<var>codeset</var>
</pre>
<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 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>
<!-- *************************************************************** -->
<hr>
<h2><a name="default">Default Setting</a></h2>
<p>The value of the <tt>LC_ALL</tt> or <tt>LANG</tt> environment
variables.
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="rcvars">Resource Variables</a></h2>
<p>N/A
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="examples">Examples</a></h2>
<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>
<!-- *************************************************************** -->
<hr>
<h2><a name="version">Version</a></h2>
<p>2.6.7
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="seealso">See Also</a></h2>
<p>
<a href="charsetconverters.html">CHARSETCONVERTERS</a>,
<a href="rcfile.html#locale">RCFILE</a>,
<a href="textencode.html">TEXTENCODE</a>
</p>
<p>
<a href="http://perldoc.perl.org/perllocale.html">perllocale</a>
manual page.
</p>
<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev: <a href="labelstyles.html">LABELSTYLES</a>]</td><td><nobr>[<a href="../resources.html#lang">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="lastpglink.html">LASTPGLINK</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2005/06/07 19:15:44 $<br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
Copyright © 2003,2005 <a href="http://www.earlhood.com/"
>Earl Hood</a>, <a href="mailto:mhonarc%40mhonarc.org"
>mhonarc<!--
-->@<!--
-->mhonarc.org</a><br>
</address>
</body>
</html>