URI-1.75

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

Author: oalders

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

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 )