Update upstream source from tag 'upstream/2.06'

Update to upstream version '2.06'
with Debian dir d28eed94d12add774fe07b4f038bca0ba0667add

12 files changed, 79 insertions, 36 deletions

diff --git a/Changes b/Changes
index e6959ce..3763c89 100644
--- a/Changes
+++ b/Changes
@@ -1,5 +1,9 @@
 Revision history for WWW::Mechanize
 
+2.06      2021-10-25 20:56:12Z
+    [DOCUMENTATION]
+    - Document methods that don't work with :content_file (GH#219) (Julien Fiegehenn)
+
 2.05      2021-09-21 14:06:00Z
     - Update docs for protocols_allowed and protocols_forbidden (GH#323) (Olaf
       Alders)
@@ -10,6 +14,7 @@ Revision history for WWW::Mechanize
 
     [DOCUMENTATION]
     - Document that form_id() accepts an id, not a name (GH#319) (Olaf Alders)
+    - Clarify documentation (GH#320) (Julien Fiegehenn)
 
 2.03      2020-11-10 14:47:04Z
     [FIXED]
@@ -106,8 +111,8 @@ Revision history for WWW::Mechanize
     - Fixed pod error as reported by CPANTS. (GH#264) (Mohammad S Anwar)
 
     [ENHANCEMENTS]
-    - Upgrade to HTML::TreeBuilder version 5 to get support for weak references in
-      HTML::Element (GH#251) (Julien Fiegehenn)
+    - Upgrade to HTML::TreeBuilder version 5 to get support for weak references
+      in HTML::Element (GH#251) (GH#262) (Julien Fiegehenn)
 
 1.89      2018-10-18 19:13:34Z
     [ENHANCEMENTS]
diff --git a/META.json b/META.json
index 3a1c7f7..d817399 100644
--- a/META.json
+++ b/META.json
@@ -121,15 +121,15 @@
    "provides" : {
       "WWW::Mechanize" : {
          "file" : "lib/WWW/Mechanize.pm",
-         "version" : "2.05"
+         "version" : "2.06"
       },
       "WWW::Mechanize::Image" : {
          "file" : "lib/WWW/Mechanize/Image.pm",
-         "version" : "2.05"
+         "version" : "2.06"
       },
       "WWW::Mechanize::Link" : {
          "file" : "lib/WWW/Mechanize/Link.pm",
-         "version" : "2.05"
+         "version" : "2.06"
       }
    },
    "release_status" : "stable",
@@ -144,7 +144,7 @@
          "web" : "https://github.com/libwww-perl/WWW-Mechanize"
       }
    },
-   "version" : "2.05",
+   "version" : "2.06",
    "x_Dist_Zilla" : {
       "perl" : {
          "version" : "5.030002"
@@ -515,7 +515,7 @@
                   "changelog" : "Changes"
                },
                "Dist::Zilla::Role::Git::Repo" : {
-                  "git_version" : "2.33.0",
+                  "git_version" : "2.33.1",
                   "repo_root" : "."
                }
             },
@@ -526,7 +526,7 @@
             "class" : "Dist::Zilla::Plugin::Git::Contributors",
             "config" : {
                "Dist::Zilla::Plugin::Git::Contributors" : {
-                  "git_version" : "2.33.0",
+                  "git_version" : "2.33.1",
                   "include_authors" : 0,
                   "include_releaser" : 1,
                   "order_by" : "name",
@@ -646,7 +646,7 @@
                   "changelog" : "Changes"
                },
                "Dist::Zilla::Role::Git::Repo" : {
-                  "git_version" : "2.33.0",
+                  "git_version" : "2.33.1",
                   "repo_root" : "."
                },
                "Dist::Zilla::Role::Git::StringFormatter" : {
@@ -663,12 +663,12 @@
                   "branch" : null,
                   "changelog" : "Changes",
                   "signed" : 0,
-                  "tag" : "v2.05",
+                  "tag" : "v2.06",
                   "tag_format" : "v%V",
                   "tag_message" : "v%V"
                },
                "Dist::Zilla::Role::Git::Repo" : {
-                  "git_version" : "2.33.0",
+                  "git_version" : "2.33.1",
                   "repo_root" : "."
                },
                "Dist::Zilla::Role::Git::StringFormatter" : {
@@ -719,7 +719,7 @@
                   "changelog" : "Changes"
                },
                "Dist::Zilla::Role::Git::Repo" : {
-                  "git_version" : "2.33.0",
+                  "git_version" : "2.33.1",
                   "repo_root" : "."
                },
                "Dist::Zilla::Role::Git::StringFormatter" : {
@@ -739,7 +739,7 @@
                   "remotes_must_exist" : 1
                },
                "Dist::Zilla::Role::Git::Repo" : {
-                  "git_version" : "2.33.0",
+                  "git_version" : "2.33.1",
                   "repo_root" : "."
                }
             },
diff --git a/META.yml b/META.yml
index 8a6602b..9fe29ec 100644
--- a/META.yml
+++ b/META.yml
@@ -46,13 +46,13 @@ no_index:
 provides:
   WWW::Mechanize:
     file: lib/WWW/Mechanize.pm
-    version: '2.05'
+    version: '2.06'
   WWW::Mechanize::Image:
     file: lib/WWW/Mechanize/Image.pm
-    version: '2.05'
+    version: '2.06'
   WWW::Mechanize::Link:
     file: lib/WWW/Mechanize/Link.pm
-    version: '2.05'
+    version: '2.06'
 recommends:
   Compress::Zlib: '0'
 requires:
@@ -79,7 +79,7 @@ resources:
   bugtracker: https://github.com/libwww-perl/WWW-Mechanize/issues
   homepage: https://github.com/libwww-perl/WWW-Mechanize
   repository: https://github.com/libwww-perl/WWW-Mechanize.git
-version: '2.05'
+version: '2.06'
 x_Dist_Zilla:
   perl:
     version: '5.030002'
@@ -368,7 +368,7 @@ x_Dist_Zilla:
           allow_dirty_match: []
           changelog: Changes
         Dist::Zilla::Role::Git::Repo:
-          git_version: 2.33.0
+          git_version: 2.33.1
           repo_root: .
       name: '@Author::OALDERS/Git::Check'
       version: '2.048'
@@ -376,7 +376,7 @@ x_Dist_Zilla:
       class: Dist::Zilla::Plugin::Git::Contributors
       config:
         Dist::Zilla::Plugin::Git::Contributors:
-          git_version: 2.33.0
+          git_version: 2.33.1
           include_authors: 0
           include_releaser: 1
           order_by: name
@@ -468,7 +468,7 @@ x_Dist_Zilla:
           allow_dirty_match: []
           changelog: Changes
         Dist::Zilla::Role::Git::Repo:
-          git_version: 2.33.0
+          git_version: 2.33.1
           repo_root: .
         Dist::Zilla::Role::Git::StringFormatter:
           time_zone: local
@@ -481,11 +481,11 @@ x_Dist_Zilla:
           branch: ~
           changelog: Changes
           signed: 0
-          tag: v2.05
+          tag: v2.06
           tag_format: v%V
           tag_message: v%V
         Dist::Zilla::Role::Git::Repo:
-          git_version: 2.33.0
+          git_version: 2.33.1
           repo_root: .
         Dist::Zilla::Role::Git::StringFormatter:
           time_zone: local
@@ -523,7 +523,7 @@ x_Dist_Zilla:
             - (?^:^lib/.*\.pm$)
           changelog: Changes
         Dist::Zilla::Role::Git::Repo:
-          git_version: 2.33.0
+          git_version: 2.33.1
           repo_root: .
         Dist::Zilla::Role::Git::StringFormatter:
           time_zone: local
@@ -537,7 +537,7 @@ x_Dist_Zilla:
             - origin
           remotes_must_exist: 1
         Dist::Zilla::Role::Git::Repo:
-          git_version: 2.33.0
+          git_version: 2.33.1
           repo_root: .
       name: '@Author::OALDERS/Git::Push'
       version: '2.048'
diff --git a/Makefile.PL b/Makefile.PL
index 9b87e18..90821e3 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -67,7 +67,7 @@ my %WriteMakefileArgs = (
     "bytes" => 0,
     "lib" => 0
   },
-  "VERSION" => "2.05",
+  "VERSION" => "2.06",
   "test" => {
     "TESTS" => "t/*.t t/local/*.t t/mech-dump/*.t"
   }
diff --git a/README.md b/README.md
index a5313b6..7a343fd 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ WWW::Mechanize - Handy web browsing in a Perl object
 
 # VERSION
 
-version 2.05
+version 2.06
 
 # SYNOPSIS
 
@@ -291,6 +291,25 @@ appropriately. See ["get" in LWP::UserAgent](https://metacpan.org/pod/LWP%3A%3AU
 stored in a file instead of the response object, some Mech functions
 that expect it to be there won't work as expected. Use with caution.
 
+Here is a non-complete list of methods that do not work as expected with
+`:content_file`:
+` [forms()](#mech-forms) `,
+` [current_form()](#mech-current_form) `,
+` [links()](#mech-links) `,
+` [title()](#mech-title) `,
+` [content(...)](#mech-content) `,
+` [text()](#mech-text) `,
+all [content-handling methods](#content-handling-methods),
+all [link methods](#link-methods),
+all [image methods](#image-methods),
+all [form methods](#form-methods),
+all [field methods](#field-methods),
+` [save_content(...)](#mech-save_content-filename-opts) `,
+` [dump_links(...)](#mech-dump_links-fh-absolute) `,
+` [dump_images(...)](#mech-dump_images-fh-absolute) `,
+` [dump_forms(...)](#mech-dump_forms-fh) `,
+` [dump_text(...)](#mech-dump_text-fh) `
+
 ## $mech->post( $uri, content => $content )
 
 POSTs _$content_ to _$uri_.  Returns an [HTTP::Response](https://metacpan.org/pod/HTTP%3A%3AResponse) object.
diff --git a/lib/WWW/Mechanize.pm b/lib/WWW/Mechanize.pm
index 0157c0e..7ecfb90 100644
--- a/lib/WWW/Mechanize.pm
+++ b/lib/WWW/Mechanize.pm
@@ -6,7 +6,7 @@ package WWW::Mechanize;
 use strict;
 use warnings;
 
-our $VERSION = '2.05';
+our $VERSION = '2.06';
 
 use Tie::RefHash;
 use HTTP::Request 1.30;
@@ -1800,7 +1800,7 @@ WWW::Mechanize - Handy web browsing in a Perl object
 
 =head1 VERSION
 
-version 2.05
+version 2.06
 
 =head1 SYNOPSIS
 
@@ -2128,6 +2128,25 @@ B<NOTE:> Because C<:content_file> causes the page contents to be
 stored in a file instead of the response object, some Mech functions
 that expect it to be there won't work as expected. Use with caution.
 
+Here is a non-complete list of methods that do not work as expected with
+C<:content_file>:
+C< L<< forms()|/"$mech->forms()" >> >,
+C< L<< current_form()|/"$mech->current_form()" >> >,
+C< L<< links()|/"$mech->links()" >> >,
+C< L<< title()|/"$mech->title()" >> >,
+C< L<< content(...)|/"$mech->content(...)" >> >,
+C< L<< text()|/"$mech->text()" >> >,
+all L<< content-handling methods|/"CONTENT-HANDLING METHODS" >>,
+all L<< link methods|/"LINK METHODS" >>,
+all L<< image methods|/"IMAGE METHODS" >>,
+all L<< form methods|/"FORM METHODS" >>,
+all L<< field methods|/"FIELD METHODS" >>,
+C< L<< save_content(...)|/"$mech->save_content( $filename, %opts )" >> >,
+C< L<< dump_links(...)|/"$mech->dump_links( [[$fh], $absolute] )" >> >,
+C< L<< dump_images(...)|/"$mech->dump_images( [[$fh], $absolute] )" >> >,
+C< L<< dump_forms(...)|/"$mech->dump_forms( [$fh] )" >> >,
+C< L<< dump_text(...)|/"$mech->dump_text( [$fh] )" >> >
+
 =head2 $mech->post( $uri, content => $content )
 
 POSTs I<$content> to I<$uri>.  Returns an L<HTTP::Response> object.
diff --git a/lib/WWW/Mechanize/Cookbook.pod b/lib/WWW/Mechanize/Cookbook.pod
index 8567378..d673b93 100644
--- a/lib/WWW/Mechanize/Cookbook.pod
+++ b/lib/WWW/Mechanize/Cookbook.pod
@@ -13,7 +13,7 @@ WWW::Mechanize::Cookbook - Recipes for using WWW::Mechanize
 
 =head1 VERSION
 
-version 2.05
+version 2.06
 
 =head1 INTRODUCTION
 
diff --git a/lib/WWW/Mechanize/Examples.pod b/lib/WWW/Mechanize/Examples.pod
index 785d650..a460038 100644
--- a/lib/WWW/Mechanize/Examples.pod
+++ b/lib/WWW/Mechanize/Examples.pod
@@ -13,7 +13,7 @@ WWW::Mechanize::Examples - Sample programs that use WWW::Mechanize
 
 =head1 VERSION
 
-version 2.05
+version 2.06
 
 =head1 SYNOPSIS
 
diff --git a/lib/WWW/Mechanize/FAQ.pod b/lib/WWW/Mechanize/FAQ.pod
index 332d665..ba5c377 100644
--- a/lib/WWW/Mechanize/FAQ.pod
+++ b/lib/WWW/Mechanize/FAQ.pod
@@ -13,7 +13,7 @@ WWW::Mechanize::FAQ - Frequently Asked Questions about WWW::Mechanize
 
 =head1 VERSION
 
-version 2.05
+version 2.06
 
 =head1 How to get help with WWW::Mechanize
 
diff --git a/lib/WWW/Mechanize/Image.pm b/lib/WWW/Mechanize/Image.pm
index c7cf699..fb77ca6 100644
--- a/lib/WWW/Mechanize/Image.pm
+++ b/lib/WWW/Mechanize/Image.pm
@@ -3,7 +3,7 @@ package WWW::Mechanize::Image;
 use strict;
 use warnings;
 
-our $VERSION = '2.05';
+our $VERSION = '2.06';
 
 #ABSTRACT: Image object for WWW::Mechanize
 
@@ -69,7 +69,7 @@ WWW::Mechanize::Image - Image object for WWW::Mechanize
 
 =head1 VERSION
 
-version 2.05
+version 2.06
 
 =head1 SYNOPSIS
 
diff --git a/lib/WWW/Mechanize/Link.pm b/lib/WWW/Mechanize/Link.pm
index e4d0789..5ed1cfd 100644
--- a/lib/WWW/Mechanize/Link.pm
+++ b/lib/WWW/Mechanize/Link.pm
@@ -3,7 +3,7 @@ package WWW::Mechanize::Link;
 use strict;
 use warnings;
 
-our $VERSION = '2.05';
+our $VERSION = '2.06';
 
 #ABSTRACT: Link object for WWW::Mechanize
 
@@ -65,7 +65,7 @@ WWW::Mechanize::Link - Link object for WWW::Mechanize
 
 =head1 VERSION
 
-version 2.05
+version 2.06
 
 =head1 SYNOPSIS
 
diff --git a/script/mech-dump b/script/mech-dump
index deeaa34..49441a8 100755
--- a/script/mech-dump
+++ b/script/mech-dump
@@ -131,7 +131,7 @@ mech-dump - Dumps information about a web page
 
 =head1 VERSION
 
-version 2.05
+version 2.06
 
 =head1 SYNOPSIS