sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1391942 - in /sis/trunk: sis-utility/src/main/java/org/apache/sis/util/resources/ sis-utility/src/main/java/org/apache/sis/util/type/ src/main/docbook/fr/ src/site/resources/book/
Date Sun, 30 Sep 2012 03:08:51 GMT
Author: desruisseaux
Date: Sun Sep 30 03:08:50 2012
New Revision: 1391942

URL: http://svn.apache.org/viewvc?rev=1391942&view=rev
Log:
Documentation updates:
  - link between org.apache.sis.util.resources and ResourceInternationalString
  - adjustment about SIS branches versus geoapi or geoapi-pending.

Modified:
    sis/trunk/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java
    sis/trunk/sis-utility/src/main/java/org/apache/sis/util/type/ResourceInternationalString.java
    sis/trunk/src/main/docbook/fr/geoapi.xml
    sis/trunk/src/site/resources/book/book.css

Modified: sis/trunk/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java
URL: http://svn.apache.org/viewvc/sis/trunk/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java?rev=1391942&r1=1391941&r2=1391942&view=diff
==============================================================================
--- sis/trunk/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java (original)
+++ sis/trunk/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java Sun
Sep 30 03:08:50 2012
@@ -48,9 +48,17 @@
  *     String text = TheBundle.getResources(locale).getString(key, optionalArguments);
  * }
  *
- * For convenience, all {@code IndexedResourceBundle} subclass provide also various
- * {@code format(int, …)} static methods for fetching localized texts in the
- * {@linkplain java.util.Locale#getDefault() system default locale}.
+ * For convenience, all {@code IndexedResourceBundle} subclasses provide also various
+ * {@code format(int, …)} and {@code formatInternational(int, …)} static methods
for
+ * fetching localized texts in the {@linkplain java.util.Locale#getDefault() system
+ * default locale}, or localizable texts:
+ *
+ * {@preformat java
+ *     InternationalString i18n = TheBundle.formatInternational(key, optionalArguments);
+ *     String text = i18n.toString(locale); // Equivalent to the above example.
+ *
+ *     text = TheBundle.format(key, optionalArguments); // Uses the default locale.
+ * }
  *
  * @author  Martin Desruisseaux (Geomatys)
  * @since   0.3 (derived from geotk-1.2)
@@ -59,5 +67,6 @@
  *
  * @see java.util.ResourceBundle
  * @see java.text.MessageFormat
+ * @see org.apache.sis.util.type.ResourceInternationalString
  */
 package org.apache.sis.util.resources;

Modified: sis/trunk/sis-utility/src/main/java/org/apache/sis/util/type/ResourceInternationalString.java
URL: http://svn.apache.org/viewvc/sis/trunk/sis-utility/src/main/java/org/apache/sis/util/type/ResourceInternationalString.java?rev=1391942&r1=1391941&r2=1391942&view=diff
==============================================================================
--- sis/trunk/sis-utility/src/main/java/org/apache/sis/util/type/ResourceInternationalString.java
(original)
+++ sis/trunk/sis-utility/src/main/java/org/apache/sis/util/type/ResourceInternationalString.java
Sun Sep 30 03:08:50 2012
@@ -54,6 +54,13 @@ import org.apache.sis.internal.Objects;
  * for Italian, <i>etc</i>.
  * If needed, users can gain more control by overriding the {@link #getBundle(Locale)} method.
  *
+ * {@section Apache SIS resources}
+ * Apache SIS has its own resources mechanism, built on top of the standard {@code ResourceBundle}
+ * with the addition of type safety and optional arguments to be formatted in the localized
string.
+ * Those resource bundles provide {@code formatInternational(int, …)} static methods
for creating
+ * international strings with the same functionality than this {@code ResourceInternationalString}.
+ * See {@link org.apache.sis.util.resources} for more information.
+ *
  * @author  Martin Desruisseaux (IRD, Geomatys)
  * @author  Johann Sorel (Geomatys)
  * @since   0.3 (derived from geotk-2.1)

Modified: sis/trunk/src/main/docbook/fr/geoapi.xml
URL: http://svn.apache.org/viewvc/sis/trunk/src/main/docbook/fr/geoapi.xml?rev=1391942&r1=1391941&r2=1391942&view=diff
==============================================================================
--- sis/trunk/src/main/docbook/fr/geoapi.xml (original)
+++ sis/trunk/src/main/docbook/fr/geoapi.xml Sun Sep 30 03:08:50 2012
@@ -495,8 +495,8 @@ assert MediumName.valueOf("USB_KEY") == 
     mutuellement exclusives, les utilisateurs doivent veiller à ne pas les mélanger
dans un même projet.
     Cette séparation est garantie pour tous les projets qui ne dépendent que du dépôt
central de Maven
     (incluant les versions finales de Apache SIS), car le module <literal role="GeoAPI">geoapi-pending</literal>
-    n’est jamais déployé sur ce dépôt central. En revanche les <foreignphrase>snapshot</foreignphrase>
et les
-    <foreignphrase>milestones</foreignphrase> peuvent dépendre de <literal
role="GeoAPI">geoapi-pending</literal>.
+    n’est jamais déployé sur ce dépôt central. En revanche les <foreignphrase>snapshot</foreignphrase>
+    de certaines branches de SIS peuvent dépendre de <literal role="GeoAPI">geoapi-pending</literal>.
   </para>
   <para>
     Les modules de GeoAPI sont:
@@ -514,16 +514,17 @@ assert MediumName.valueOf("USB_KEY") == 
       <acronym>OGC</acronym>. Certains ajouts apparaissent dans des interfaces
normalement définies
       par le module <literal role="GeoAPI">geoapi</literal>, d’où la
nécessité de les copier.
     </para><para>
-      Les versions <foreignphrase>snapshot</foreignphrase> de Apache SIS dépendent
de ce module.
+      Les versions <foreignphrase>snapshot</foreignphrase> des branches <literal>jdk6</literal>,
+      <literal>jdk7</literal> et <literal>jdk8</literal> de Apache
SIS dépendent de ce module.
       Mais cette dépendance est transformée en une dépendance vers le module <literal
role="GeoAPI">geoapi</literal>
-      standard au moment de publier les versions finales.
+      standard au moment de fusionner les branches avec le tronc.
     </para></listitem>
     <listitem><para>
       <emphasis role="bold"><literal role="GeoAPI">geoapi-conformance</literal></emphasis> — contient
       une suite de tests JUnit que les développeurs peuvent utiliser pour tester leurs
implémentations.
-      Tout comme pour le projet Apache SIS, les versions <foreignphrase>snapshot</foreignphrase>
et les
-      <foreignphrase>milestones</foreignphrase> dépendent du module <literal
role="GeoAPI">geoapi-pending</literal>
-      alors que les versions finales dépendent de <literal role="GeoAPI">geoapi</literal>.
+      Les versions <foreignphrase>snapshot</foreignphrase> et les <foreignphrase>milestones</foreignphrase>
+      dépendent du module <literal role="GeoAPI">geoapi-pending</literal>
alors que les versions finales
+      dépendent de <literal role="GeoAPI">geoapi</literal>.
     </para></listitem>
     <listitem><para>
       <emphasis role="bold"><literal role="GeoAPI">geoapi-examples</literal></emphasis> — contient
des

Modified: sis/trunk/src/site/resources/book/book.css
URL: http://svn.apache.org/viewvc/sis/trunk/src/site/resources/book/book.css?rev=1391942&r1=1391941&r2=1391942&view=diff
==============================================================================
--- sis/trunk/src/site/resources/book/book.css (original)
+++ sis/trunk/src/site/resources/book/book.css Sun Sep 30 03:08:50 2012
@@ -27,12 +27,11 @@ div.informalexample {
 div.sidebar {
   margin-left:  1.25cm;
   margin-right: 1.5cm;
+  border-style: solid;
+  border-width: 1px;
+  background-color: #EEEEEE;
+  border-color: #DDDDDD;
   font-size: smaller;
-
-    border-style: solid;
-    border-width: 1px;
-    background-color: #EEEEEE;
-    border-color: #DDDDDD;
 }
 
 span.deprecated {



Mime
View raw message