Return-Path: Delivered-To: apmail-jakarta-commons-dev-archive@www.apache.org Received: (qmail 81719 invoked from network); 11 Sep 2005 17:15:35 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 11 Sep 2005 17:15:35 -0000 Received: (qmail 41337 invoked by uid 500); 11 Sep 2005 17:15:23 -0000 Delivered-To: apmail-jakarta-commons-dev-archive@jakarta.apache.org Received: (qmail 41091 invoked by uid 500); 11 Sep 2005 17:15:22 -0000 Mailing-List: contact commons-dev-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Help: List-Post: List-Id: "Jakarta Commons Developers List" Reply-To: "Jakarta Commons Developers List" Delivered-To: mailing list commons-dev@jakarta.apache.org Received: (qmail 41077 invoked by uid 500); 11 Sep 2005 17:15:21 -0000 Received: (qmail 41073 invoked by uid 99); 11 Sep 2005 17:15:21 -0000 X-ASF-Spam-Status: No, hits=-9.8 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.29) with SMTP; Sun, 11 Sep 2005 10:15:18 -0700 Received: (qmail 81527 invoked by uid 65534); 11 Sep 2005 17:15:18 -0000 Message-ID: <20050911171518.81526.qmail@minotaur.apache.org> Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r280152 - in /jakarta/commons/sandbox/id/trunk: ./ src/java/org/apache/commons/id/uuid/ src/java/org/apache/commons/id/uuid/clock/ src/java/org/apache/commons/id/uuid/state/ Date: Sun, 11 Sep 2005 17:15:15 -0000 To: commons-cvs@jakarta.apache.org From: psteitz@apache.org X-Mailer: svnmailer-1.0.5 X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N 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 @@ Phil Steitz psteitz - psteitz@apache.org + psteitz at apache dot org -9 @@ -103,12 +103,6 @@ - - Rory Winston - rwinston - rwinston@eircom.net - - Eric Crampton @@ -119,6 +113,15 @@ + + Rory Winston + rwinston + rwinston@eircom.net + + + + Jukka Zitting + 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$ - * {@link 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 @@ /** - *

UUID represents a Universally Unique Identifier per IETF - * Draft specification. For more information regarding the IETF Draft UUID - * specification

- * - *

See: http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-01.txt

+ *

UUID represents a Universally Unique Identifier per RFC 4122. + * See the RFC 4122: + * A Universally Unique IDentifier (UUID) URN Namespace + * for more information.

* * @author Commons-Id Team * @version $Revision$ $Date$ @@ -252,7 +251,7 @@ } /** - *

Compares two UUID's for equality

+ *

Compares two UUID's for equality.

* * @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.

* * @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; /** - *

Class is responsible for generating version 4 UUID's per the IETF draft - * specification. This class attempts to use a java.security.SecureRandom with + *

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 * SecureRandom.getInstance("SHA1PRNG", "SUN"). 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 + * RFC 4122: + * A Universally Unique IDentifier (UUID) URN Namespace. * * @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 @@ /** - *

Clock.java provides a timing mechanism for returning the current time in - * 100-nano second intervals since 00:00:00.00, 15 October 1582

+ *

Provides a timing mechanism for returning the current time in + * 100-nano second intervals since 00:00:00.00, 15 October 1582.

* *

As described below this is useful for generating Version 1 UUIDs

* - *

For more information regarding the IETF Draft UUID specification - * see http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-01.txt

+ *

See the RFC 4122: + * A Universally Unique IDentifier (UUID) URN Namespace + * for more information.

* *

Selected quotes from IETF document pertaining to this class:

* @@ -36,51 +37,38 @@ * nanosecond intervals since 00:00:00.00, 15 October 1582 (the date of * Gregorian reform to the Christian calendar)." * - *
Clock Adjustment
- *
"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."
- * - *
Clock Overrun
- *
"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. - *
...
- * If the processors overrun the UUID generation frequently, additional node - * identifiers and clocks may need to be added."
+ *
System Clock Resolution
+ *
"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.
+ *
+ * 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.
+ *
+ * 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."
* *

The above quotations are protected under the following copyright notice

- *

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.

- *

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.

+ *

Copyright (C) The Internet Society (2005).
+ *
+ * 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.
+ *
+ * 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. + *

* * ==================================================================== * 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. *

* - * @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 + *

{@link Clock} provides a timing mechanism for returning the current time in + * 100-nano second intervals since 00:00:00.00, 15 October 1582.

* - * @see org.apache.commons.uid.uuid.Clock - * - * This Class consumes a single thread which will die off if not utilized before + *

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.

* * @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 - - IETF Draft UUID specification. + the RFC 4122: + A Universally Unique IDentifier (UUID) URN Namespace.

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 @@ -->

-

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 - - IETF Draft UUID specification. + 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 RFC 4122: + A Universally Unique IDentifier (UUID) URN Namespace.

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; /** - *

The InMemoryStateImpl is an implementation of the State - * interface. This implementation is the worst-case scenario and provides + *

The InMemoryStateImpl is an implementation of the + * State interface.

+ *

This implementation is the worst-case 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.

@@ -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"; /** - *

Constructs a ReadOnlyResouceStateImpl

+ *

Constructs a ReadOnlyResouceStateImpl.

*/ 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( ); /** - *

Stores the state information

+ *

Stores the state information.

* *

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 @@ /** *

StateHelper provides helper methods for the uuid state - * implementations

+ * implementations.

* * @author Commons-Id team * @version $Id$ @@ -204,9 +204,9 @@ /** *

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. - *

+ * XX-XX-XX-XX-XX-XX where each XX represents a hexidecimal value.

+ * + *

Returns null if the address can not be decoded.

* * @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: commons-dev-unsubscribe@jakarta.apache.org For additional commands, e-mail: commons-dev-help@jakarta.apache.org