Author: desruisseaux Date: Sat Oct 20 05:56:01 2012 New Revision: 1400376 URL: http://svn.apache.org/viewvc?rev=1400376&view=rev Log: Consistent indentation of notes.
Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/util/ReferenceQueueConsumer.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/math/MathFunctions.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/CharSequences.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/Workaround.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedArrayList.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashMap.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashSet.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/PerformanceLevel.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/XLink.java Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/util/ReferenceQueueConsumer.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/util/ReferenceQueueConsumer.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/util/ReferenceQueueConsumer.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/util/ReferenceQueueConsumer.java Sat Oct 20 05:56:01 2012 @@ -80,8 +80,8 @@ public final class ReferenceQueueConsume * It will run only only a few nanoseconds every time a new {@link Reference} is enqueued. * * {@note We give to this thread a priority higher than the normal one since this thread shall - * execute only tasks to be completed very shortly. Quick execution of those tasks is at the - * benefit of the rest of the system, since they make more resources available sooner.} + * execute only tasks to be completed very shortly. Quick execution of those tasks is at + * the benefit of the rest of the system, since they make more resources available sooner.} */ private ReferenceQueueConsumer(final DaemonThread lastCreatedDaemon) { super(Threads.DAEMONS, "ReferenceQueueConsumer", lastCreatedDaemon); Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/math/MathFunctions.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/math/MathFunctions.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/math/MathFunctions.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/math/MathFunctions.java Sat Oct 20 05:56:01 2012 @@ -122,8 +122,8 @@ public final class MathFunctions extends * change in any future Apache SIS version. * * {@note The current value is the highest prime number representable as an unsigned 16 bits - * integer. This is enough for current needs because 16 bits prime numbers are sufficient for - * finding the divisors of any 32 bits integers.} + * integer. This is enough for current needs because 16 bits prime numbers are sufficient + * for finding the divisors of any 32 bits integers.} * * @see #nextPrimeNumber(int) */ @@ -228,10 +228,11 @@ public final class MathFunctions extends * sometime at the cost of performance. * * {@note This method has been defined because the standard <code>Math.pow(10, x)</code> - * method does not always return the closest IEEE floating point representation. Slight - * departures (1 or 2 ULP) are often allowed in math functions for performance reasons. - * The most accurate calculations are usually not necessary, but the base 10 is a special - * case since it is used for scaling axes or formatting human-readable output.} + * method does not always return the closest IEEE floating point representation. + * Slight departures (1 or 2 ULP) are often allowed in math functions for performance + * reasons. The most accurate calculations are usually not necessary, but the base 10 + * is a special case since it is used for scaling axes or formatting human-readable + * output.} * * @param x The exponent. * @return 10 raised to the given exponent. Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/CharSequences.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/CharSequences.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/CharSequences.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/CharSequences.java Sat Oct 20 05:56:01 2012 @@ -423,11 +423,12 @@ search: for (; fromIndex <= stopAt; * this method does not remove whitespaces.</p> * * {@note Prior JDK8 this method was relatively cheap because all string instances created by - * <code>String.substring(int,int)</code> shared the same <code>char[]</code> internal array. - * However since JDK8, the new <code>String</code> implementation copies the data in new arrays. - * Consequently it is better to use index rather than this method for splitting large - * <code>String</code>s. However this method still useful for other <code>CharSequence</code> - * implementations providing an efficient <code>subSequence(int,int)</code> method.} + * <code>String.substring(int,int)</code> shared the same <code>char[]</code> internal + * array. However since JDK8, the new <code>String</code> implementation copies the data + * in new arrays. Consequently it is better to use index rather than this method for + * splitting large <code>String</code>s. However this method still useful for other + * <code>CharSequence</code> implementations providing an efficient + * <code>subSequence(int,int)</code> method.} * * @param text The multi-line text from which to get the individual lines, or {@code null}. * @return The lines in the text, or an empty array if the given text was null. Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/Workaround.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/Workaround.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/Workaround.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/Workaround.java Sat Oct 20 05:56:01 2012 @@ -27,9 +27,9 @@ import java.lang.annotation.RetentionPol * This is marker annotation for source code only, in order to keep trace of code to revisit * when new versions of external libraries become available. * - * {@note When only a portion of a method contains a workaround and the annotation can not be - * applied to that specific part, than it is applied to the whole method. Developers need to - * refer to code comments in order to locate the specific part.} + * {@note When only a portion of a method contains a workaround and the annotation can + * not be applied to that specific part, than it is applied to the whole method. + * Developers need to refer to code comments in order to locate the specific part.} * * @author Martin Desruisseaux (Geomatys) * @since 0.3 (derived from geotk-3.15) Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedArrayList.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedArrayList.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedArrayList.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedArrayList.java Sat Oct 20 05:56:01 2012 @@ -52,7 +52,7 @@ import static org.apache.sis.util.Argume * For real concurrency, see the {@link java.util.concurrent} package instead. * * {@note The above is the reason why the name of this class emphases the <cite>checked</cite> - * aspect rather than the <cite>synchronized</cite> aspect of the list.} + * aspect rather than the <cite>synchronized</cite> aspect of the list.} * * @param <E> The type of elements in the list. * Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashMap.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashMap.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashMap.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashMap.java Sat Oct 20 05:56:01 2012 @@ -51,7 +51,7 @@ import static org.apache.sis.util.Argume * For real concurrency, see the {@link java.util.concurrent} package instead. * * {@note The above is the reason why the name of this class emphases the <cite>checked</cite> - * aspect rather than the <cite>synchronized</cite> aspect of the map.} + * aspect rather than the <cite>synchronized</cite> aspect of the map.} * * @param <K> The type of keys in the map. * @param <V> The type of values in the map. @@ -119,9 +119,9 @@ public class CheckedHashMap<K,V> extends * be modified. Subclasses can override this method if they want to control write permissions.</p> * * {@note Actually the current implementation contains an <code>assert</code> statement - * ensuring that the thread holds the lock. This is an implementation details that may - * change in any future version of the SIS library. Nevertheless methods that override - * this one are encouraged to invoke <code>super.checkWritePermission()</code>.} + * ensuring that the thread holds the lock. This is an implementation details that may + * change in any future version of the SIS library. Nevertheless methods that override + * this one are encouraged to invoke <code>super.checkWritePermission()</code>.} * * @throws UnsupportedOperationException if this map is unmodifiable. */ Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashSet.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashSet.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashSet.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/collection/CheckedHashSet.java Sat Oct 20 05:56:01 2012 @@ -51,7 +51,7 @@ import static org.apache.sis.util.Argume * For real concurrency, see the {@link java.util.concurrent} package instead. * * {@note The above is the reason why the name of this class emphases the <cite>checked</cite> - * aspect rather than the <cite>synchronized</cite> aspect of the set.} + * aspect rather than the <cite>synchronized</cite> aspect of the set.} * * @param <E> The type of elements in the set. * @@ -144,9 +144,9 @@ public class CheckedHashSet<E> extends L * be modified. Subclasses can override this method if they want to control write permissions.</p> * * {@note Actually the current implementation contains an <code>assert</code> statement - * ensuring that the thread holds the lock. This is an implementation details that may - * change in any future version of the SIS library. Nevertheless methods that override - * this one are encouraged to invoke <code>super.checkWritePermission()</code>.} + * ensuring that the thread holds the lock. This is an implementation details that may + * change in any future version of the SIS library. Nevertheless methods that override + * this one are encouraged to invoke <code>super.checkWritePermission()</code>.} * * @throws UnsupportedOperationException if this set is unmodifiable. */ Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java Sat Oct 20 05:56:01 2012 @@ -97,8 +97,9 @@ public final class Logging extends Stati * The children {@link Logging} objects. * * {@note The array used there is not efficient for adding new items (<code>ArrayList</code> - * would be more efficient), but we assume that very few new items will be added. Furthermore - * a plain array is efficient for reading, and the later is way more common than the former.} + * would be more efficient), but we assume that very few new items will be added. + * Furthermore a plain array is efficient for reading, and the later is way more + * common than the former.} */ private Logging[] children = EMPTY; Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/PerformanceLevel.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/PerformanceLevel.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/PerformanceLevel.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/logging/PerformanceLevel.java Sat Oct 20 05:56:01 2012 @@ -148,8 +148,8 @@ public final class PerformanceLevel exte * </ul> * * {@note The duration of the <code>PERFORMANCE</code> level can not be modified: it is - * always zero. However invoking this method on the <code>PERFORMANCE</code> field will - * ensure that every <code>SLOW*</code> levels will have at least the given duration.} + * always zero. However invoking this method on the <code>PERFORMANCE</code> field will + * ensure that every <code>SLOW*</code> levels will have at least the given duration.} * * @param duration The minimal duration. * @param unit The unit of the given duration value. Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/util/resources/package-info.java Sat Oct 20 05:56:01 2012 @@ -32,14 +32,14 @@ * </ul> * * {@note <code>java.util.Formatter</code> is an alternative to <code>MessageFormat</code> providing - * similar functionalities with a C/C++ like syntax. However <code>MessageFormat</code> has two - * advantages: it provides a <code>choice</code> format type (useful for handling plural forms), - * and localizes properly objects of unspecified type (by contrast, the <code>Formatter</code> - * <code>"%s"</code> type always invoke <code>toString()</code>). The later advantage is - * important for messages in wich the same argument could receive <code>Number</code> or - * <code>Date</code> instances as well as <code>String</code>. - * Furthermore, the <code>java.util.logging</code> framework is designed for use with - * <code>MessageFormat</code> (see the <code>Formatter.formatMessage(LogRecord)</code> method).} + * similar functionalities with a C/C++ like syntax. However <code>MessageFormat</code> has two + * advantages: it provides a <code>choice</code> format type (useful for handling plural forms), + * and localizes properly objects of unspecified type (by contrast, the <code>Formatter</code> + * <code>"%s"</code> type always invoke <code>toString()</code>). The later advantage is + * important for messages in wich the same argument could receive <code>Number</code> or + * <code>Date</code> instances as well as <code>String</code>. + * Furthermore, the <code>java.util.logging</code> framework is designed for use with + * <code>MessageFormat</code> (see the <code>Formatter.formatMessage(LogRecord)</code> method).} * * Apache SIS developers can add resources by editing the {@code *.properties} file * in the source code directory, then run the localized resources compiler provided in the Modified: sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/XLink.java URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/XLink.java?rev=1400376&r1=1400375&r2=1400376&view=diff ============================================================================== --- sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/XLink.java (original) +++ sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/XLink.java Sat Oct 20 05:56:01 2012 @@ -440,8 +440,8 @@ public class XLink implements Serializab * identifier. * * {@note This serves a role similar to <code>idref</code>. The <code>idref</code> - * attribute allows an XML element to refer to another XML element that has a - * corresponding <code>id</code> attribute.} + * attribute allows an XML element to refer to another XML element that has + * a corresponding <code>id</code> attribute.} * * @return A URN to a resources, or {@code null}Â if none. *