Skip to content

Commit

Permalink
document methods that don't work with :content_file libwww-perl#219
Browse files Browse the repository at this point in the history
  • Loading branch information
simbabque committed Oct 4, 2021
1 parent 839538f commit 9ca7647
Show file tree
Hide file tree
Showing 2 changed files with 21 additions and 0 deletions.
2 changes: 2 additions & 0 deletions Changes
@@ -1,6 +1,8 @@
Revision history for WWW::Mechanize

{{$NEXT}}
[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
Expand Down
19 changes: 19 additions & 0 deletions lib/WWW/Mechanize.pm
Expand Up @@ -438,6 +438,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] )" >> >
=cut

sub get {
Expand Down

0 comments on commit 9ca7647

Please sign in to comment.