a few better content method descriptions

mojolicious · Jan 2, 2012 · 134a6af · 134a6af
1 parent 31f8031
commit 134a6af
Show file tree

Hide file tree

Showing 4 changed files with 11 additions and 7 deletions.
diff --git a/Changes b/Changes
@@ -1,5 +1,8 @@
 This file documents the revision history for Perl extension Mojolicious.
 
+2.43    2012-01-03 00:00:00
+        - Improved documentation.
+
 2.42    2012-01-02 00:00:00
         - Deprecated Test::Mojo->max_redirects.
         - Removed exprimental status from respond_to method in

diff --git a/lib/Mojo/Content.pm b/lib/Mojo/Content.pm
@@ -479,7 +479,8 @@ EXPERIMENTAL and might change without warning!
   my $relaxed = $content->relaxed;
   $content    = $content->relaxed(1);
 
-Activate relaxed parsing for HTTP 0.9 and broken web servers.
+Activate relaxed parsing for HTTP 0.9 and responses that are terminated with
+a connection close.
 
 =head1 METHODS
 
@@ -528,8 +529,8 @@ EXPERIMENTAL and might change without warning!
 
   my $clone = $content->clone;
 
-Clone content if possible. Note that this method is EXPERIMENTAL and might
-change without warning!
+Clone content if possible, otherwise return C<undef>. Note that this method
+is EXPERIMENTAL and might change without warning!
 
 =head2 C<generate_body_chunk>
 
@@ -597,7 +598,7 @@ Check if body parsing started yet.
 
   my $bytes = $content->leftovers;
 
-Remove leftover data from content parser.
+Get leftover data from content parser.
 
 =head2 C<parse>
 

diff --git a/lib/Mojo/Message/Request.pm b/lib/Mojo/Message/Request.pm
@@ -398,8 +398,8 @@ implements the following new ones.
 
   my $clone = $req->clone;
 
-Clone request if possible. Note that this method is EXPERIMENTAL and might
-change without warning!
+Clone request if possible, otherwise return C<undef>. Note that this method
+is EXPERIMENTAL and might change without warning!
 
 =head2 C<cookies>
 

diff --git a/lib/Mojolicious.pm b/lib/Mojolicious.pm
@@ -32,7 +32,7 @@ has static   => sub { Mojolicious::Static->new };
 has types    => sub { Mojolicious::Types->new };
 
 our $CODENAME = 'Leaf Fluttering In Wind';
-our $VERSION  = '2.42';
+our $VERSION  = '2.43';
 
 # "These old doomsday devices are dangerously unstable.
 #  I'll rest easier not knowing where they are."