diff options
| author | Kevin B Kenny <kennykb@acm.org> | 2003-10-21 00:23:33 (GMT) |
|---|---|---|
| committer | Kevin B Kenny <kennykb@acm.org> | 2003-10-21 00:23:33 (GMT) |
| commit | 069e6b39be18f68043fb7389188c1e8d2a6afb06 (patch) | |
| tree | 2ed74cd43101586ffe55de9721f1354589548214 /doc/msgcat.n | |
| parent | 7c7a39a26c9bd772bf26ae6fd1be320d392d10db (diff) | |
| download | tcl-069e6b39be18f68043fb7389188c1e8d2a6afb06.zip tcl-069e6b39be18f68043fb7389188c1e8d2a6afb06.tar.gz tcl-069e6b39be18f68043fb7389188c1e8d2a6afb06.tar.bz2 | |
TIP #156: Language-Neutral Root Locale for Msgcat
Diffstat (limited to 'doc/msgcat.n')
| -rw-r--r-- | doc/msgcat.n | 25 |
1 files changed, 18 insertions, 7 deletions
diff --git a/doc/msgcat.n b/doc/msgcat.n index 1c11f17..264af9b 100644 --- a/doc/msgcat.n +++ b/doc/msgcat.n @@ -7,7 +7,7 @@ '\" SCCS: @(#) msgcat.n '\" .so man.macros -.TH "msgcat" n 1.3 msgcat "Tcl Bundled Packages" +.TH "msgcat" n 1.4 msgcat "Tcl Bundled Packages" .BS '\" Note: do not modify the .SH NAME line immediately below! .SH NAME @@ -15,7 +15,7 @@ msgcat \- Tcl message catalog .SH SYNOPSIS \fBpackage require Tcl 8.2\fR .sp -\fBpackage require msgcat 1.3\fR +\fBpackage require msgcat 1.4\fR .sp \fB::msgcat::mc \fIsrc-string\fR ?\fIarg arg ...\fR? .sp @@ -94,7 +94,9 @@ preference. The list is derived from the current locale set in msgcat by \fBmsgcat::mclocale\fR, and cannot be set independently. For example, if the current locale is en_US_funky, then \fBmsgcat::mcpreferences\fR -returns {en_US_funky en_US en}. +.VS 1.4 +returns \fB{en_US_funky en_US en {}}\fR. +.VE .TP \fB::msgcat::mcload \fIdirname\fR Searches the specified directory for files that match @@ -167,10 +169,13 @@ locale of ``C''. .PP When a locale is specified by the user, a ``best match'' search is performed during string translation. For example, if a user specifies -en_GB_Funky, the locales ``en_GB_Funky'', ``en_GB'', and ``en'' are -searched in order until a matching translation string is found. If no -translation string is available, then \fB::msgcat::unknown\fR is -called. +.VS 1.4 +en_GB_Funky, the locales ``en_GB_Funky'', ``en_GB'', ``en'' and ``'' +(the empty string) +.VE +are searched in order until a matching translation +string is found. If no translation string is available, then +\fB::msgcat::unknown\fR is called. .SH "NAMESPACES AND MESSAGE CATALOGS" .PP @@ -236,6 +241,12 @@ followed by ``.msg''. For example: es.msg -- spanish en_gb.msg -- United Kingdom English .CE +.VS +\fIException:\fR The message file for the root locale ``'' is +called \fBROOT.msg\fR. This exception is made so as not to +cause peculiar behavior, such as marking the message file as +``hidden'' on Unix file systems. +.VE .IP [3] The file contains a series of calls to \fBmcset\fR and \fBmcmset\fR, setting the necessary translation strings |