Author: psteitz Date: Sun Sep 11 10:15:08 2005 New Revision: 280152 URL: http://svn.apache.org/viewcvs?rev=280152&view=rev Log: Javadoc only. Change UUID referenced to RFC 4122. PR# 35820 Submitted by Jukka Zitting Also fixed numerous javadoc errors.
Modified: jakarta/commons/sandbox/id/trunk/project.xml jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java Modified: jakarta/commons/sandbox/id/trunk/project.xml URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/project.xml?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/project.xml (original) +++ jakarta/commons/sandbox/id/trunk/project.xml Sun Sep 11 10:15:08 2005 @@ -73,7 +73,7 @@ <developer> <name>Phil Steitz</name> <id>psteitz</id> - <email>[EMAIL PROTECTED]</email> + <email>psteitz at apache dot org</email> <organization></organization> <timezone>-9</timezone> <roles> @@ -103,12 +103,6 @@ </developers> <contributors> - <contributor> - <name>Rory Winston</name> - <id>rwinston</id> - <email>[EMAIL PROTECTED]</email> - <organization></organization> - </contributor> <contributor> <name>Eric Crampton</name> <email></email> @@ -119,6 +113,15 @@ <email></email> <organization></organization> </contributor> + <contributor> + <name>Rory Winston</name> + <id>rwinston</id> + <email>[EMAIL PROTECTED]</email> + <organization></organization> + </contributor> + <contributor> + <name>Jukka Zitting</name> + </contributor> </contributors> <dependencies> Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java Sun Sep 11 10:15:08 2005 @@ -21,7 +21,6 @@ * * @author Commons-Id Team * @version $Id$ - * [EMAIL PROTECTED] http://jakarta.apache.org/turbine/turbine-2.3/} */ public final class Bytes { Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java Sun Sep 11 10:15:08 2005 @@ -27,11 +27,10 @@ /** - * <p><code>UUID</code> represents a Universally Unique Identifier per IETF - * Draft specification. For more information regarding the IETF Draft UUID - * specification</p> - * - * <p>See: http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-01.txt</p> + * <p><code>UUID</code> represents a Universally Unique Identifier per RFC 4122. + * See the <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122: + * A Universally Unique IDentifier (UUID) URN Namespace</a> + * for more information.</p> * * @author Commons-Id Team * @version $Revision$ $Date$ @@ -252,7 +251,7 @@ } /** - * <p>Compares two UUID's for equality</p> + * <p>Compares two UUID's for equality.</p> * * @see Comparable#compareTo(Object) */ Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java Sun Sep 11 10:15:08 2005 @@ -20,7 +20,6 @@ * string does not have the appropriate format.</p> * * @see UUID#toString() - * @see UUID#parseString(String) * @see UUID#UUID(String) * * @author Commons-Id Team Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java Sun Sep 11 10:15:08 2005 @@ -23,8 +23,8 @@ import org.apache.commons.id.IdentifierGenerator; /** - * <p>Class is responsible for generating version 4 UUID's per the IETF draft - * specification. This class attempts to use a java.security.SecureRandom with + * <p>Class is responsible for generating version 4 UUID's per RFC 4122. + * This class attempts to use a java.security.SecureRandom with * the following instantiation * <code>SecureRandom.getInstance("SHA1PRNG", "SUN")</code>. If neither secure * random implementation is avialable or an Exception is raised a java.util.Random Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java Sun Sep 11 10:15:08 2005 @@ -23,12 +23,14 @@ import org.apache.commons.id.uuid.state.Node; /** - * Class is responsible for generating version 1 UUID's per the IETF draft - * specification. This class attempts to locate the machine's node identifier + * Class is responsible for generating version 1 UUID's per RFC 4122. + * This class attempts to locate the machine's node identifier * first by attempting to loading the properties file UUID.properties * from the system classpath. If the UUID.properties file does not exist * then the generator will create a node identifier from random information as - * defined in the IEFT UUID Draft specification. + * defined in the + * <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122: + * A Universally Unique IDentifier (UUID) URN Namespace</a>. * * @author Commons-Id team * @version $Revision$ $Date$ Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java Sun Sep 11 10:15:08 2005 @@ -18,13 +18,14 @@ /** - * <p>Clock.java provides a timing mechanism for returning the current time in - * 100-nano second intervals since 00:00:00.00, 15 October 1582</p> + * <p>Provides a timing mechanism for returning the current time in + * 100-nano second intervals since 00:00:00.00, 15 October 1582.</p> * * <p>As described below this is useful for generating Version 1 UUIDs</p> * - * <p>For more information regarding the IETF Draft UUID specification - * see http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-01.txt</p> + * <p>See the <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122: + * A Universally Unique IDentifier (UUID) URN Namespace</a> + * for more information.</p> * * <p>Selected quotes from IETF document pertaining to this class:</p> * @@ -36,51 +37,38 @@ * nanosecond intervals since 00:00:00.00, 15 October 1582 (the date of * Gregorian reform to the Christian calendar)."</dd> * - * <dt>Clock Adjustment</dt> - * <dd>"UUIDs may be created at a rate greater than the system clock resolution. - * Therefore, the system must also maintain an adjustment value to be added to - * the lower-order bits of the time. Logically, each time the system clock - * ticks, the adjustment value is cleared. Every time a UUID is generated, - * the current adjustment value is read and incremented atomically, then added - * to the UTC time field of the UUID."</dd> - * - * <dt>Clock Overrun</dt> - * <dd>"The 100 nanosecond granularity of time should prove sufficient even for - * bursts of UUID creation in the next generation of high-performance - * multiprocessors. If a system overruns the clock adjustment by requesting - * too many UUIDs within a single system clock tick, the UUID service may - * raise an exception, handled in a system or process-dependent manner - * either by: - * terminating the request - * reissuing the request until it succeeds - * stalling the UUID generator until the system clock catches up. - * <br>...<br> - * If the processors overrun the UUID generation frequently, additional node - * identifiers and clocks may need to be added."</dd> + * <dt>System Clock Resolution</dt> + * <dd>"If a system overruns the generator by requesting too many UUIDs + * within a single system time interval, the UUID service MUST either + * return an error, or stall the UUID generator until the system clock + * catches up.<br> + * <br> + * A high resolution timestamp can be simulated by keeping a count of + * the number of UUIDs that have been generated with the same value of + * the system time, and using it to construct the low order bits of the + * timestamp. The count will range between zero and the number of + * 100-nanosecond intervals per system time interval.<br> + * <br> + * Note: If the processors overrun the UUID generation frequently, + * additional node identifiers can be allocated to the system, which + * will permit higher speed allocation by making multiple UUIDs + * potentially available for each time stamp value."</dd> * * <p>The above quotations are protected under the following copyright notice </p> - * <p><code>Copyright (C) The Internet Society (2003). All Rights Reserved. - * This document and translations of it may be copied and furnished to - * others, and derivative works that comment on or otherwise explain it - * or assist in its implementation may be prepared, copied, published - * and distributed, in whole or in part, without restriction of any - * kind, provided that the above copyright notice and this paragraph are - * included on all such copies and derivative works. However, this - * document itself may not be modified in any way, such as by removing - * the copyright notice or references to the Internet Society or other - * Internet organizations, except as needed for the purpose of - * developing Internet standards in which case the procedures for - * copyrights defined in the Internet Standards process must be - * followed, or as required to translate it into languages other than - * English.</p> - * <p>The limited permissions granted above are perpetual and will not be - * revoked by the Internet Society or its successors or assignees. - * This document and the information contained herein is provided on an - * "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING - * TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING - * BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION - * HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF - * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</code></p> + * <p><code>Copyright (C) The Internet Society (2005).<br> + * <br> + * This document is subject to the rights, licenses and restrictions + * contained in BCP 78, and except as set forth therein, the authors + * retain all their rights.<br> + * <br> + * This document and the information contained herein are provided on an + * "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS + * OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET + * ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, + * INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE + * INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED + * WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + * </code></p> * * ==================================================================== * Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java Sun Sep 11 10:15:08 2005 @@ -21,7 +21,7 @@ * current time in 100-nano second intervals since 00:00:00.00, 15 October 1582. * </p> * - * @see org.apache.commons.uid.uuid.Clock + * @see org.apache.commons.id.uuid.clock.Clock * @author Commons-Id Team * @version $Revision$ $Date$ */ @@ -40,7 +40,7 @@ super(); } - /** @see org.apache.commons.uid.uuid#getCurrentTime() */ + /** @see org.apache.commons.id.uuid.clock.Clock#getUUIDTime() */ public long getUUIDTime() throws OverClockedException { return getTimeSynchronized(); } Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java Sun Sep 11 10:15:08 2005 @@ -18,19 +18,17 @@ /** - * Clock.java provides a timing mechanism for returning the current time in - * 100-nano second intervals since 00:00:00.00, 15 October 1582 + * <p>[EMAIL PROTECTED] Clock} provides a timing mechanism for returning the current time in + * 100-nano second intervals since 00:00:00.00, 15 October 1582.</p> * - * @see org.apache.commons.uid.uuid.Clock - * - * This Class consumes a single thread which will die off if not utilized before + * <p>This Class consumes a single thread which will die off if not utilized before * the expiration. Subsequent calls after a thread expires start a new thread. * Compensates for jvm time resolution issues. This clock should be used in * instances where the system resolution does not perform adequately - the * clocking resolution on some windows virtual machines can range from 10 to 50 * milliseconds before the System.currentTimeMillis changes. In instances where * 10,000 or more uuid's may be generated in a millisecond this Clock - * implementation may be required. + * implementation may be required.</p> * * @author Commons-Id Team * @version $Revision$ $Date$ Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html Sun Sep 11 10:15:08 2005 @@ -24,8 +24,8 @@ general; the Clock interface is introduced to allow different or custom strategies in timestamp generation. The IETF (Internet Engineering Task Force) specification details some of these approaches. For more information see - <a href="http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-02.txt"> - IETF Draft UUID specification</a>. + the <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122: + A Universally Unique IDentifier (UUID) URN Namespace</a>. </p> <p> Two provided implementation are: Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html Sun Sep 11 10:15:08 2005 @@ -15,13 +15,14 @@ --> <body> <p> - <p> This package contains UUID (Universally Unique Identifier) - generator implementations and supporting classes. A UUID is 128-bits - long and can provide an extremely high likelihood of uniqueness. For more - information see the Internet Engineering Task Force - <a href="http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-03.txt"> - IETF Draft UUID specification</a>. + generator implementations and supporting classes. + </p> + <p> + A UUID is 128-bits long and can provide an extremely high likelihood + of uniqueness. For more information see the Internet Engineering Task + Force <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122: + A Universally Unique IDentifier (UUID) URN Namespace</a>. </p> <p> The version 1 uuid generator collaborates with various interfaces that Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java Sun Sep 11 10:15:08 2005 @@ -20,8 +20,9 @@ import java.util.Set; /** - * <p>The <code>InMemoryStateImpl</code> is an implementation of the <code>State</code> - * interface. This implementation is the <b>worst-case</b> scenario and provides + * <p>The <code>InMemoryStateImpl</code> is an implementation of the + * <code>State</code> interface.</p> + * <p>This implementation is the <b>worst-case</b> scenario and provides * the least guarantee of no UUID duplication. This implementation is provided for * systems that truly have no other means of writing to or reading from stable * storage.</p> @@ -43,7 +44,7 @@ } /** - * @see org.apache.commons.id.uuid.state.State#getNode() + * @see org.apache.commons.id.uuid.state.State#getNodes() */ public Set getNodes() { return nodes; Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java Sun Sep 11 10:15:08 2005 @@ -56,7 +56,7 @@ public static final String CONFIG_FILENAME_KEY = "org.apache.commons.id.uuid.config.resource.filename"; /** - * <p>Constructs a ReadOnlyResouceStateImpl</p> + * <p>Constructs a ReadOnlyResouceStateImpl.</p> */ public ReadOnlyResourceStateImpl() { super(); @@ -137,7 +137,7 @@ } /** - * @see org.apache.commons.id.uuid.state.State#store(java.util.Collection) + * @see org.apache.commons.id.uuid.state.State#store(java.util.Set) */ public void store(Set nodeSet) throws IOException { // Nothing to do - this is a ReadOnly implementation. @@ -145,7 +145,7 @@ } /** - * @see org.apache.commons.id.uuid.state.State#store(java.util.Collection, long) + * @see org.apache.commons.id.uuid.state.State#store(java.util.Set, long) */ public void store(Set nodeSet, long timestamp) { // Nothing to do - this is a ReadOnly implementation. Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java Sun Sep 11 10:15:08 2005 @@ -37,7 +37,7 @@ /** * Persists the UUID generator state to file. * - * @see org.apache.commons.id.uuid.state.State#store(java.util.Collection) + * @see org.apache.commons.id.uuid.state.State#store(java.util.Set) */ public void store(Set nodes) throws IOException { writeXML(genXML(nodes)); Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java Sun Sep 11 10:15:08 2005 @@ -57,7 +57,7 @@ Set getNodes( ); /** - * <p>Stores the state information</p> + * <p>Stores the state information.</p> * * <p>To increase the quality of the UUID uniqueness, a system that may * write to stable storage SHOULD perist the state of the UUIDGenerator in Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java?rev=280152&r1=280151&r2=280152&view=diff ============================================================================== --- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java (original) +++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java Sun Sep 11 10:15:08 2005 @@ -35,7 +35,7 @@ /** * <p><code>StateHelper</code> provides helper methods for the uuid state - * implementations</p> + * implementations.</p> * * @author Commons-Id team * @version $Id$ @@ -204,9 +204,9 @@ /** * <p>Utility method decodes a valid MAC address in the form of - * XX-XX-XX-XX-XX-XX where each XX represents a hexidecimal value. Returns - * null if the address can not be decoded. - * </p> + * XX-XX-XX-XX-XX-XX where each XX represents a hexidecimal value.</p> + * + * <p> Returns null if the address can not be decoded. </p> * * @param address the String hexidecimal dash separated MAC address. * @return a byte array representing the the address. Null if not a valid address. --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]