On Wed Mar 02 15:23:28 2011, steffen.winkler@gmx.net wrote:
Show quoted text> Thank you,
>
> the problem was, you have documented subroutines in some helper modue
> and not in the module I should use. Please write what every module
> is for and link to the module I should use. I was really confused
> and my colleague had no idea to help me.
>
> Thank you for the quick answer.
>
> --Steffen
>
The reason for this (which I actually feel is fairly well documented in
the manual) is that the interface for each of the Locale modules
(Locale::Country, Locale::Currency, Locale::Language, and
Locale::Script) are completely identical to each other. In other words,
they ALL have functions:
code2XXX
XXX2code
etc.
If I were to maintain the description separately, I'd be maintaining 4
different copies, identical to each other in all but name.
Rather than do that, I chose to maintain one copy in Locale::Codes.
I may revisit the docs to try to make that clearer, but I'm not going to
switch back to maintaining 4 copies of the docs... too error prone.