summaryrefslogtreecommitdiffstats
path: root/gettext-tools/doc
diff options
context:
space:
mode:
authorBruno Haible <bruno@clisp.org>2007-09-02 09:55:09 +0000
committerBruno Haible <bruno@clisp.org>2009-06-23 12:15:03 +0200
commitf6d16458876e8eb80246e72d0ee52404a98a458d (patch)
tree9e45231b036dbfc5e20fbd1df48ce4b13909f3d4 /gettext-tools/doc
parentbfbde1ec10ba13752314a2d8157d6b1fb0d434e0 (diff)
downloadexternal_gettext-f6d16458876e8eb80246e72d0ee52404a98a458d.zip
external_gettext-f6d16458876e8eb80246e72d0ee52404a98a458d.tar.gz
external_gettext-f6d16458876e8eb80246e72d0ee52404a98a458d.tar.bz2
Implement msgctxt for C# ResourceManagers.
Diffstat (limited to 'gettext-tools/doc')
-rw-r--r--gettext-tools/doc/ChangeLog7
-rw-r--r--gettext-tools/doc/gettext.texi17
-rw-r--r--gettext-tools/doc/xgettext.texi3
3 files changed, 26 insertions, 1 deletions
diff --git a/gettext-tools/doc/ChangeLog b/gettext-tools/doc/ChangeLog
index f85e74a..82d6e0b 100644
--- a/gettext-tools/doc/ChangeLog
+++ b/gettext-tools/doc/ChangeLog
@@ -1,3 +1,10 @@
+2007-09-02 Bruno Haible <bruno@clisp.org>
+
+ Implement msgctxt for C# ResourceManagers.
+ * gettext.texi (Java): Mention GetParticularString and
+ GetParticularPluralString.
+ * xgettext.texi (--keyword): Update defaults for C#.
+
2007-09-01 Bruno Haible <bruno@clisp.org>
Implement msgctxt for Java ResourceBundles.
diff --git a/gettext-tools/doc/gettext.texi b/gettext-tools/doc/gettext.texi
index 7b3c63c..f4e66e4 100644
--- a/gettext-tools/doc/gettext.texi
+++ b/gettext-tools/doc/gettext.texi
@@ -9848,6 +9848,8 @@ _("abc")
@item gettext/ngettext functions
@code{GettextResourceManager.GetString},
@code{GettextResourceManager.GetPluralString}
+@code{GettextResourceManager.GetParticularString}
+@code{GettextResourceManager.GetParticularPluralString}
@item textdomain
@code{new GettextResourceManager(domain)}
@@ -9950,6 +9952,12 @@ handling function @code{GetPluralString}. Whereas @code{.resources} files can
only contain data and only support lookups that depend on a single string.
@item
+Context handling: A message catalog in @code{.dll} format supports the
+query-with-context functions @code{GetParticularString} and
+@code{GetParticularPluralString}. Whereas @code{.resources} files can
+only contain data and only support lookups that depend on a single string.
+
+@item
The @code{GettextResourceManager} that loads the message catalogs in
@code{.dll} format also provides for inheritance on a per-message basis.
For example, in Austrian (@code{de_AT}) locale, translations from the German
@@ -10008,6 +10016,15 @@ a translation is missing, the @var{msgid} argument is returned unchanged.
The @code{GetPluralString} function returns a string translation with plural
handling, like the @code{ngettext} function in C.
+The @code{GetParticularString} function returns a string's translation,
+specific to a particular context, like the @code{pgettext} function in C.
+Note that when a translation is missing, the @var{msgid} argument is returned
+unchanged.
+
+The @code{GetParticularPluralString} function returns a string translation,
+specific to a particular context, with plural handling, like the
+@code{npgettext} function in C.
+
@cindex @code{libintl} for C#
To use this API, one needs the @code{GNU.Gettext.dll} file which is part of
the GNU gettext package and distributed under the LGPL.
diff --git a/gettext-tools/doc/xgettext.texi b/gettext-tools/doc/xgettext.texi
index 2be773b..4ed5fba 100644
--- a/gettext-tools/doc/xgettext.texi
+++ b/gettext-tools/doc/xgettext.texi
@@ -223,7 +223,8 @@ For Java: @code{GettextResource.gettext:2},
@code{pgettext:1c,2}, @code{npgettext:1c,2,3}, @code{getString}.
@item
-For C#: @code{GetString}, @code{GetPluralString:1,2}.
+For C#: @code{GetString}, @code{GetPluralString:1,2},
+@code{GetParticularString:1c,2}, @code{GetParticularPluralString:1c,2,3}.
@item
For awk: @code{dcgettext}, @code{dcngettext:1,2}.