Move intl-java/javadoc1/gnu.gettext.GettextResource.html to gettext-runtime/intl-java/javadoc1/gnu.gettext.GettextResource.html.

author: Bruno Haible <bruno@clisp.org> 2003-02-13 20:25:11 +0000
committer: Bruno Haible <bruno@clisp.org> 2009-06-23 12:09:02 +0200
commit: 617f3b73daed7d45b19c84e7839b589182d7e67c (patch)
tree: 172f163b3a51391b1e0119144e96d6d50738158c /gettext-runtime/intl-java
parent: e50928db70498a81bdecc885dc12ef0cdfb5438d (diff)
download: external_gettext-617f3b73daed7d45b19c84e7839b589182d7e67c.zip
external_gettext-617f3b73daed7d45b19c84e7839b589182d7e67c.tar.gz
external_gettext-617f3b73daed7d45b19c84e7839b589182d7e67c.tar.bz2
1 files changed, 163 insertions, 0 deletions
diff --git a/gettext-runtime/intl-java/javadoc1/gnu.gettext.GettextResource.html b/gettext-runtime/intl-java/javadoc1/gnu.gettext.GettextResource.html
new file mode 100644
index 0000000..8e821c3
--- /dev/null
+++ b/gettext-runtime/intl-java/javadoc1/gnu.gettext.GettextResource.html
@@ -0,0 +1,163 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<!--NewPage-->
+<html>
+<head>
+<!-- Generated by javadoc on Sat Nov 03 18:12:01 CET 2001 -->
+<title>
+  Class gnu.gettext.GettextResource
+</title>
+</head>
+<body>
+<a name="_top_"></a>
+<pre>
+<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-gnu.gettext.html">This Package</a>  <a href="Package-gnu.gettext.html">Previous</a>  <a href="Package-gnu.gettext.html">Next</a>  <a href="AllNames.html">Index</a></pre>
+<hr>
+<h1>
+  Class gnu.gettext.GettextResource
+</h1>
+<pre>
+java.lang.Object
+   |
+   +----java.util.ResourceBundle
+           |
+           +----gnu.gettext.GettextResource
+</pre>
+<hr>
+<dl>
+  <dt> public abstract class <b>GettextResource</b>
+  <dt> extends ResourceBundle
+</dl>
+This class implements the main GNU libintl functions in Java.
+ <P>
+ Using the GNU gettext approach, compiled message catalogs are normal
+ Java ResourceBundle classes and are thus interoperable with standard
+ ResourceBundle based code.
+ <P>
+ The main differences between the Sun ResourceBundle approach and the
+ GNU gettext approach are:
+ <UL>
+   <LI>In the Sun approach, the keys are abstract textual shortcuts.
+       In the GNU gettext approach, the keys are the English/ASCII version
+       of the messages.
+   <LI>In the Sun approach, the translation files are called
+       "<VAR>Resource</VAR>_<VAR>locale</VAR>.properties" and have non-ASCII
+       characters encoded in the Java
+       <CODE>\</CODE><CODE>u<VAR>nnnn</VAR></CODE> syntax. Very few editors
+       can natively display international characters in this format. In the
+       GNU gettext approach, the translation files are called
+       "<VAR>Resource</VAR>.<VAR>locale</VAR>.po"
+       and are in the encoding the translator has chosen. Many editors
+       can be used. There are at least three GUI translating tools
+       (Emacs PO mode, KDE KBabel, GNOME gtranslator).
+   <LI>In the Sun approach, the function
+       <CODE>ResourceBundle.getString</CODE> throws a
+       <CODE>MissingResourceException</CODE> when no translation is found.
+       In the GNU gettext approach, the <CODE>gettext</CODE> function
+       returns the (English) message key in that case.
+   <LI>In the Sun approach, there is no support for plural handling.
+       Even the most elaborate MessageFormat strings cannot provide decent
+       plural handling. In the GNU gettext approach, we have the
+       <CODE>ngettext</CODE> function.
+ </UL>
+ <P>
+ To compile GNU gettext message catalogs into Java ResourceBundle classes,
+ the <CODE>msgfmt</CODE> program can be used.
+<p>
+<hr>
+<a name="index"></a>
+<h2>
+  <img src="images/variable-index.gif" width=207 height=38 alt="Variable Index">
+</h2>
+<dl>
+  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
+	<a href="#verbose"><b>verbose</b></a>
+  <dd> 
+</dl>
+<h2>
+  <img src="images/constructor-index.gif" width=275 height=38 alt="Constructor Index">
+</h2>
+<dl>
+  <dt> <img src="images/yellow-ball-small.gif" width=6 height=6 alt=" o ">
+	<a href="#GettextResource()"><b>GettextResource</b></a>()
+  <dd> 
+</dl>
+<h2>
+  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
+</h2>
+<dl>
+  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
+	<a href="#gettext(java.util.ResourceBundle, java.lang.String)"><b>gettext</b></a>(ResourceBundle, String)
+  <dd>  Returns the translation of <VAR>msgid</VAR>.
+  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
+	<a href="#ngettext(java.util.ResourceBundle, java.lang.String, java.lang.String, long)"><b>ngettext</b></a>(ResourceBundle, String, String, long)
+  <dd>  Returns the plural form for <VAR>n</VAR> of the translation of
+ <VAR>msgid</VAR>.
+</dl>
+<a name="variables"></a>
+<h2>
+  <img src="images/variables.gif" width=153 height=38 alt="Variables">
+</h2>
+<a name="verbose"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
+<b>verbose</b>
+<pre>
+ public static boolean verbose
+</pre>
+<a name="constructors"></a>
+<h2>
+  <img src="images/constructors.gif" width=231 height=38 alt="Constructors">
+</h2>
+<a name="GettextResource"></a>
+<a name="GettextResource()"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
+<b>GettextResource</b>
+<pre>
+ public GettextResource()
+</pre>
+<a name="methods"></a>
+<h2>
+  <img src="images/methods.gif" width=151 height=38 alt="Methods">
+</h2>
+<a name="gettext(java.util.ResourceBundle, java.lang.String)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
+<a name="gettext"><b>gettext</b></a>
+<pre>
+ public static String gettext(ResourceBundle catalog,
+                              String msgid)
+</pre>
+<dl>
+  <dd> Returns the translation of <VAR>msgid</VAR>.
+<p>
+  <dd><dl>
+    <dt> <b>Parameters:</b>
+    <dd> catalog - a ResourceBundle
+    <dd> msgid - the key string to be translated, an ASCII string
+    <dt> <b>Returns:</b>
+    <dd> the translation of <VAR>msgid</VAR>, or <VAR>msgid</VAR> if
+         none is found
+  </dl></dd>
+</dl>
+<a name="ngettext(java.util.ResourceBundle, java.lang.String, java.lang.String, long)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
+<a name="ngettext"><b>ngettext</b></a>
+<pre>
+ public static String ngettext(ResourceBundle catalog,
+                               String msgid,
+                               String msgid_plural,
+                               long n)
+</pre>
+<dl>
+  <dd> Returns the plural form for <VAR>n</VAR> of the translation of
+ <VAR>msgid</VAR>.
+<p>
+  <dd><dl>
+    <dt> <b>Parameters:</b>
+    <dd> catalog - a ResourceBundle
+    <dd> msgid - the key string to be translated, an ASCII string
+    <dd> msgid_plural - its English plural form
+    <dt> <b>Returns:</b>
+    <dd> the translation of <VAR>msgid</VAR> depending on <VAR>n</VAR>,
+         or <VAR>msgid</VAR> or <VAR>msgid_plural</VAR> if none is found
+  </dl></dd>
+</dl>
+<hr>
+<pre>
+<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-gnu.gettext.html">This Package</a>  <a href="Package-gnu.gettext.html">Previous</a>  <a href="Package-gnu.gettext.html">Next</a>  <a href="AllNames.html">Index</a></pre>
+</body>
+</html>
author	Bruno Haible <bruno@clisp.org>	2003-02-13 20:25:11 +0000
committer	Bruno Haible <bruno@clisp.org>	2009-06-23 12:09:02 +0200
commit	617f3b73daed7d45b19c84e7839b589182d7e67c (patch)
tree	172f163b3a51391b1e0119144e96d6d50738158c /gettext-runtime/intl-java
parent	e50928db70498a81bdecc885dc12ef0cdfb5438d (diff)
download	external_gettext-617f3b73daed7d45b19c84e7839b589182d7e67c.zip external_gettext-617f3b73daed7d45b19c84e7839b589182d7e67c.tar.gz external_gettext-617f3b73daed7d45b19c84e7839b589182d7e67c.tar.bz2