Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/collection/WeakValueHashMap.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/collection/WeakValueHashMap.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/collection/WeakValueHashMap.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/collection/WeakValueHashMap.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -70,7 +70,7 @@ import java.util.Objects; * <p>{@code WeakValueHashMap} works with array keys as one would expect. For example arrays of {@code int[]} are * compared using the {@link java.util.Arrays#equals(int[], int[])} method.</p> * - * {@section Thread safety} + * <div class="section">Thread safety</div> * The same {@code WeakValueHashMap} instance can be safely used by many threads without synchronization on the part * of the caller. But if a sequence of two or more method calls need to appear atomic from other threads perspective, * then the caller can synchronize on {@code this}.
Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/AbstractInternationalString.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/AbstractInternationalString.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/AbstractInternationalString.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/AbstractInternationalString.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -46,12 +46,12 @@ public abstract class AbstractInternatio * if this string has not yet been determined. This is the default string returned by * {@link #toString()} and others methods from the {@link CharSequence} interface. * - * {@section Thread safety} + * <div class="section">Thread safety</div> * For thread safety this field shall either be read and written in a synchronized block, * or be fixed at construction time and never changed after than point. All other usages * are prohibited. * - * {@section Serialization} + * <div class="section">Serialization</div> * This field is not serialized because serialization is often used for data transmission * between a server and a client, and the client may not use the same locale than the server. * We want the locale to be examined again on the client side. @@ -108,14 +108,14 @@ public abstract class AbstractInternatio * then some fallback locale is used. The fallback locale is implementation-dependent, and * is not necessarily the same than the default locale used by the {@link #toString()} method. * - * {@section Handling of <code>Locale.ROOT</code> argument value} + * <div class="section">Handling of <code>Locale.ROOT</code> argument value</div> * {@link Locale#ROOT} can be given to this method for requesting a "unlocalized" string, * typically some programmatic values like enumerations or identifiers. While identifiers * often look like English words, {@code Locale.ROOT} is not considered synonymous to * {@link Locale#ENGLISH} because the values may differ in the way numbers and dates are * formatted (e.g. using the ISO 8601 standard for dates instead than English conventions). * - * {@section Handling of <code>null</code> argument value} + * <div class="section">Handling of <code>null</code> argument value</div> * The {@code Locale.ROOT} constant is new in Java 6. Some other libraries designed for Java 5 * use the {@code null} value for "unlocalized" strings. Apache SIS accepts {@code null} value * for inter-operability with those libraries. However the behavior is implementation dependent: Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/AbstractName.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/AbstractName.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/AbstractName.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/AbstractName.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -45,11 +45,11 @@ import java.util.Objects; * For example the above-cited strings can both be split into smaller name components. * If such finer grain control is desired, {@link DefaultNameFactory} can be used instead of {@link Names}.</p> * - * {@section <code>Comparable</code> ordering} + * <div class="section">{@code Comparable} ordering</div> * This class has a natural ordering that is inconsistent with {@link #equals(Object)}. * See {@link #compareTo(GenericName)} for more information. * - * {@section Note for implemetors} + * <div class="section">Note for implemetors</div> * Subclasses need only to implement the following methods: * <ul> * <li>{@link #scope()}</li> Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultInternationalString.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultInternationalString.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultInternationalString.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultInternationalString.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -48,7 +48,7 @@ import java.util.Objects; * This behavior is a compromise between making constructions easier, and being suitable for * use in immutable objects. * - * {@section Thread safety} + * <div class="section">Thread safety</div> * Instances of {@code DefaultInternationalString} are thread-safe. While those instances are not strictly immutable, * SIS typically references them as if they were immutable because of their <cite>add-only</cite> behavior. * @@ -251,7 +251,7 @@ public class DefaultInternationalString * was requested but not found, then this method looks for the {@code "fr"} locale. * The {@linkplain Locale#ROOT root locale} is tried last. * - * {@section Handling of <code>Locale.ROOT</code> argument value} + * <div class="section">Handling of {@code Locale.ROOT} argument value</div> * {@link Locale#ROOT} can be given to this method for requesting a "unlocalized" string, * typically some programmatic values like enumerations or identifiers. * While identifiers often look like English words, {@code Locale.ROOT} is not considered @@ -272,7 +272,7 @@ public class DefaultInternationalString * an arbitrary string.</li> * </ul> * - * {@section Handling of <code>null</code> argument value} + * <div class="section">Handling of {@code null} argument value</div> * In the default implementation, the {@code null} locale is handled as a synonymous of * {@code Locale.ROOT}. However subclasses are free to use a different fallback. Client * code are encouraged to specify only non-null values for more determinist behavior. Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultLocalName.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultLocalName.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultLocalName.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultLocalName.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -50,7 +50,7 @@ import java.util.Objects; * <li>Similar static convenience methods in {@link Names}.</li> * </ul> * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This class is immutable and thus inherently thread-safe if the {@link NameSpace} and {@link CharSequence} * arguments given to the constructor are also immutable. Subclasses shall make sure that any overridden methods * remain safe to call from multiple threads and do not change any public {@code LocalName} state. @@ -90,7 +90,7 @@ public class DefaultLocalName extends Ab /** * The name, either as a {@link String} or an {@link InternationalString}. * - * {@section Note on JAXB annotation} + * <div class="section">Note on JAXB annotation</div> * The {@link XmlElement} annotation applied here is appropriate for subclasses only ({@link DefaultTypeName} * and {@link DefaultMemberName}). It is <strong>not</strong> appropriate when (un)marshalling directly this * {@code DefaultLocalName} class. In this later case, we will rather rely on the {@link String} conversion Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultMemberName.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultMemberName.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultMemberName.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultMemberName.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -38,7 +38,7 @@ import java.util.Objects; * <li>Similar static convenience method in {@link Names}.</li> * </ul> * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This class is immutable and thus inherently thread-safe if the {@link NameSpace}, {@link CharSequence} and * {@link TypeName} arguments given to the constructor are also immutable. Subclasses shall make sure that any * overridden methods remain safe to call from multiple threads and do not change any public {@code MemberName} Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultNameFactory.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultNameFactory.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultNameFactory.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultNameFactory.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -63,7 +63,7 @@ import static org.apache.sis.util.iso.De * <li>{@link #toTypeName(Class)}</li> * </ul> * - * {@section Thread safety} + * <div class="section">Thread safety</div> * The same {@code DefaultNameFactory} instance can be safely used by many threads without synchronization * on the part of the caller. Subclasses should make sure that any overridden methods remain safe to call * from multiple threads. Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultNameSpace.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultNameSpace.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultNameSpace.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultNameSpace.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -46,7 +46,7 @@ import java.util.Objects; * <li>{@link DefaultNameFactory#createNameSpace(GenericName, Map)}</li> * </ul> * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This class is immutable and thus inherently thread-safe if the {@link NameSpace} and {@link CharSequence} * arguments given to the constructor are also immutable. Subclasses shall make sure that any overridden methods * remain safe to call from multiple threads and do not change any public {@code NameSpace} state. @@ -463,7 +463,7 @@ public class DefaultNameSpace implements * <div class="note"><b>Example:</b> if the name of this namespace is “<code>org.apache.sis</code>”, * then this method returns “<code>{org.apache.sis}</code>”.</div> * - * {@section Usage} + * <div class="section">Usage</div> * With this convention, it would be possible to create an <cite>expanded form</cite> of a generic name * (except for escaping of illegal characters) with a simple concatenation as in the following code example: * Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecord.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecord.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecord.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecord.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -44,7 +44,7 @@ import java.util.Objects; * Since all members are expected to be assigned a value, the initial values on {@code DefaultRecord} * instantiation are unspecified. Some may be null, or some may be zero. * - * {@section Limitations} + * <div class="section">Limitations</div> * <ul> * <li><b>Multi-threading:</b> {@code DefaultRecord} instances are <strong>not</strong> thread-safe. * Synchronization, if needed, shall be done externally by the caller.</li> Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecordSchema.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecordSchema.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecordSchema.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecordSchema.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -56,12 +56,12 @@ import org.apache.sis.internal.converter * <li>{@link DefaultNameFactory#toTypeName(Class)} if the factory given to the constructor.</li> * </ul> * - * {@section Thread safety} + * <div class="section">Thread safety</div> * The same {@code DefaultRecordSchema} instance can be safely used by many threads without synchronization * on the part of the caller if the {@link NameFactory} given to the constructor is also thread-safe. * Subclasses should make sure that any overridden methods remain safe to call from multiple threads. * - * {@section Limitations} + * <div class="section">Limitations</div> * This class is currently not serializable because {@code RecordSchema} contain an arbitrary amount of record * types in its {@linkplain #getDescription() description} map. Since each {@code RecordType} has a reference * to its schema, serializing a single {@code RecordType} could imply serializing all of them. Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecordType.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecordType.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecordType.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultRecordType.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -57,7 +57,7 @@ import java.util.Objects; * The set of members in a {@code RecordType} can be though as equivalent to the set of fields in a class. * </div> * - * {@section Instantiation} + * <div class="section">Instantiation</div> * The easiest way to create {@code DefaultRecordType} instances is to use the * {@link DefaultRecordSchema#createRecordType(CharSequence, Map)} method. * Example: @@ -76,13 +76,13 @@ import java.util.Objects; * } * </div> * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This class is immutable and thus inherently thread-safe if the {@link TypeName}, the {@link RecordSchema} * and all ({@link MemberName}, {@link Type}) entries in the map given to the constructor are also immutable. * Subclasses shall make sure that any overridden methods remain safe to call from multiple threads and do not change * any public {@code RecordType} state. * - * {@section Serialization} + * <div class="section">Serialization</div> * This class is serializable if all elements given to the constructor are also serializable. * Note in particular that {@link DefaultRecordSchema} is currently <strong>not</strong> serializable, * so users wanting serialization may need to provide their own schema. Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultScopedName.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultScopedName.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultScopedName.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultScopedName.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -42,7 +42,7 @@ import org.apache.sis.internal.util.Unmo * <li>Similar static convenience methods in {@link Names}.</li> * </ul> * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This class is immutable and thus inherently thread-safe if the {@link NameSpace} and all {@link CharSequence} * elements in the arguments given to the constructor are also immutable. Subclasses shall make sure that any * overridden methods remain safe to call from multiple threads and do not change any public {@code LocalName} Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultTypeName.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultTypeName.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultTypeName.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/DefaultTypeName.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -32,7 +32,7 @@ import org.apache.sis.util.UnknownNameEx * <li>{@link DefaultNameFactory#toTypeName(Class)}</li> * </ul> * - * {@section Mapping Java classes to type names} + * <div class="section">Mapping Java classes to type names</div> * It is sometime useful to establish a mapping between {@link Class} and {@code TypeName}. * When an UML identifier from an OGC standard exists for a given {@code Class}, Apache SIS * uses that identifier prefixed by the {@code "OGC"} namespace. @@ -61,7 +61,7 @@ import org.apache.sis.util.UnknownNameEx * {@link DefaultNameFactory#toTypeName(Class)} or {@link #toClass()} instead than parsing the name. * * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This class is immutable and thus inherently thread-safe if the {@link NameSpace} and {@link CharSequence} * arguments given to the constructor are also immutable. Subclasses shall make sure that any overridden methods * remain safe to call from multiple threads and do not change any public {@code TypeName} state. Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/GlobalNameSpace.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/GlobalNameSpace.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/GlobalNameSpace.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/GlobalNameSpace.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -22,7 +22,7 @@ package org.apache.sis.util.iso; * any global namespace in public API since ISO 19103 does not define them and users should not * need to handle them explicitely. * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This class is immutable and thus inherently thread-safe. * * @author Martin Desruisseaux (IRD, Geomatys) Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/Names.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/Names.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/Names.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/Names.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -36,7 +36,7 @@ import static org.apache.sis.util.Argume * but makes some tasks easier by avoiding the need to find a factory, and by creating name and * their namespace in a single step. * - * {@section Relationship with Java Content Repository (JCR) names} + * <div class="section">Relationship with Java Content Repository (JCR) names</div> * In the Java standard {@link javax.xml.namespace.QName} class and in the Java Content Repository (JCR) specification, * a name is an ordered pair of ({@code namespace}, {@code localPart}) strings. A JCR name can take two lexical forms: * <cite>expanded form</cite> and <cite>qualified form</cite>. Those names are mapped to generic names as below: Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/RecordDefinition.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/RecordDefinition.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/RecordDefinition.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/RecordDefinition.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -39,7 +39,7 @@ import org.apache.sis.internal.util.Coll * Holds a {@code Record} definition in a way more convenient for Apache SIS than * what the {@code RecordType} interface provides. * - * {@section Serialization} + * <div class="section">Serialization</div> * This base class is intentionally not serializable, and all private fields are marked as transient for making * this decision more visible. This is because the internal details of this class are quite arbitrary, so we do * not want to expose them in serialization for compatibility reasons. Furthermore some information are redundant, @@ -59,7 +59,7 @@ abstract class RecordDefinition { // Int * is not an instance of {@link DefaultRecordType}. So this adapter is used only if Apache SIS is mixed * with other implementations. * - * {@section Serialization} + * <div class="section">Serialization</div> * This class is serializable if the {@code RecordType} given to the constructor is also serializable. */ static final class Adapter extends RecordDefinition implements Serializable { Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/ResourceInternationalString.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/ResourceInternationalString.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/ResourceInternationalString.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/ResourceInternationalString.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -36,7 +36,7 @@ import static org.apache.sis.util.Argume * See the {@link ResourceBundle#getBundle(String, Locale, ClassLoader) ResourceBundle.getBundle(…)} * Javadoc for more information. * - * {@section Example} + * <div class="section">Example</div> * If a file named "{@code MyResources.properties}" exists in {@code org.mypackage} * and contains the following line: * @@ -55,7 +55,7 @@ import static org.apache.sis.util.Argume * for Italian, <i>etc</i>. * If needed, users can gain more control by overriding the {@link #getBundle(Locale)} method. * - * {@section Class loaders} + * <div class="section">Class loaders</div> * Developers can specify explicitely the {@link ClassLoader} to use be overriding the * {@link #getBundle(Locale)} method. This is recommended if the running environment * loads modules in isolated class loaders, as OSGi does for instance. @@ -64,14 +64,14 @@ import static org.apache.sis.util.Argume * We do not provide {@code ClassLoader} argument in the constructor of this class because class loaders * can often be hard-coded (thus avoiding the cost of an extra field) and are usually not serializable.</div> * - * {@section Apache SIS resources} + * <div class="section">Apache SIS resources</div> * 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 {@code org.apache.sis.util.resources} for more information. * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This class is immutable and thus inherently thread-safe if the bundles created by {@link #getBundle(Locale)} * is also immutable. Subclasses may or may not be immutable, at implementation choice. But implementors are * encouraged to make sure that subclasses remain immutable for more predictable behavior. @@ -122,7 +122,7 @@ public class ResourceInternationalString * bundle from the name given at {@linkplain #ResourceInternationalString construction time}. * Subclasses can override this method if they need to fetch the bundle in an other way. * - * {@section Class loaders} + * <div class="section">Class loaders</div> * By default, this method loads the resources using the caller's class loader. * Subclasses can override this method in order to specify a different class loader. * For example, the code below works well if {@code MyResource} is a class defined @@ -149,7 +149,7 @@ public class ResourceInternationalString * {@code locale}, then this method searches for a string in an other locale as * specified in the {@link ResourceBundle} class description. * - * {@section Handling of <code>null</code> argument value} + * <div class="section">Handling of <code>null</code> argument value</div> * In the default implementation, the {@code null} locale is handled as a synonymous of * {@code Locale.ROOT}. However subclasses are free to use a different fallback. Client * code are encouraged to specify only non-null values for more determinist behavior. Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/SimpleInternationalString.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/SimpleInternationalString.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/SimpleInternationalString.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/SimpleInternationalString.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -33,12 +33,12 @@ import java.util.Objects; * For such a particular case, this implementation is more effective than * other implementations provided in this package. * - * {@section Instantiation} + * <div class="section">Instantiation</div> * If the characters sequence to wrap is known to be a {@code String} instance, then * the {@link #SimpleInternationalString(String)} constructor is okay. Otherwise use * the {@link Types#toInternationalString(CharSequence)} method. * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This class is immutable and thus inherently thread-safe. * Subclasses may or may not be immutable, at implementation choice. But implementors are * encouraged to make sure that subclasses remain immutable for more predictable behavior. Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/package-info.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/package-info.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/package-info.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/package-info.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -53,7 +53,7 @@ * </li> * </ul> * - * {@section Anatomy of a name} + * <div class="section">Anatomy of a name</div> * Names may be {@linkplain org.apache.sis.util.iso.AbstractName#toFullyQualifiedName() fully qualified} * (like {@code "urn:ogc:def:crs:EPSG::4326"}), * or they may be relative to a {@linkplain org.apache.sis.util.iso.AbstractName#scope() scope} Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerAdapter.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerAdapter.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerAdapter.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerAdapter.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -45,7 +45,7 @@ import org.apache.sis.util.Debug; * don't work with {@link LogRecord}, and sometime provides nothing else than convenience methods * equivalent to {@link #severe(String) severe} … {@link #finest(String) finest}.</p> * - * {@section Restrictions} + * <div class="section">Restrictions</div> * Because the configuration is expected to be fully controlled by the external logging * framework, every configuration methods inherited from {@link Logger} are disabled: * @@ -70,7 +70,7 @@ import org.apache.sis.util.Debug; * The adapters can be created, garbage-collected and recreated again while preserving their * behavior since their configuration is entirely contained in the external logging framework. * - * {@section Localization} + * <div class="section">Localization</div> * This logger is always created without resource bundles. Localizations shall be done through * explicit calls to {@code logrb} or {@link #log(LogRecord)} methods. This is sufficient for * SIS needs, which performs all localizations through the later. Note that those methods @@ -78,7 +78,7 @@ import org.apache.sis.util.Debug; * adapter localizes and formats records immediately instead of letting the {@linkplain Handler} * performs this work only if needed. * - * {@section Logging levels} + * <div class="section">Logging levels</div> * If a log record {@linkplain Level level} is not one of the predefined ones, then this class * maps to the first level below the specified one. For example if a log record has some level * between {@link Level#FINE FINE} and {@link Level#FINER FINER}, then the {@link #finer finer} @@ -153,7 +153,7 @@ public abstract class LoggerAdapter exte /** * Returns {@code true} if the specified level is loggable. * - * {@section Implementation tip} + * <div class="section">Implementation tip</div> * Given that {@link Level#intValue} for all predefined levels are documented in the {@link Level} * specification and are multiple of 100, given that integer divisions are rounded toward zero and * given rule documented in this <a href="#skip-navbar_top">class javadoc</a>, then logging levels Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerFactory.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerFactory.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerFactory.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerFactory.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -37,7 +37,7 @@ import org.apache.sis.util.collection.We * The {@link #getLogger(String)} method shall return some {@link Logger} subclass * (typically {@link LoggerAdapter}) which forwards directly all log methods to the other framework. * - * {@section Thread safety} + * <div class="section">Thread safety</div> * This base class is safe for multi-threads usage. Subclasses registered in {@code META-INF/services/} * shall make sure that any overridden methods remain safe to call from multiple threads. * Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -107,7 +107,7 @@ public final class Logging extends Stati * If the given {@code factory} argument is {@code null} (the default), * then the standard Logging framework will be used. * - * {@section Limitation} + * <div class="section">Limitation</div> * SIS classes typically declare a logger constant like below: * * {@preformat java Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/MonolineFormatter.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/MonolineFormatter.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/MonolineFormatter.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/MonolineFormatter.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -68,7 +68,7 @@ import org.apache.sis.util.Debug; * without package (e.g. {@code "NetcdfStore"}).</li> * </ul> * - * {@section Configuration from <code>logging.properties</code>} + * <div class="section">Configuration from {@code logging.properties}</div> * The format can also be set from the {@code jre/lib/logging.properties} file. * For example, user can cut and paste the following properties into {@code logging.properties}: * @@ -100,7 +100,7 @@ import org.apache.sis.util.Debug; * java.util.logging.ConsoleHandler.level = FINE * } * - * {@section Thread safety} + * <div class="section">Thread safety</div> * The same {@code MonolineFormatter} instance can be safely used by many threads without synchronization * on the part of the caller. Subclasses should make sure that any overridden methods remain safe to call * from multiple threads. @@ -263,7 +263,7 @@ public class MonolineFormatter extends F /** * Constructs a default {@code MonolineFormatter}. * - * {@section Auto-configuration from the handler} + * <div class="section">Auto-configuration from the handler</div> * Formatters are often associated to a particular handler. If this handler is known, giving it at * construction time can help this formatter to configure itself. This handler is only a hint - it * will not be modified, and no reference to that handler will be kept by this constructor. @@ -939,7 +939,7 @@ loop: for (int i=0; ; i++) { * The current implementation does not check for duplicated {@code ConsoleHandler} instances, * and does not check if any child logger has a {@code ConsoleHandler}.</div> * - * {@section Specifying a log level} + * <div class="section">Specifying a log level</div> * This method can opportunistically set the handler level. If the given level is non-null, * then the {@link ConsoleHandler} using the {@code MonolineFormatter} will be set to that level. * This is mostly a convenience for temporary increase of logging verbosity for debugging purpose. Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/PerformanceLevel.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/PerformanceLevel.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/PerformanceLevel.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/PerformanceLevel.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -35,7 +35,7 @@ import static org.apache.sis.util.Argume * disabled by default, and enabling them imply enabling configuration logging too. This is * done that way because the configuration typically have a significant impact on performance.</p> * - * {@section Enabling performance logging} + * <div class="section">Enabling performance logging</div> * Performance logging can be enabled in various ways. Among others: * * <ul> Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/WarningListeners.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/WarningListeners.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/WarningListeners.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/WarningListeners.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -41,7 +41,7 @@ import org.apache.sis.util.resources.Err * <li>Otherwise the warning is logged to the logger returned by {@link #getLogger()}.</li> * </ul> * - * {@section Thread safety} + * <div class="section">Thread safety</div> * The same {@code WarningListeners} instance can be safely used by many threads without synchronization * on the part of the caller. Subclasses should make sure that any overridden methods remain safe to call * from multiple threads. @@ -139,7 +139,7 @@ public class WarningListeners<S> impleme * Reports a warning represented by the given message and exception. * At least one of {@code message} and {@code exception} shall be non-null. * - * {@section Stack trace omission} + * <div class="section">Stack trace omission</div> * If there is no registered listener, then the {@link #warning(LogRecord)} method will send the record to the * {@linkplain #getLogger() logger}, but <em>without</em> the stack trace. This is done that way because stack * traces consume lot of space in the logging files, while being considered implementation details in the context Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/package-info.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/package-info.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/package-info.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/logging/package-info.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -29,7 +29,7 @@ * records on single line with colors, for easier reading on the console output.</li> * </ul> * - * {@section Choosing a logging framework} + * <div class="section">Choosing a logging framework</div> * The SIS project uses the standard {@link java.util.logging.Logger} API for its logging, * but this package allows redirection of logging messages to some other frameworks like * <a href="http://logging.apache.org/log4j/";>Log4J</a>. @@ -43,13 +43,13 @@ * <li>Any other JAR registering a {@link org.apache.sis.util.logging.LoggerFactory} implementation.</li> * </ul> * - * {@section Apache SIS logger constants} + * <div class="section">Apache SIS logger constants</div> * Some static final {@code Logger} constant defined in Apache SIS are: * <ul> * <li>{@link org.apache.sis.metadata.iso.ISOMetadata#LOGGER} for the {@code org.apache.sis.metadata.iso.*} packages</li> * </ul> * - * {@section Note for SIS developers} + * <div class="section">Note for SIS developers</div> * All SIS code should fetch their logger through a call to our custom * {@link org.apache.sis.util.logging.Logging#getLogger(String)} method instead than * the standard {@link java.util.logging.Logger#getLogger(String)} method. This is necessary in Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/Errors.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/Errors.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/Errors.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/Errors.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -27,7 +27,7 @@ import org.opengis.util.InternationalStr /** * Locale-dependent resources for error messages. * - * {@section Argument order convention} + * <div class="section">Argument order convention</div> * This resource bundle applies the same convention than JUnit: for every {@code format(…)} method, * the first arguments provide information about the context in which the error occurred (e.g. the * name of a method argument or the range of valid values), while the erroneous values that caused Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/IndexedResourceBundle.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/IndexedResourceBundle.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/IndexedResourceBundle.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/IndexedResourceBundle.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -62,7 +62,7 @@ import org.apache.sis.util.logging.Loggi * <li>{@link Class} and {@link Throwable} instances are summarized.</li> * </ul> * - * {@section Thread safety} + * <div class="section">Thread safety</div> * The same {@code IndexedResourceBundle} instance can be safely used by many threads without synchronization * on the part of the caller. Subclasses should make sure that any overridden methods remain safe to call from * multiple threads. Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/ResourceInternationalString.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/ResourceInternationalString.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/ResourceInternationalString.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/ResourceInternationalString.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -35,7 +35,7 @@ import java.util.Objects; * {@link IndexedResourceBundle}. Compared to the public class, this specialization works * with integer resource keys and accepts arguments. * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This base class is immutable and thus inherently thread-safe. * * @author Martin Desruisseaux (Geomatys) Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -47,7 +47,7 @@ * necessary. This avoid the unfortunate confusion documented in the warning section of * {@link java.text.MessageFormat} javadoc. * - * {@section Usage} + * <div class="section">Usage</div> * All {@link org.apache.sis.util.resources.IndexedResourceBundle} subclasses provide a * {@code getResources(Locale)} static method. It can be used for fetching localized strings * as below: Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/FilteredNamespaces.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/FilteredNamespaces.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/FilteredNamespaces.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/FilteredNamespaces.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -25,7 +25,7 @@ import javax.xml.namespace.NamespaceCont * Substitutes at (un)marshalling time the XML namespaces used by SIS by the namespaces used in the XML document. * This class is used internally by {@link FilteredStreamReader} and {@link FilteredStreamWriter} only. * - * {@section The problem} + * <div class="section">The problem</div> * When the XML schemas of an international standard is updated, the URL of the namespace is often modified. * For example when GML has been updated from version 3.1 to 3.2, the URL mandated by the international standard * changed from {@code "http://www.opengis.net/gml"} to {@code "http://www.opengis.net/gml/3.2"} Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/IdentifiedObject.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/IdentifiedObject.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/IdentifiedObject.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/IdentifiedObject.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -37,7 +37,7 @@ import org.opengis.metadata.citation.Cit * object.getIdentifierMap().put(IdentifierSpace.ID, "myID"); * } * - * {@section Relationship with GeoAPI} + * <div class="section">Relationship with GeoAPI</div> * Identifiers exist also in some (not all) GeoAPI objects. Some GeoAPI objects * ({@link org.opengis.metadata.acquisition.Instrument}, {@link org.opengis.metadata.acquisition.Platform}, * {@link org.opengis.metadata.acquisition.Operation}, {@link org.opengis.metadata.lineage.Processing}, Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/MarshalContext.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/MarshalContext.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/MarshalContext.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/MarshalContext.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -45,13 +45,13 @@ public abstract class MarshalContext { * In particular children of {@link org.opengis.metadata.Metadata} inherit the locale * specified by the {@link org.opengis.metadata.Metadata#getLanguage()} attribute.</p> * - * {@section Handling of <code>Locale.ROOT</code>} + * <div class="section">Handling of {@code Locale.ROOT}</div> * {@link Locale#ROOT} is interpreted as a request for locale-neutral strings. * The meaning of "locale-neutral" is implementation specific - this is usually * very close to the English locale, but not necessarily. For examples dates are * formatted according ISO standard instead than the rules of the English locale. * - * {@section Handling of <code>null</code> locale} + * <div class="section">Handling of {@code null} locale</div> * A {@code null} value means that the locale is unspecified. Callers are encouraged * to use the root locale as the default value, but some flexibility is allowed. * @@ -64,7 +64,7 @@ public abstract class MarshalContext { /** * Returns the timezone to use for (un)marshalling, or {@code null} if none were explicitely specified. * - * {@section Handling of <code>null</code> timezone} + * <div class="section">Handling of <code>null</code> timezone</div> * A {@code null} value means that the timezone is unspecified. Callers are encouraged * to use the UTC timezone as the default value, but some flexibility is allowed. * Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/MarshallerPool.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/MarshallerPool.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/MarshallerPool.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/MarshallerPool.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -45,11 +45,11 @@ import org.apache.sis.util.ArgumentCheck * pool.recycle(marshaller); * } * - * {@section Configuring (un)marshallers} + * <div class="section">Configuring (un)marshallers</div> * The (un)marshallers created by this class can optionally by configured with the SIS-specific * properties defined in the {@link XML} class, in addition to JAXB standard properties. * - * {@section Thread safety} + * <div class="section">Thread safety</div> * The same {@code MarshallerPool} instance can be safely used by many threads without synchronization * on the part of the caller. Subclasses should make sure that any overridden methods remain safe to call * from multiple threads. @@ -373,7 +373,7 @@ public class MarshallerPool { * The caller should not use anymore the given marshaller after this method call, * since the marshaller may be re-used by another thread at any time after recycle. * - * {@section Cautions} + * <div class="section">Cautions</div> * <ul> * <li>Do not invoke this method if the marshaller threw an exception, since the * marshaller may be in an invalid state. In particular, this method should not @@ -397,7 +397,7 @@ public class MarshallerPool { * The caller should not use anymore the given unmarshaller after this method call, * since the unmarshaller may be re-used by another thread at any time after recycle. * - * {@section Cautions} + * <div class="section">Cautions</div> * <ul> * <li>Do not invoke this method if the unmarshaller threw an exception, since the * unmarshaller may be in an invalid state. In particular, this method should not Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/Namespaces.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/Namespaces.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/Namespaces.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/Namespaces.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -50,7 +50,7 @@ import org.apache.sis.util.ArgumentCheck * <tr><td>xlink</td> <td>{@value #XLINK}</td> <td></td></tr> * </table> * - * {@section Profiles} + * <div class="section">Profiles</div> * Some countries or organizations define profiles of international standards, which may contain * country-specific extensions. The namespace of such extensions are usually defined in a separated * class dedicated to the profile. Some of them are listed below: Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/NilObject.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/NilObject.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/NilObject.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/NilObject.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -61,7 +61,7 @@ package org.apache.sis.xml; * both the {@code Series} and the {@code NilObject} interfaces, and the {@link #getNilReason()} method * on that instance will return the {@link NilReason#UNKNOWN} constant. * - * {@section Instantiation} + * <div class="section">Instantiation</div> * Instances of {@code NilObject} are created by first fetching the reason why the information * is missing, then invoking {@link NilReason#createNilObject(Class)}. The following example * instantiates a {@code Citation} object which is nil because the information are missing: Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -49,7 +49,7 @@ import org.apache.sis.internal.jaxb.Prim * {@code NilReason} is used in a number of XML elements where it is necessary to permit * one of the above values as an alternative to the primary element. * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This final class is immutable and thus inherently thread-safe. * * @author Martin Desruisseaux (Geomatys) @@ -117,7 +117,7 @@ public final class NilReason implements * The string representation of this constant is {@code "other"}. * The explanation property is an empty string, and the URI is {@code null}. * - * {@section Providing an explanation} + * <div class="section">Providing an explanation</div> * Users are encouraged to use the {@link #valueOf(String)} method instead than this constant, * in order to provide a brief explanation. The string representation for {@code valueOf(…)} * is <code>"other:<var>explanation</var>"</code> where <var>explanation</var> is a string of Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/OGCNamespacePrefixMapper.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/OGCNamespacePrefixMapper.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/OGCNamespacePrefixMapper.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/OGCNamespacePrefixMapper.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -28,7 +28,7 @@ import com.sun.xml.internal.bind.marshal * bundled with JAXB 2.1. Even with working {@code @XmlSchema} annotations, this mapper still * a convenient may to gain more control like choosing a default namespace at runtime. * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This final class is immutable and thus inherently thread-safe. * * @author Cédric Briançon (Geomatys) Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/OGCNamespacePrefixMapper_Endorsed.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/OGCNamespacePrefixMapper_Endorsed.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/OGCNamespacePrefixMapper_Endorsed.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/OGCNamespacePrefixMapper_Endorsed.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -26,7 +26,7 @@ import com.sun.xml.bind.marshaller.Names * the package name of the parent {@code NamespacePrefixMapper} class does not have * the "{@code internal}" part. * - * {@section Immutability and thread safety} + * <div class="section">Immutability and thread safety</div> * This final class is immutable and thus inherently thread-safe. * * @author Cédric Briançon (Geomatys) Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/XML.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/XML.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/XML.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/XML.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -79,7 +79,7 @@ public final class XML extends Static { * such case, the unmarshaller will try to pickup a string in the language specified * by this property.</p> * - * {@section Default behavior} + * <div class="section">Default behavior</div> * If this property is never set, then (un)marshalling will try to use "unlocalized" strings - * typically some programmatic strings like {@linkplain org.opengis.annotation.UML#identifier() * UML identifiers}. While such identifiers often look like English words, they are not @@ -87,7 +87,7 @@ public final class XML extends Static { * The algorithm attempting to find a "unlocalized" string is defined in the * {@link org.apache.sis.util.iso.DefaultInternationalString#toString(Locale)} javadoc. * - * {@section Special case} + * <div class="section">Special case</div> * If the object to be marshalled is an instance of * {@link org.apache.sis.metadata.iso.DefaultMetadata}, then the value given to its * {@link org.apache.sis.metadata.iso.DefaultMetadata#setLanguage(Locale) setLanguage(Locale)} @@ -103,7 +103,7 @@ public final class XML extends Static { * The value for this property shall be an instance of {@link TimeZone} * or a {@link CharSequence} recognized by {@link TimeZone#getTimeZone(String)}. * - * {@section Default behavior} + * <div class="section">Default behavior</div> * If this property is never set, then (un)marshalling will use the * {@linkplain TimeZone#getDefault() default timezone}. */ @@ -125,7 +125,7 @@ public final class XML extends Static { * for the ISO 19139 schemas. Additional keys, if any, are ignored. Future SIS versions * may recognize more keys. * - * {@section Valid values} + * <div class="section">Valid values</div> * <table class="sis"> * <caption>Supported schemas</caption> * <tr><th>Map key</th> <th>Typical values (choose only one)</th></tr> @@ -143,7 +143,7 @@ public final class XML extends Static { * Specifies the default namespace of the XML document to write. * An example of value for this key is {@code "http://www.isotc211.org/2005/gmd"}. * - * {@section Current limitation} + * <div class="section">Current limitation</div> * In current SIS implementation, this property is honored only by the {@link MarshallerPool} constructors. * Specifying this property to {@link javax.xml.bind.Marshaller#setProperty(String, Object)} is too late. * This limitation may be fixed in a future SIS version. @@ -161,7 +161,7 @@ public final class XML extends Static { * The value can be {@link String} or {@link Version} objects. * If no version is specified, then the most recent GML version is assumed. * - * {@section Supported GML versions} + * <div class="section">Supported GML versions</div> * Apache SIS currently supports GML 3.2.1 by default. SIS can read and write GML 3.2 * if this property is set to "3.2". It is also possible to set this property to "3.1", * but the marshalled XML is not GML 3.1.1 conformant because of the differences between the two schemas. @@ -206,9 +206,8 @@ public final class XML extends Static { * for replacing an erroneous URL by a fixed URL. See the {@link ValueConverter} javadoc for * more details.</p> * - * {@section Example} - * The following example collects the failures in a list without stopping the (un)marshalling - * process. + * <div class="note"><b>Example:</b> + * the following example collects the failures in a list without stopping the (un)marshalling process. * * {@preformat java * class WarningCollector extends ValueConverter { @@ -237,6 +236,7 @@ public final class XML extends Static { * // Report here the warnings to the user. * } * } + * </div> * * @see Unmarshaller#setProperty(String, Object) * @see ValueConverter @@ -254,7 +254,7 @@ public final class XML extends Static { * <li>"{@code mimetype}" for substituting {@code <gmx:MimeFileType>} elements</li> * </ul> * - * {@section Example} + * <div class="note"><b>Example:</b> * INSPIRE compliant language code shall be formatted like below (details may vary): * * {@preformat xml @@ -273,6 +273,7 @@ public final class XML extends Static { * <gco:CharacterString>fra</gco:CharacterString> * </gmd:language> * } + * </div> */ public static final String STRING_SUBSTITUTES = "org.apache.sis.xml.stringSubstitutes"; Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/package-info.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/package-info.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/package-info.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/package-info.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -41,7 +41,7 @@ * </gmd:CI_Citation> * } * - * {@section Customizing the XML} + * <div class="section">Customizing the XML</div> * In order to parse and format ISO 19139 compliant documents, SIS needs its own * {@link javax.xml.bind.Marshaller} and {@link javax.xml.bind.Unmarshaller} instances * (which are actually wrappers around standard instances). Those instances are created Modified: sis/branches/JDK8/core/sis-utility/src/test/java/org/apache/sis/test/Assert.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/test/java/org/apache/sis/test/Assert.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/test/java/org/apache/sis/test/Assert.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/test/java/org/apache/sis/test/Assert.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -262,7 +262,7 @@ public strictfp class Assert extends org * * This method will ignore comments and the optional attributes given in arguments. * - * {@section Ignored attributes substitution} + * <div class="section">Ignored attributes substitution</div> * For convenience, this method replaces some well known prefixes in the {@code ignoredAttributes} * array by their full namespace URLs. For example this method replaces{@code "xsi:schemaLocation"} * by {@code "http://www.w3.org/2001/XMLSchema-instance:schemaLocation"}. Modified: sis/branches/JDK8/core/sis-utility/src/test/java/org/apache/sis/test/package-info.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/test/java/org/apache/sis/test/package-info.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/core/sis-utility/src/test/java/org/apache/sis/test/package-info.java [UTF-8] (original) +++ sis/branches/JDK8/core/sis-utility/src/test/java/org/apache/sis/test/package-info.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -22,7 +22,7 @@ * {@link org.opengis.test.Assert} (which itself extends the JUnit {@link org.junit.Assert} class) * with the addition of assertion methods commonly used in SIS tests. * - * {@section Outputs configuration} + * <div class="section">Outputs configuration</div> * By default, successful tests do not produce any output. However it is possible to ask for * verbose outputs, which is sometime useful for debugging purpose. This behavior is controlled * from the command line by defining {@linkplain java.lang.System#getProperties() system properties} Modified: sis/branches/JDK8/pom.xml URL: http://svn.apache.org/viewvc/sis/branches/JDK8/pom.xml?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/pom.xml (original) +++ sis/branches/JDK8/pom.xml Fri Mar 20 17:32:02 2015 @@ -651,7 +651,6 @@ Apache SIS is a free software, Java lang </tags> <taglets> <taglet><tagletClass>org.apache.sis.internal.taglet.Module</tagletClass></taglet> - <taglet><tagletClass>org.apache.sis.internal.taglet.Section</tagletClass></taglet> <taglet><tagletClass>org.apache.sis.internal.taglet.Include</tagletClass></taglet> <taglet><tagletClass>org.apache.sis.internal.taglet.Preformat</tagletClass></taglet> </taglets> Modified: sis/branches/JDK8/profiles/sis-french-profile/src/main/java/org/apache/sis/profile/france/package-info.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/profiles/sis-french-profile/src/main/java/org/apache/sis/profile/france/package-info.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/profiles/sis-french-profile/src/main/java/org/apache/sis/profile/france/package-info.java [UTF-8] (original) +++ sis/branches/JDK8/profiles/sis-french-profile/src/main/java/org/apache/sis/profile/france/package-info.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -18,7 +18,7 @@ /** * French extensions defined by the <cite>Association Française de Normalisation</cite> (AFNOR). * - * {@section Historical note} + * <div class="section">Historical note</div> * The French profile also added two properties to the ISO 19115:2003 standard. * Equivalent properties have been added to the 2013 revision of ISO 19115, * so the French profile should not be needed anymore except for compatibility with oldest specifications. Modified: sis/branches/JDK8/src/main/javadoc/stylesheet.css URL: http://svn.apache.org/viewvc/sis/branches/JDK8/src/main/javadoc/stylesheet.css?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/src/main/javadoc/stylesheet.css (original) +++ sis/branches/JDK8/src/main/javadoc/stylesheet.css Fri Mar 20 17:32:02 2015 @@ -152,18 +152,18 @@ div.warning:before { /* - * Formatting in the {@section} custom javadoc tag. + * Formatting of section headers */ -div.block h5 { - font-size: 16px; - margin-top: 30px; - margin-bottom: 6px; +div.section { + font-size: 15px; + font-weight: bold; + margin-top: 21px; + margin-bottom: 3px; } -div.block h6 { - font-size: 16px; - margin-top: 30px; - margin-bottom: 6px; +div.description div.section { + font-size: 18px; + margin-top: 30px; } /* Modified: sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Axis.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Axis.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Axis.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Axis.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -43,7 +43,7 @@ public final class Axis { * The indices of the grid dimension associated to this axis. Values in this array are sorted with more * "significant" (defined below) dimensions first - this is not necessarily increasing order. * - * {@section Elements order} + * <div class="section">Elements order</div> * The length of this array is often 1. But if more than one grid dimension is associated to this axis * (i.e. if the wrapped NetCDF axis is an instance of {@link ucar.nc2.dataset.CoordinateAxis2D}), then * the first index is what seems the most significant grid dimension (i.e. the dimension which seems Modified: sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/MetadataReader.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/MetadataReader.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/MetadataReader.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/MetadataReader.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -95,7 +95,7 @@ import static org.apache.sis.internal.ut * {@linkplain #LONGITUDE longitude} and {@linkplain #LATITUDE latitude} resolutions are * often more accurate in that group. * - * {@section Known limitations} + * <div class="section">Known limitations</div> * <ul> * <li>{@code "degrees_west"} and {@code "degrees_south"} units not correctly handled.</li> * <li>Units of measurement not yet declared in the {@link Band} elements.</li> Modified: sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/NetcdfStoreProvider.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/NetcdfStoreProvider.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/NetcdfStoreProvider.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/NetcdfStoreProvider.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -46,7 +46,7 @@ import org.apache.sis.util.Version; * on the classpath, then this class tries to instantiate a {@code NetcdfStore} backed by * the UCAR library. * - * {@section Thread safety} + * <div class="section">Thread safety</div> * The same {@code NetcdfStoreProvider} instance can be safely used by many threads without synchronization on * the part of the caller. However the {@link NetcdfStore} instances created by this factory are not thread-safe. * Modified: sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/package-info.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/package-info.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/package-info.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/package-info.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -28,7 +28,7 @@ * The NetCDF attributes recognized by this package are listed in the * {@link org.apache.sis.storage.netcdf.AttributeNames} class. * - * {@section Note on the definition of terms} + * <div class="section">Note on the definition of terms</div> * The UCAR library sometime uses the same words than the ISO/OGC standards for different things. * In particular the words "<cite>domain</cite>" and "<cite>range</cite>" can be applied to arbitrary functions, * and the UCAR library chooses to apply it to the function that converts grid indices to geodetic coordinates. Modified: sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/ChannelDataInput.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/ChannelDataInput.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/ChannelDataInput.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/ChannelDataInput.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -40,7 +40,7 @@ import java.nio.channels.SeekableByteCha * The channel and the buffer must be supplied by the caller. It is okay if they have already been used * before {@code ChannelDataInput} creation. * - * {@section Encapsulation} + * <div class="section">Encapsulation</div> * This class exposes publicly the {@linkplain #channel} and the {@linkplain #buffer buffer} because this class * is not expected to perform all possible data manipulations that we can do with the buffers. This class is only * a helper tool, which often needs to be completed by specialized operations performed directly on the buffer. @@ -50,7 +50,7 @@ import java.nio.channels.SeekableByteCha * <p>Since this class is only a helper tool, it does not "own" the channel and consequently does not provide * {@code close()} method. It is users responsibility to close the channel after usage.</p> * - * {@section Relationship with <code>DataInput</code>} + * <div class="section">Relationship with {@code DataInput}</div> * This class API is compatibly with the {@link java.io.DataInput} interface, so subclasses can implement that * interface if they wish. This class does not implement {@code DataInput} itself because it is not needed for * SIS purposes, and because {@code DataInput} has undesirable methods ({@code readLine()} and {@code readUTF()}). Modified: sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/ChannelDataOutput.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/ChannelDataOutput.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/ChannelDataOutput.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/ChannelDataOutput.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -41,7 +41,7 @@ import java.nio.channels.SeekableByteCha * The channel and the buffer must be supplied by the caller. It is okay if they have already been used * before {@code ChannelDataOutput} creation. * - * {@section Encapsulation} + * <div class="section">Encapsulation</div> * This class exposes publicly the {@linkplain #channel} and the {@linkplain #buffer buffer} because this class * is not expected to perform all possible data manipulations that we can do with the buffers. This class is only * a helper tool, which often needs to be completed by specialized operations performed directly on the buffer. @@ -51,7 +51,7 @@ import java.nio.channels.SeekableByteCha * <p>Since this class is only a helper tool, it does not "own" the channel and consequently does not provide * {@code close()} method. It is users responsibility to close the channel after usage.</p> * - * {@section Relationship with <code>DataOutput</code>} + * <div class="section">Relationship with {@code DataOutput}</div> * This class API is compatibly with the {@link java.io.DataOutput} interface, so subclasses can implement that * interface if they wish. This class does not implement {@code DataOutput} itself because it is not needed for * SIS purposes. Modified: sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/IOUtilities.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/IOUtilities.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/IOUtilities.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/IOUtilities.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -358,7 +358,7 @@ public final class IOUtilities extends S * the URL is converted to a {@link File} object using the given {@code encoding} for decoding * the {@code "%XX"} sequences, if any. * - * {@section Rational} + * <div class="section">Rational</div> * A URL can represent a file, but {@link URL#openStream()} appears to return a {@code BufferedInputStream} * wrapping the {@link FileInputStream}, which is not a desirable feature when we want to obtain a channel. * Modified: sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStore.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStore.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStore.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStore.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -28,7 +28,7 @@ import org.apache.sis.util.logging.Warni /** * Manages a series of features, coverages or sensor data. * - * {@section Thread safety policy} + * <div class="section">Thread safety policy</div> * This {@code DataStore} base class is thread-safe. However subclasses are usually not. * Unless otherwise specified by subclasses, users should assume that {@code DataStore} * instances are not thread-safe. Modified: sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreProvider.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -29,7 +29,7 @@ package org.apache.sis.storage; * to open a given {@link StorageConnector}.</li> * </ul> * - * {@section Packaging data stores} + * <div class="section">Packaging data stores</div> * JAR files that provide implementations of this class shall contain an entry with exactly the following path: * * {@preformat text @@ -40,7 +40,7 @@ package org.apache.sis.storage; * where each line is the fully qualified name of the implementation class. * See {@link java.util.ServiceLoader} for more general discussion about this lookup mechanism. * - * {@section Thread safety} + * <div class="section">Thread safety</div> * All {@code DataStoreProvider} implementations shall be thread-safe. * However the {@code DataStore} instances created by the providers do not need to be thread-safe. * @@ -76,7 +76,7 @@ public abstract class DataStoreProvider * {@link java.nio.ByteBuffer#mark()}, {@link java.io.InputStream#mark(int)} and * {@link javax.imageio.stream.ImageInputStream#mark()}.</p> * - * {@section Implementation example} + * <div class="note"><b>Implementation example</b><br> * Implementations will typically check the first bytes of the stream for a "magic number" associated * with the format, as in the following example: * @@ -102,6 +102,7 @@ public abstract class DataStoreProvider * return ProbeResult.SUPPORTED; * } * } + * </div> * * @param storage Information about the storage (URL, stream, JDBC connection, <i>etc</i>). * @return {@link ProbeResult#SUPPORTED} if the given storage seems to be readable by the {@code DataStore} @@ -114,7 +115,7 @@ public abstract class DataStoreProvider /** * Returns a data store implementation associated with this provider. * - * {@section Implementation note} + * <div class="section">Implementation note</div> * Implementors shall invoke {@link StorageConnector#closeAllExcept(Object)} after {@code DataStore} * creation, keeping open only the needed resource. * Modified: sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreRegistry.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreRegistry.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreRegistry.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStoreRegistry.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -33,7 +33,7 @@ import org.apache.sis.util.resources.Err * This class is package-private for now in order to get more experience about what could be a good API. * This class may become public in a future SIS version.</div> * - * {@section Thread safety} + * <div class="section">Thread safety</div> * The same {@code DataStoreRegistry} instance can be safely used by many threads without synchronization * on the part of the caller. * Modified: sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStores.java URL: http://svn.apache.org/viewvc/sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStores.java?rev=1668105&r1=1668104&r2=1668105&view=diff ============================================================================== --- sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStores.java [UTF-8] (original) +++ sis/branches/JDK8/storage/sis-storage/src/main/java/org/apache/sis/storage/DataStores.java [UTF-8] Fri Mar 20 17:32:02 2015 @@ -35,7 +35,7 @@ public final class DataStores extends St /** * The registry to use for searching for {@link DataStoreProvider} implementations. * - * {@section Class loader} + * <div class="section">Class loader</div> * In current implementation, this registry is instantiated when first needed using the * {@linkplain Thread#getContextClassLoader() context class loader}. This means that the set of * available formats may depend on the first thread that invoked a {@code DataStores} method.
