[Bug 5685] New: lang vs. locales on Mail::SpamAssassin::Conf(3pm)

[bu...@bugzilla.spamassassin.org]

http://issues.apache.org/SpamAssassin/show_bug.cgi?id=5685

           Summary: lang vs. locales on  Mail::SpamAssassin::Conf(3pm)
           Product: Spamassassin
           Version: 3.2.3
          Platform: Other
        OS/Version: other
            Status: NEW
          Severity: trivial
          Priority: P5
         Component: Documentation
        AssignedTo: dev@spamassassin.apache.org
        ReportedBy: jidanni@jidanni.org


On Mail::SpamAssassin::Conf(3pm) one sees way at the bottom:
       The locales string should specify either both the language and country,
e.g.         
       "lang pt_BR", or just the language, e.g. "lang de".
Well, if you are talking about ok_locales, then you had better mention it not so
late in the page.
If you are talking about the lang string instead, then say lang instead of locales.



------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.

[Bug 5685] lang vs. locales on Mail::SpamAssassin::Conf(3pm)

[bu...@bugzilla.spamassassin.org]

http://issues.apache.org/SpamAssassin/show_bug.cgi?id=5685





------- Additional Comments From mkettler_sa@verizon.net  2007-10-14 19:55 -------
It is clearly not talking about ok_locales, or anything vaguely related to that
option.

It's talking about using the "lang" config option to localize the reports that
SA generates into your choice of language.

It's even in a section titled "LOCALI[SZ]ATION"...


---------------------------
LOCALI[SZ]ATION

A line starting with the text lang xx will only be interpreted if the user is in
that locale, allowing test descriptions and templates to be set for that language.

The locales string should specify either both the language and country, e.g.
lang pt_BR, or just the language, e.g. lang de.
---------------------------

However, this is a good spot to point out that the "lang" config option is not
documented in the same format as other config options. All other options start
off with the option name on a line by itself, followed by a description..

I'd offer to reformat it, but the existing description is confusing even to me.
Particularly the ".. will only be interpreted if the user is in that locale"
part.. What exactly does that mean?






------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.

[Bug 5685] lang vs. locales on Mail::SpamAssassin::Conf(3pm)

[bu...@bugzilla.spamassassin.org]

http://issues.apache.org/SpamAssassin/show_bug.cgi?id=5685





------- Additional Comments From jm@jmason.org  2007-10-15 03:59 -------
(In reply to comment #1)
> I'd offer to reformat it, but the existing description is confusing even to me.
> Particularly the ".. will only be interpreted if the user is in that locale"
> part.. What exactly does that mean?

that's if the env vars $LC_ALL, $LANG, etc. are set to indicate that locale.



------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.