v6.35

    - Clarify documentation for decoded_content (GH#166) (Eric Wastl)

Author: oalders

Changes

@@ -1,6 +1,6 @@
 Revision history for HTTP-Message
 
-{{$NEXT}}
+6.35      2021-11-11 22:10:31Z
     - Clarify documentation for decoded_content (GH#166) (Eric Wastl)
 
 6.34      2021-11-08 14:27:36Z

META.json

@@ -108,7 +108,7 @@
       "x_IRC" : "irc://irc.perl.org/#lwp",
       "x_MailingList" : "mailto:libwww@perl.org"
    },
-   "version" : "6.34",
+   "version" : "6.35",
    "x_Dist_Zilla" : {
       "perl" : {
          "version" : "5.030002"
@@ -615,7 +615,7 @@
                   "branch" : null,
                   "changelog" : "Changes",
                   "signed" : 0,
-                  "tag" : "v6.34",
+                  "tag" : "v6.35",
                   "tag_format" : "v%V",
                   "tag_message" : "v%V"
                },
@@ -827,6 +827,7 @@
       "DAVIDRW <davidrw@cpan.org>",
       "David Steinbrunner <dsteinbrunner@MountainBook-Pro.local>",
       "Dorian Taylor <dorian.taylor.lists@gmail.com>",
+      "Eric Wastl <topaz.github@lt3.us>",
       "Father Chrysostomos <sprout@cpan.org>",
       "Felipe Gasper <felipe@felipegasper.com>",
       "FWILES <FWILES@cpan.org>",

README.md

@@ -4,7 +4,7 @@ HTTP::Message - HTTP style message (base class)
 
 # VERSION
 
-version 6.34
+version 6.35
 
 # SYNOPSIS
 
@@ -101,9 +101,14 @@ The following methods are available:
 
 - $mess->decoded\_content( %options )
 
-    Returns the content with any `Content-Encoding` undone and for textual content
-    the raw content encoded to Perl's Unicode strings.  If the `Content-Encoding`
-    or `charset` of the message is unknown this method will fail by returning
+    Returns the content with any `Content-Encoding` undone and, for textual content
+    (`Content-Type` values starting with `text/`, exactly matching
+    `application/xml`, or ending with `+xml`), the raw content's character set
+    decoded into Perl's Unicode string format. Note that this
+    [does not currently](https://github.com/libwww-perl/HTTP-Message/pull/99)
+    attempt to decode declared character sets for any other content types like
+    `application/json` or `application/javascript`.  If the `Content-Encoding`
+    or `charset` of the message is unknown, this method will fail by returning
     `undef`.
 
     The following options can be specified.