+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.
@item gettext/ngettext functions
@code{GettextResourceManager.GetString},
@code{GettextResourceManager.GetPluralString}
+@code{GettextResourceManager.GetParticularString}
+@code{GettextResourceManager.GetParticularPluralString}
@item textdomain
@code{new GettextResourceManager(domain)}
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.
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.
@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}.