summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorOlaf Alders <olaf@wundersolutions.com>2022-07-04 16:54:08 -0400
committerOlaf Alders <olaf@wundersolutions.com>2022-07-04 16:54:08 -0400
commit49cf1af2b0dc8b2c1d1d218b74f451b018083416 (patch)
tree116b839b455e69c3ebe304702832fb00a664cf88 /README.md
parent7dacc673230bcea391d4be5275cfca1aa9533fb3 (diff)
downloaduri-49cf1af2b0dc8b2c1d1d218b74f451b018083416.tar.gz
URI-5.11v5.11
- Fix some typos in URI::file (GH#94) (Olaf Alders) - Escape square brackets in path (GH#100) (Perlbotics) - Fix storable.t (GH#97) (Shoichi Kaji)
Diffstat (limited to 'README.md')
-rw-r--r--README.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/README.md b/README.md
index c0b0525..03abc62 100644
--- a/README.md
+++ b/README.md
@@ -684,6 +684,30 @@ methods behave:
This value can be set to ";" to have the query form `key=value` pairs
delimited by ";" instead of "&" which is the default.
+# ENVIRONMENT VARIABLES
+
+- URI\_HAS\_RESERVED\_SQUARE\_BRACKETS
+
+ Before version 5.11, URI treated square brackets as reserved characters
+ throughout the whole URI string. However, these brackets are reserved
+ only within the authority/host part of the URI and nowhere else (RFC 3986).
+
+ Starting with version 5.11, URI takes this distinction into account.
+ Setting the environment variable `URI_HAS_RESERVED_SQUARE_BRACKETS`
+ (programmatically or via the shell), restores the old behavior.
+
+ #-- restore 5.10 behavior programmatically
+ BEGIN {
+ $ENV{URI_HAS_RESERVED_SQUARE_BRACKETS} = 1;
+ }
+ use URI ();
+
+ _Note_: This environment variable is just used during initialization and has to be set
+ _before_ module URI is used/required. Changing it at run time has no effect.
+
+ Its value can be checked programmatically by accessing the constant
+ `URI::HAS_RESERVED_SQUARE_BRACKETS`.
+
# BUGS
There are some things that are not quite right: