eclipse-uprotocol · sophokles73 · Sep 18, 2025 · Sep 18, 2025
diff --git a/README.adoc b/README.adoc
@@ -4,7 +4,7 @@
 [.specitem,oft-sid="uman~up-java-readme~1",oft-covers="req~up-language-documentation~1",tags="LanguageLibrary"]
 == Overview
 
-This is the https://github.com/eclipse-uprotocol/uprotocol-spec/blob/v1.6.0-alpha.5/languages.adoc[uProtocol v1.6.0-alpha.5 Language Library] for the Java programming language. The library is organized into packages that are described in <<sdk-packages>> below and organized by the layers of the protocol.
+This is the https://github.com/eclipse-uprotocol/uprotocol-spec/blob/v1.6.0-alpha.6/languages.adoc[uProtocol v1.6.0-alpha.6 Language Library] for the Java programming language. The library is organized into packages that are described in <<sdk-packages>> below and organized by the layers of the protocol.
 
 Each package folder contains a `README.adoc` file that describes the purpose of the package and how to use it.
 
@@ -38,15 +38,15 @@ The following dependency needs to be added to your Maven POM file, setting `${up
 
 | xref:src/main/java/org/eclipse/uprotocol/client/README.adoc[`*client*`]
 | Top level client-facing interfaces to communication with USubscription, UDiscovery, and UTwin services.
-| https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/up-l3/README.adoc[Application Layer (uP-L3)]
+| https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/up-l3/README.adoc[Application Layer (uP-L3)]
 
 | xref:src/main/java/org/eclipse/uprotocol/communication/README.adoc[`*communication*`]
 | Common implementation of communication messaging patterns (publisher, subscriber, RpcClient, RpcServer, etc..) that are built on top of the L1 transport interface (see below).
-| https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/up-l2/api.adoc[Communication Layer (uP-L2)] 
+| https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/up-l2/api.adoc[Communication Layer (uP-L2)] 
 
 | xref:src/main/java/org/eclipse/uprotocol/transport/README.adoc[`*transport*`] 
 | Interface and data model for how to send() and receive() messages in a common way across various transport technologies (ex. zenoh, mqtt, http, etc...). the interface is implemented by transports (ex. up-transport-android-java), and the interface is then used to build the uProtocol layer 2 communication layer implementation.
-| https://github.com/eclipse-uprotocol/uprotocol-spec/blob/v1.6.0-alpha.5/up-l1/README.adoc[Transport Layer (uP-L1)] 
+| https://github.com/eclipse-uprotocol/uprotocol-spec/blob/v1.6.0-alpha.6/up-l1/README.adoc[Transport Layer (uP-L1)] 
 
 | xref:src/main/java/org/eclipse/uprotocol/uri/README.adoc[`*uuri*`]
 | uProtocol addressing scheme (UUri) builders, validators, and serializers. 

diff --git a/src/main/java/org/eclipse/uprotocol/client/usubscription/v3/USubscriptionClient.java b/src/main/java/org/eclipse/uprotocol/client/usubscription/v3/USubscriptionClient.java
@@ -32,7 +32,7 @@
 /**
  * The client-side interface for interacting with a USubscription service instance.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/up-spec/tree/v1.6.0-alpha.5/up-l3/usubscription/v3">
+ * @see <a href="https://github.com/eclipse-uprotocol/up-spec/tree/v1.6.0-alpha.6/up-l3/usubscription/v3">
  * USubscription service specification</a>
  */
 public interface USubscriptionClient {

diff --git a/src/main/java/org/eclipse/uprotocol/cloudevent/README.adoc b/src/main/java/org/eclipse/uprotocol/cloudevent/README.adoc
diff --git a/src/main/java/org/eclipse/uprotocol/communication/Notifier.java b/src/main/java/org/eclipse/uprotocol/communication/Notifier.java
@@ -21,7 +21,7 @@
 /**
  * A client for sending Notification messages to a uEntity.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/up-l2/api.adoc">
+ * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/up-l2/api.adoc">
  * Communication Layer API Specifications</a>
  */
 // [impl->dsn~communication-layer-api-declaration~1]

diff --git a/src/main/java/org/eclipse/uprotocol/communication/Publisher.java b/src/main/java/org/eclipse/uprotocol/communication/Publisher.java
@@ -17,7 +17,7 @@
 /**
  * A client for publishing messages to a topic.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/up-l2/api.adoc">
+ * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/up-l2/api.adoc">
  * Communication Layer API Specifications</a>
  */
 // [impl->dsn~communication-layer-api-declaration~1]

diff --git a/src/main/java/org/eclipse/uprotocol/communication/RpcClient.java b/src/main/java/org/eclipse/uprotocol/communication/RpcClient.java
@@ -19,7 +19,7 @@
 /**
  * A client for performing Remote Procedure Calls (RPC) on (other) uEntities.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/up-l2/api.adoc">
+ * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/up-l2/api.adoc">
  * Communication Layer API specification</a>
  */
 // [impl->dsn~communication-layer-api-declaration~1]

diff --git a/src/main/java/org/eclipse/uprotocol/communication/RpcServer.java b/src/main/java/org/eclipse/uprotocol/communication/RpcServer.java
@@ -21,7 +21,7 @@
 /**
  * A server for exposing Remote Procedure Call (RPC) endpoints.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/up-l2/api.adoc">
+ * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/up-l2/api.adoc">
  * Communication Layer API specification</a>
  */
 // [impl->dsn~communication-layer-api-declaration~1]

diff --git a/src/main/java/org/eclipse/uprotocol/communication/Subscriber.java b/src/main/java/org/eclipse/uprotocol/communication/Subscriber.java
@@ -25,7 +25,7 @@
 /**
  * A client for subscribing to topics.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/up-l2/api.adoc">
+ * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/up-l2/api.adoc">
  * Communication Layer API Specifications</a>
  */
 // [impl->dsn~communication-layer-api-declaration~1]

diff --git a/src/main/java/org/eclipse/uprotocol/transport/UListener.java b/src/main/java/org/eclipse/uprotocol/transport/UListener.java
@@ -19,7 +19,7 @@
  *
  * Implementations contain the details for what should occur when a message is received.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/up-l1/README.adoc">
+ * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/up-l1/README.adoc">
  * uProtocol Transport Layer specification</a>
  */
 // [impl->dsn~ulistener-declaration~1]

diff --git a/src/main/java/org/eclipse/uprotocol/transport/UTransport.java b/src/main/java/org/eclipse/uprotocol/transport/UTransport.java
@@ -26,7 +26,7 @@
  * UTransport implementations contain the details for connecting to the underlying transport technology and
  * sending UMessage using the configured technology.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/up-l1/README.adoc">
+ * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/up-l1/README.adoc">
  * uProtocol Transport Layer specification</a>
  */
 // [impl->dsn~utransport-declaration~1]
@@ -46,7 +46,7 @@ public interface UTransport {
      * <p>
      * The listener will be invoked for each message that matches the given source filter pattern
      * according to the rules defined by the
-     * <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/basics/uri.adoc">UUri
+     * <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/basics/uri.adoc">UUri
      * specification</a>.
      * <p>
      * This default implementation invokes {@link #registerListener(UUri, UUri, UListener)} with the
@@ -67,7 +67,7 @@ default CompletionStage<Void> registerListener(UUri sourceFilter, UListener list
      * <p>
      * The listener will be invoked for each message that matches the given source and sink filter patterns
      * according to the rules defined by the
-     * <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/basics/uri.adoc">UUri
+     * <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/basics/uri.adoc">UUri
      * specification</a>.
      *
      * @param sourceFilter The <em>source</em> address pattern that messages need to match.

diff --git a/src/main/java/org/eclipse/uprotocol/uri/serializer/UriSerializer.java b/src/main/java/org/eclipse/uprotocol/uri/serializer/UriSerializer.java
@@ -25,7 +25,7 @@
  * Provides functionality for serializing and deserializing {@link UUri}s to/from their
  * corresponding URI representation as defined by the uProtocol specification.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/uprotocol-spec/blob/v1.6.0-alpha.5/basics/uri.adoc">
+ * @see <a href="https://github.com/eclipse-uprotocol/uprotocol-spec/blob/v1.6.0-alpha.6/basics/uri.adoc">
  * uProtocol URI Specification</a>
  */
 public final class UriSerializer {

diff --git a/src/main/java/org/eclipse/uprotocol/uuid/factory/UuidFactory.java b/src/main/java/org/eclipse/uprotocol/uuid/factory/UuidFactory.java
@@ -21,7 +21,7 @@
 /**
  * A factory for creating uProtocol UUIDs.
  *
- * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/basics/uuid.adoc">
+ * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/basics/uuid.adoc">
  * uProtocol UUID Specification</a>
  */
 // [impl->dsn~uuid-spec~1]

diff --git a/src/main/java/org/eclipse/uprotocol/uuid/factory/UuidUtils.java b/src/main/java/org/eclipse/uprotocol/uuid/factory/UuidUtils.java
@@ -57,7 +57,7 @@ private static boolean isRfc9562Variant(UUID uuid) {
      * @return {@code true} if is a uProtocol UUID or {@code false} if uuid is {@code null}
      *         or is not a v7 UUID.
      * @see <a href="https://www.rfc-editor.org/rfc/rfc9562.html">RFC 9562</a>
-     * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.5/basics/uuid.adoc">
+     * @see <a href="https://github.com/eclipse-uprotocol/up-spec/blob/v1.6.0-alpha.6/basics/uuid.adoc">
      * uProtocol UUID specification</a>
      */
     public static boolean isUProtocol(UUID uuid) {

diff --git a/up-spec b/up-spec
+1 −1		README.adoc
+6 −6		basics/namespace.adoc
+4 −4		basics/permissions.adoc
+2 −2		basics/uattributes.adoc
+2 −2		basics/uuid_string_serialization.feature
+3 −3		basics/versioning.adoc
+1 −1		pom.xml
+1 −1		principles.adoc
+7 −11		terms.adoc
+1 −1		up-core-api/uprotocol/core/README.adoc
+1 −1		up-core-api/uprotocol/core/udiscovery/v3/udiscovery.proto
+1 −1		up-core-api/uprotocol/core/udiscovery/v3/udiscovery_replicator.proto
+3 −3		up-core-api/uprotocol/core/usubscription/v3/usubscription.proto
+1 −1		up-core-api/uprotocol/core/utwin/v2/utwin.proto
+1 −1		up-core-api/uprotocol/uoptions.proto
+7 −7		up-core-api/uprotocol/v1/ucode.proto
+1 −1		up-core-api/uprotocol/v1/umessage.proto
+18 −4		up-l1/README.adoc
+1 −1		up-l1/cloudevents.adoc
+273 −0		up-l1/iceoryx2.adoc
+1 −1		up-l1/mqtt_5.adoc
+1 −1		up-l1/someip.adoc
+9 −9		up-l2/dispatchers/README.adoc
+12 −12		up-l3/README.adoc
+2 −2		up-l3/udiscovery/v3/README.adoc
+1 −1		up-l3/udiscovery/v3/client.adoc
+5 −5		up-l3/udiscovery/v3/service.adoc
+55 −47		up-l3/usubscription/v3/README.adoc
+11 −11		up-l3/utwin/v2/README.adoc