URI-1.75v1.75

    - $uri->canonical unconditionally returns a clone (GH#58) (Dorian Taylor)

2 files changed, 7 insertions, 3 deletions

diff --git a/Changes b/Changes
index 52ecb1a..4d455f8 100644
--- a/Changes
+++ b/Changes
@@ -1,6 +1,6 @@
 Revision history for URI
 
-{{$NEXT}}
+1.75      2019-01-08 19:45:38Z
     - $uri->canonical unconditionally returns a clone (GH#58) (Dorian Taylor)
 
 1.74      2018-04-22 12:30:44Z
diff --git a/README.md b/README.md
index 684ba05..f49b0b6 100644
--- a/README.md
+++ b/README.md
@@ -205,8 +205,12 @@ The common methods available for all URI are:
     uppercasing all escape sequences, and unescaping octets that can be
     better represented as plain characters.
 
-    For efficiency reasons, if the $uri is already in normalized form,
-    then a reference to it is returned instead of a copy.
+    Before version 1.75, this method would return the original unchanged
+    `$uri` object if it detected nothing to change. To make the return
+    value consistent (and since the efficiency gains from this behaviour
+    were marginal), this method now unconditionally returns a clone. This
+    means idioms like `$uri->clone->canonical` are no longer
+    necessary.
 
 - $uri->eq( $other\_uri )
 - URI::eq( $first\_uri, $other\_uri )