Author: desruisseaux
Date: Fri Mar 20 14:31:22 2015
New Revision: 1668031
URL: http://svn.apache.org/r1668031
Log:
Javadoc: more corrections in stylesheet.
Modified:
sis/branches/JDK8/core/sis-feature/src/main/java/org/apache/sis/feature/package-info.java
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/AbstractMetadata.java
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/MetadataStandard.java
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ImmutableIdentifier.java
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/package-info.java
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/ParameterBuilder.java
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/Builder.java
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/IdentifiedObjects.java
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultGeodeticDatum.java
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultOperationMethod.java
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/package-info.java
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java
sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/package-info.java
sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/CorruptedObjectException.java
sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java
sis/branches/JDK8/src/main/javadoc/stylesheet.css
Modified:
sis/branches/JDK8/core/sis-feature/src/main/java/org/apache/sis/feature/package-info.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-feature/src/main/java/org/apache/sis/feature/package-info.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-feature/src/main/java/org/apache/sis/feature/package-info.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-feature/src/main/java/org/apache/sis/feature/package-info.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -20,28 +20,28 @@
* The phenomenon to represent (or a fundamental unit of information) is
called <cite>a feature</cite>.
* The term “feature” may be used in different contexts:
*
- * <ul>
- * <li><p><b>{@linkplain org.apache.sis.feature.DefaultFeatureType Feature
types}</b><br>
+ * <ul class="verbose">
+ * <li><b>{@linkplain org.apache.sis.feature.DefaultFeatureType Feature
types}</b><br>
* Define the <em>structure</em> of real-world representations. A
feature type lists the
* {@linkplain org.apache.sis.feature.DefaultAttributeType attributes},
* {@linkplain org.apache.sis.feature.DefaultOperation operations} or
* {@linkplain org.apache.sis.feature.DefaultAssociationRole
associations to other features}
* (collectively called “{@linkplain
org.apache.sis.feature.DefaultFeatureType#getProperties(boolean) properties}”
- * or “characteristics”) that a feature can have.</p>
+ * or “characteristics”) that a feature can have.
*
* <div class="note"><b>Analogy:</b> a {@code FeatureType} in a Spatial
Information System is equivalent to a
* {@link java.lang.Class} in the Java language. By extension, {@code
AttributeType} and {@code Operation} are
* equivalent to {@link java.lang.reflect.Field} and {@link
java.lang.reflect.Method} respectively.</div></li>
*
- * <li><p><b>{@linkplain org.apache.sis.feature.AbstractFeature Feature
instances}</b> (often called only Features)<br>
- * Hold the <em>content</em> (or values) that describe one specific
real-world object.</p>
+ * <li><b>{@linkplain org.apache.sis.feature.AbstractFeature Feature
instances}</b> (often called only Features)<br>
+ * Hold the <em>content</em> (or values) that describe one specific
real-world object.
*
* <div class="note"><b>Example:</b> the “Eiffel tower” is a <em>feature
instance</em> belonging
* to the “Tower” <em>feature type</em>.</div></li>
*
- * <li><p><b>{@linkplain
org.apache.sis.feature.DefaultFeatureType#isSimple() Simple features}</b><br>
+ * <li><b>{@linkplain org.apache.sis.feature.DefaultFeatureType#isSimple()
Simple features}</b><br>
* Are instances of a feature type with no association to other
features, and where all attributes
- * are constrained to the [1 … 1] cardinality. Such simple features are
very common.</p></li>
+ * are constrained to the [1 … 1] cardinality. Such simple features are
very common.</li>
* </ul>
*
* In addition, a feature type can inherit the properties of one or more other
feature types.
Modified:
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/AbstractMetadata.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/AbstractMetadata.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/AbstractMetadata.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/AbstractMetadata.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -228,35 +228,35 @@ public abstract class AbstractMetadata i
* underlying metadata object are immediately reflected in the tree table
and conversely.
*
* <p>The returned {@code TreeTable} instance contains the following
columns:</p>
- * <ul>
- * <li><p>{@link
org.apache.sis.util.collection.TableColumn#IDENTIFIER}<br>
+ * <ul class="verbose">
+ * <li>{@link org.apache.sis.util.collection.TableColumn#IDENTIFIER}<br>
* The {@linkplain org.opengis.annotation.UML#identifier() UML
identifier} if any,
* or the Java Beans property name otherwise, of a metadata
property. For example
* in a tree table view of {@link
org.apache.sis.metadata.iso.citation.DefaultCitation},
- * there is a node having the {@code "title"} identifier.</p></li>
+ * there is a node having the {@code "title"} identifier.</li>
*
- * <li><p>{@link org.apache.sis.util.collection.TableColumn#INDEX}<br>
+ * <li>{@link org.apache.sis.util.collection.TableColumn#INDEX}<br>
* If the metadata property is a collection, then the zero-based
index of the element in that collection.
* Otherwise {@code null}. For example in a tree table view of
{@code DefaultCitation}, if the
* {@code "alternateTitle"} collection contains two elements, then
there is a node with index 0
- * for the first element and an other node with index 1 for the
second element.</p>
+ * for the first element and an other node with index 1 for the
second element.
*
* <div class="note"><b>Note:</b>
* The {@code (IDENTIFIER, INDEX)} pair can be used as a primary key
for uniquely identifying a node
* in a list of children. That uniqueness is guaranteed only for the
children of a given node;
* the same keys may appear in the children of any other
nodes.</div></li>
*
- * <li><p>{@link org.apache.sis.util.collection.TableColumn#NAME}<br>
+ * <li>{@link org.apache.sis.util.collection.TableColumn#NAME}<br>
* A human-readable name for the node, derived from the identifier
and the index.
* This is the column shown in the default {@link #toString()}
implementation and
- * may be localizable.</p></li>
+ * may be localizable.</li>
*
- * <li><p>{@link org.apache.sis.util.collection.TableColumn#TYPE}<br>
- * The base type of the value (usually an interface).</p></li>
+ * <li>{@link org.apache.sis.util.collection.TableColumn#TYPE}<br>
+ * The base type of the value (usually an interface).</li>
*
- * <li><p>{@link org.apache.sis.util.collection.TableColumn#VALUE}<br>
+ * <li>{@link org.apache.sis.util.collection.TableColumn#VALUE}<br>
* The metadata value for the node. Values in this column are
writable if the underlying
- * metadata class have a setter method for the property represented
by the node.</p></li>
+ * metadata class have a setter method for the property represented
by the node.</li>
* </ul>
*
* {@section Write operations}
Modified:
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/MetadataStandard.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/MetadataStandard.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/MetadataStandard.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/MetadataStandard.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -766,35 +766,35 @@ public class MetadataStandard implements
* underlying metadata object are immediately reflected in the tree table
and conversely.
*
* <p>The returned {@code TreeTable} instance contains the following
columns:</p>
- * <ul>
- * <li><p>{@link
org.apache.sis.util.collection.TableColumn#IDENTIFIER}<br>
+ * <ul class="verbose">
+ * <li>{@link org.apache.sis.util.collection.TableColumn#IDENTIFIER}<br>
* The {@linkplain org.opengis.annotation.UML#identifier() UML
identifier} if any,
* or the Java Beans property name otherwise, of a metadata
property. For example
* in a tree table view of {@link
org.apache.sis.metadata.iso.citation.DefaultCitation},
- * there is a node having the {@code "title"} identifier.</p></li>
+ * there is a node having the {@code "title"} identifier.</li>
*
- * <li><p>{@link org.apache.sis.util.collection.TableColumn#INDEX}<br>
+ * <li>{@link org.apache.sis.util.collection.TableColumn#INDEX}<br>
* If the metadata property is a collection, then the zero-based
index of the element in that collection.
* Otherwise {@code null}. For example in a tree table view of
{@code DefaultCitation}, if the
* {@code "alternateTitle"} collection contains two elements, then
there is a node with index 0
- * for the first element and an other node with index 1 for the
second element.</p>
+ * for the first element and an other node with index 1 for the
second element.
*
* <div class="note"><b>Note:</b>
* The {@code (IDENTIFIER, INDEX)} pair can be used as a primary key
for uniquely identifying a node
* in a list of children. That uniqueness is guaranteed only for the
children of a given node;
* the same keys may appear in the children of any other
nodes.</div></li>
*
- * <li><p>{@link org.apache.sis.util.collection.TableColumn#NAME}<br>
+ * <li>{@link org.apache.sis.util.collection.TableColumn#NAME}<br>
* A human-readable name for the node, derived from the identifier
and the index.
* This is the column shown in the default {@link #toString()}
implementation and
- * may be localizable.</p></li>
+ * may be localizable.</li>
*
- * <li><p>{@link org.apache.sis.util.collection.TableColumn#TYPE}<br>
- * The base type of the value (usually an interface).</p></li>
+ * <li>{@link org.apache.sis.util.collection.TableColumn#TYPE}<br>
+ * The base type of the value (usually an interface).</li>
*
- * <li><p>{@link org.apache.sis.util.collection.TableColumn#VALUE}<br>
+ * <li>{@link org.apache.sis.util.collection.TableColumn#VALUE}<br>
* The metadata value for the node. Values in this column are
writable if the underlying
- * metadata class have a setter method for the property represented
by the node.</p></li>
+ * metadata class have a setter method for the property represented
by the node.</li>
* </ul>
*
* {@section Write operations}
Modified:
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ImmutableIdentifier.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ImmutableIdentifier.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ImmutableIdentifier.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ImmutableIdentifier.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -66,7 +66,7 @@ import java.util.Objects;
* The following examples show an identifier for a Geographic Coordinate
Reference System (CRS)
* identified by code 4326 in the "EPSG" code space:
*
- * <ul><li><p><b><cite>Well Known Text</cite> (WKT) version 1</b></p>
+ * <ul class="verbose"><li><b><cite>Well Known Text</cite> (WKT) version
1</b><br>
* The WKT 1 format contains only the {@linkplain #getCodeSpace() code space}
and the {@linkplain #getCode() code}.
* If there is no code space, then the {@linkplain #getAuthority() authority}
abbreviation is used as a fallback.
* Example:
@@ -75,7 +75,7 @@ import java.util.Objects;
* AUTHORITY["EPSG", "4326"]
* }
*
- * </li><li><p><b><cite>Well Known Text</cite> (WKT) version 2</b></p>
+ * </li><li><b><cite>Well Known Text</cite> (WKT) version 2</b><br>
* The WKT 2 format contains the {@linkplain #getCodeSpace() code space}, the
{@linkplain #getCode() code},
* the {@linkplain #getVersion() version} and the {@linkplain #getAuthority()
authority} citation if available.
* The WKT can optionally provides a {@code URI} element, which expresses the
same information in a different way
@@ -86,7 +86,7 @@ import java.util.Objects;
* ID["EPSG", 4326, URI["urn:ogc:def:crs:EPSG::4326"]]
* }
*
- * </li><li><p><b>XML in referencing objects</b></p>
+ * </li><li><b>XML in referencing objects</b><br>
* The <cite>Definition identifier URNs in OGC namespace</cite> paper defines
a syntax for identifiers commonly
* found in Geographic Markup Language (GML) documents. Example:
*
@@ -101,7 +101,7 @@ import java.util.Objects;
* urn:ogc:def:<type>:<{@linkplain #getCodeSpace()
codespace}>:<{@linkplain #getVersion() version}>:<{@linkplain
#getCode() code}>
* </code></blockquote>
*
- * </li><li><p><b>XML in metadata objects</b></p>
+ * </li><li><b>XML in metadata objects</b><br>
* The XML representation of {@link ImmutableIdentifier} in a metadata is
similar to the {@link DefaultIdentifier}
* one except for the {@code "RS_"} prefix:
*
Modified:
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/package-info.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/package-info.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/package-info.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/package-info.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -45,7 +45,7 @@
* or {@code Default}.</p>
*
* <p><b>Notes:</b></p>
- * <ul>
+ * <ul class="verbose">
* <li>The {@code Abstract} prefix means that the class is abstract in the
sense of the implemented standard.
* It it not necessarily abstract in the sense of Java. Because
incomplete metadata are common in practice,
* sometime we wish to instantiate an "abstract" class despite the lack
of knowledge about the exact sub-type.</li>
@@ -70,19 +70,19 @@
* and fallback on the reflection technic when the type is known only at
runtime.</p>
*
* <p>Using Java reflection, a metadata can be viewed in many different
ways:</p>
- * <ul>
- * <li><p><b>As a {@link java.util.Map}</b><br>
+ * <ul class="verbose">
+ * <li><b>As a {@link java.util.Map}</b><br>
* The {@link org.apache.sis.metadata.MetadataStandard} class provides
various methods returning a view
* of an arbitrary metadata implementation as a {@code Map}, where the
key are the property names and the
* values are the return values, types or descriptions of getter
methods. The map is writable if the
* underlying metadata implementation has setter methods, otherwise
attempts to set a value throw an
- * {@code UnmodifiableMetadataException}.</p></li>
+ * {@code UnmodifiableMetadataException}.</li>
*
- * <li><p><b>As a {@link org.apache.sis.util.collection.TreeTable}</b><br>
+ * <li><b>As a {@link org.apache.sis.util.collection.TreeTable}</b><br>
* The metadata are organized as a tree. For example the {@code
Citation} metadata contains one or many
* {@code ResponsibleParty} elements, each of them containing a {@code
Contact} element, which contains
* a {@code Telephone} element, <i>etc</i>. For each node, there is many
information that can be displayed
- * in columns:</p>
+ * in columns:
* <ul>
* <li>A description of the element.</li>
* <li>The type of values ({@code String}, {@code double},
<i>etc</i>).</li>
@@ -91,8 +91,8 @@
* <li>The value stored in the element, or the default value.</li>
* </ul></li>
*
- * <li><p><b>As a table record in a database (using {@link
org.apache.sis.metadata.sql})</b><br>
- * It is possible to establish the following mapping between metadata
and a SQL database:</p>
+ * <li><b>As a table record in a database (using {@link
org.apache.sis.metadata.sql})</b><br>
+ * It is possible to establish the following mapping between metadata
and a SQL database:
* <ul>
* <li>Each metadata interface maps to a table of the same name in the
database.</li>
* <li>Each property in the above interface maps to a column of the
same name in the above table.</li>
Modified:
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/ParameterBuilder.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/ParameterBuilder.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/ParameterBuilder.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/ParameterBuilder.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -42,7 +42,7 @@ import static org.apache.sis.util.Argume
* since those properties are specific to the each parameter. Other properties
like codespace,
* version and cardinality are left unchanged because they may be shared by
many parameters.
*
- * <ul>
+ * <ul class="verbose">
* <li><b>{@linkplain DefaultParameterDescriptor#getName() Names}:</b>
* each parameter must have a name, which can be specified by any of the
{@link #addName(CharSequence)
* addName(…)} methods. Parameters can optionally have an arbitrary amount
of aliases, which are also specified
Modified:
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/Builder.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/Builder.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/Builder.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/Builder.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -47,7 +47,7 @@ import java.util.Objects;
*
* <p>This base class provides methods for defining the {@link
IdentifiedObject} properties shown below:</p>
*
- * <ul>
+ * <ul class="verbose">
* <li><b>{@linkplain AbstractIdentifiedObject#getName() Name}:</b>
* each {@code IdentifiedObject} shall have a name, which can be
specified by a call to any of the
* {@link #addName(CharSequence) addName(…)} methods defined in this
class.</li>
@@ -69,7 +69,7 @@ import java.util.Objects;
* The names and identifiers cited in the above table can be built from {@link
CharSequence} given to the
* {@code addName(…)} or {@code addIdentifier(…)} methods combined with the
following properties:
*
- * <ul>
+ * <ul class="verbose">
* <li><b>{@linkplain ImmutableIdentifier#getCodeSpace() Code space}:</b>
* each {@code Identifier} name or code can be local to a code space
defined by an authority.
* Both the authority and code space can be specified by the {@link
#setCodeSpace(Citation, String)} method,
@@ -86,7 +86,8 @@ import java.util.Objects;
*
* {@section Namespaces and scopes}
* The {@code addName(…)} and {@code addIdentifier(…)} methods come in three
flavors:
- * <ul>
+ *
+ * <ul class="verbose">
* <li>The {@link #addIdentifier(String)} and {@link #addName(CharSequence)}
methods combine the given argument
* with the above-cited authority, code space, version and description
information.
* The result is a {@linkplain org.apache.sis.util.iso.DefaultLocalName
local name} or identifier,
Modified:
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/IdentifiedObjects.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/IdentifiedObjects.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/IdentifiedObjects.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/IdentifiedObjects.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -117,7 +117,7 @@ public final class IdentifiedObjects ext
* This method checks first the {@linkplain
AbstractIdentifiedObject#getName() primary name},
* then all {@linkplain AbstractIdentifiedObject#getAlias() aliases} in
their iteration order.
*
- * <ul>
+ * <ul class="verbose">
* <li>If the name or alias implements the {@link Identifier} interface,
* then this method compares the {@linkplain
Identifier#getAuthority()
* identifier authority} against the specified citation using the
Modified:
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultGeodeticDatum.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultGeodeticDatum.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultGeodeticDatum.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultGeodeticDatum.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -60,13 +60,13 @@ import java.util.Objects;
* A recommended alternative, discussed below, is the
<cite>late-binding</cite> approach.
*
* <p>The Bursa-Wolf parameters serve two purposes:</p>
- * <ol>
- * <li><p><b>Fallback for datum shifts</b><br>
+ * <ol class="verbose">
+ * <li><b>Fallback for datum shifts</b><br>
* There is different methods for transforming coordinates from one
geodetic datum to an other datum,
* and Bursa-Wolf parameters are used with some of them. However different
set of parameters may exist
* for the same pair of (<var>source</var>, <var>target</var>) datum, so
it is often not sufficient to
* know those datum. The (<var>source</var>, <var>target</var>) pair of
CRS are often necessary,
- * sometime together with the geographic extent of the coordinates to
transform.</p>
+ * sometime together with the geographic extent of the coordinates to
transform.
*
* <p>Apache SIS searches for datum shift methods (including Bursa-Wolf
parameters) in the EPSG database when a
* {@link org.opengis.referencing.operation.CoordinateOperation} or a
@@ -77,13 +77,13 @@ import java.util.Objects;
* then the {@code BursaWolfParameters} associated to the datum may be
used as a fallback.</p>
* </li>
*
- * <li><p><b>WKT version 1 formatting</b><br>
+ * <li><b>WKT version 1 formatting</b><br>
* The Bursa-Wolf parameters association serves an other purpose: when a
CRS is formatted in the older
* <cite>Well Known Text</cite> (WKT 1) format, the formatted string may
contain a {@code TOWGS84[…]} element
* with the parameter values of the transformation to the WGS 84 datum.
This element is provided as a help
* for other Geographic Information Systems that support only the
<cite>early-binding</cite> approach.
* Apache SIS usually does not need the {@code TOWGS84} element, except as
a fallback for datum that
- * do not exist in the EPSG database.</p>
+ * do not exist in the EPSG database.
* </li>
* </ol>
*
Modified:
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultOperationMethod.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultOperationMethod.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultOperationMethod.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultOperationMethod.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -373,7 +373,7 @@ public class DefaultOperationMethod exte
* Returns an operation method with different dimensions, if we are
allowed to change dimensionality.
* The need to change an {@code OperationMethod} dimensionality may occur
in two contexts:
*
- * <ul>
+ * <ul class="verbose">
* <li>When the original method can work with any number of dimensions.
Those methods do not know
* in advance the number of dimensions, which is fixed only after the
actual {@link MathTransform}
* instance has been created.
@@ -385,7 +385,7 @@ public class DefaultOperationMethod exte
*
* This {@code redimension(…)} implementation performs the following
choice:
*
- * <ul>
+ * <ul class="verbose">
* <li>If the given method is an instance of {@code
DefaultOperationMethod}, then delegate to
* {@link #redimension(int, int)} in order to allow subclasses to
defines their own policy.
* For example the <cite>Molodensky</cite> method needs to
override.</li>
@@ -470,20 +470,20 @@ public class DefaultOperationMethod exte
* Returns the base interface of the {@code CoordinateOperation} instances
that use this method.
* The base {@code CoordinateOperation} interface is usually one of the
following subtypes:
*
- * <ul>
- * <li><p>{@link org.opengis.referencing.operation.Transformation}
+ * <ul class="verbose">
+ * <li>{@link org.opengis.referencing.operation.Transformation}
* if the coordinate operation has some errors (typically of a few
metres) because of the empirical process by
* which the operation parameters were determined. Those errors do not
depend on the floating point precision
- * or the accuracy of the implementation algorithm.</p></li>
- * <li><p>{@link org.opengis.referencing.operation.Conversion}
+ * or the accuracy of the implementation algorithm.</li>
+ * <li class="verbose">{@link
org.opengis.referencing.operation.Conversion}
* if the coordinate operation is theoretically of infinite precision,
ignoring the limitations of floating
- * point arithmetic (including rounding errors) and the approximations
implied by finite series expansions.</p></li>
- * <li><p>{@link org.opengis.referencing.operation.Projection}
+ * point arithmetic (including rounding errors) and the approximations
implied by finite series expansions.</li>
+ * <li>{@link org.opengis.referencing.operation.Projection}
* if the coordinate operation is a conversion (as defined above)
converting geodetic latitudes and longitudes
* to plane (map) coordinates. This type can optionally be refined
with one of the
* {@link org.opengis.referencing.operation.CylindricalProjection},
* {@link org.opengis.referencing.operation.ConicProjection} or
- * {@link org.opengis.referencing.operation.PlanarProjection}
subtypes.</p></li>
+ * {@link org.opengis.referencing.operation.PlanarProjection}
subtypes.</li>
* </ul>
*
* In case of doubt, {@code getOperationType()} can conservatively return
the base type.
Modified:
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/package-info.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/package-info.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/package-info.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/package-info.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -41,20 +41,20 @@
*
*
* {@section Definition of terms}
- * <ul>
- * <li><p><b>Coordinate operation</b><br>
+ * <ul class="verbose">
+ * <li><b>Coordinate operation</b><br>
* In the particular case of this package, the conversion of geographic
coordinates in any
* axis order, geodesic orientation and angular units to projected
coordinates in any axis
- * order, horizontal orientation and linear units.<p></li>
- * <li><p><b>Map projection</b> (a.k.a. cartographic projection)<br>
+ * order, horizontal orientation and linear units.</li>
+ * <li><b>Map projection</b> (a.k.a. cartographic projection)<br>
* The conversion of geographic coordinates from (<var>longitude</var>,
<var>latitude</var>)
- * in decimal degrees to projected coordinates (<var>x</var>,
<var>y</var>) in metres.<p></li>
- * <li><p><b>Unitary projection</b><br>
+ * in decimal degrees to projected coordinates (<var>x</var>,
<var>y</var>) in metres.</li>
+ * <li><b>Unitary projection</b><br>
* The conversion of geographic coordinates from (<var>longitude</var>,
<var>latitude</var>)
* in radians to projected coordinates (<var>x</var>, <var>y</var>) on a
sphere or ellipse
* having a semi-major axis length of 1. This definition may be slightly
relaxed if some
* projection-specifics coefficients are concatenated with the
conversions that take place
- * between the above map projection and this unitary projection.<p></li>
+ * between the above map projection and this unitary projection.</li>
* </ul>
*
*
Modified:
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -50,8 +50,8 @@ import static org.apache.sis.util.Argume
* This object is typically created and used as below:
*
* <ol>
- * <li>A {@link
MathTransformProvider#createMathTransform(ParameterValueGroup)} method
- * instantiates a class from the {@link
org.apache.sis.referencing.operation.projection} package.
+ * <li>A {@link
MathTransformProvider#createMathTransform(ParameterValueGroup)} method
instantiates a
+ * class from the {@linkplain
org.apache.sis.referencing.operation.projection map projection package}.
* Note that different {@code MathTransformProvider}s may instantiate the
same map projection class.
* For example both <cite>"Mercator (variant A)"</cite> and
<cite>"Mercator (variant B)"</cite> operation methods
* instantiate the same {@link
org.apache.sis.referencing.operation.Mercator} class, but with different
descriptors.</li>
Modified:
sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/package-info.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/package-info.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/package-info.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/package-info.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -28,15 +28,14 @@
*
* <p>This package includes:</p>
*
- * <ul>
- * <li>JAXB adapters for primitive types.
+ * <ul class="verbose">
+ * <li><b>JAXB adapters for primitive types.</b><br>
* JAXB can write directly Java primitive type at marshalling time "as is".
However ISO-19139
* requires those values to be surrounded by elements representing the data
type. The role of
* these adapters is to add these elements around the value.</li>
*
- * <li>JAXB adapters for <cite>unit of measure</cite> as specified in the
ISO-19103
- * specifications. For example, a measure marshalled with JAXB will be
formatted like
- * {@code <gco:Measure uom="m">220.0</gco:Measure>}.</li>
+ * <li><b>JAXB adapters for <cite>unit of measure</cite></b> as specified in
the ISO-19103 specifications.<br>
+ * For example, a measure marshalled with JAXB will be formatted like {@code
<gco:Measure uom="m">220.0</gco:Measure>}.</li>
*
* <li>JAXB adapters for date and time.</li>
* </ul>
@@ -49,14 +48,14 @@
* {@link org.apache.sis.internal.jaxb.metadata} and similar packages.
*
* {@section Object identification and reference}
- * <ul>
- * <li><p><code>org.apache.sis.<b>metadata.iso</b></code> public
packages:</p>
+ * <ul class="verbose">
+ * <li><code>org.apache.sis.<b>metadata.iso</b></code> public packages:
* <ul>
* <li>Implement the ISO 19139 {@code Foo_Type}, where <var>Foo</var> is
the ISO name of a class.</li>
* <li>Contains the {@code gco:ObjectIdentification} group of attributes
({@code id}, {@code uuid}).</li>
* <li>Conceptually could have been subclasses of {@code
ObjectIdentification} defined in this package.</li>
* </ul></li>
- * <li><p><code>org.apache.sis.<b>internal.jaxb</b></code> private
packages:</p>
+ * <li><code>org.apache.sis.<b>internal.jaxb</b></code> private packages:
* <ul>
* <li>Implement the ISO 19139 {@code Foo_PropertyType} as subclasses of
the {@link org.apache.sis.internal.jaxb.gco.PropertyType} class.</li>
* <li>Contains the {@code gco:ObjectReference} group of attributes
({@code xlink}, {@code uuidref}).</li>
Modified:
sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/CorruptedObjectException.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/CorruptedObjectException.java?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
---
sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/CorruptedObjectException.java
[UTF-8] (original)
+++
sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/CorruptedObjectException.java
[UTF-8] Fri Mar 20 14:31:22 2015
@@ -33,21 +33,21 @@ package org.apache.sis.util;
* illustrated in the use cases below.</p></div>
*
* Some use cases for this exception are:
- * <ul>
- * <li><p><b>Attempt to use an aborted calculation:</b>
+ * <ul class="verbose">
+ * <li><b>Attempt to use an aborted calculation:</b><br>
* if an operation failed in the middle of a structural modification, some
specific exception (<strong>not</strong>
* this {@code CorruptedObjectException}) should be thrown and the object
discarded. But if the user does not discard
* the object and try to use it again, unpredictable behavior may happen.
Some implementations are robust enough for
* detecting such unsafe usage: their methods may throw this {@code
CorruptedObjectException} on attempt to use the
- * object after the original failure.</p></li>
+ * object after the original failure.</li>
*
- * <li><p><b>Change in an “immutable” object:</b>
+ * <li><b>Change in an “immutable” object:</b><br>
* some objects are expected to be immutable. For example the same
Coordinate Reference System (CRS) instance is
* typically shared by thousands of objects. However {@link
org.opengis.referencing.crs.CoordinateReferenceSystem}
* is an interface, Therefore, nothing prevent users from providing a
mutable instance. For example if the value
* returned by {@link
org.opengis.referencing.cs.CoordinateSystem#getDimension()} changes between two
invocations,
* many objects that use that coordinate system will fall in an inconsistent
state. If an operation detects such
- * inconsistency, it may throw this {@code
CorruptedObjectException}.</p></li>
+ * inconsistency, it may throw this {@code CorruptedObjectException}.</li>
* </ul>
*
* {@section Exception cause}
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=1668031&r1=1668030&r2=1668031&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 14:31:22 2015
@@ -350,7 +350,7 @@ public final class NilReason implements
* Returns an object of the given type which is nil for the reason
represented by this instance.
* The {@code type} argument can be one of the following cases:
*
- * <ul>
+ * <ul class="verbose">
* <li>An <strong>interface</strong>: in such case, this method returns
an object which implement the given
* interface together with the {@link NilObject} and {@link
LenientComparable} interfaces:
* <ul>
Modified: sis/branches/JDK8/src/main/javadoc/stylesheet.css
URL:
http://svn.apache.org/viewvc/sis/branches/JDK8/src/main/javadoc/stylesheet.css?rev=1668031&r1=1668030&r2=1668031&view=diff
==============================================================================
--- sis/branches/JDK8/src/main/javadoc/stylesheet.css (original)
+++ sis/branches/JDK8/src/main/javadoc/stylesheet.css Fri Mar 20 14:31:22 2015
@@ -174,23 +174,49 @@ div.block ul,
div.block ol {
margin-top: 9px;
margin-bottom: 9px;
+ text-align: left;
}
div.block ul > li,
div.block ol > li {
margin-top: 0;
- margin-bottom: 6px;
+ margin-bottom: 3px;
+}
+
+div.block ul.verbose > li,
+div.block ol.verbose > li {
+ margin-top: 9px;
+ margin-bottom: 9px;
+ text-align: justify;
}
-ul.verbose li {
- margin-top: 6px;
+/*
+ * Reduce the space for sublists.
+ */
+div.block ul > li > ul,
+div.block ol > li > ul {
+ margin-top: 3px;
margin-bottom: 6px;
+ text-align: left;
}
+div.block ul > li > ul > li,
+div.block ol > li > ul > li {
+ margin-top: 0;
+ margin-bottom: 0;
+}
+
+/*
+ * Miscellaneous.
+ */
span.deprecated {
text-decoration: line-through;
}
+div.block {
+ text-align: justify;
+}
+
/* ----------------------------------------------------------------------
