[libhttp-entity-parser-perl] 01/08: fix some grammar and a few typos in the documentation

gregor herrmann gregoa at debian.org
Sun Oct 23 00:23:50 UTC 2016


This is an automated email from the git hooks/post-receive script.

gregoa pushed a commit to tag 0.18
in repository libhttp-entity-parser-perl.

commit 0af03f9f9943924089454f12a12895889d9b6a0e
Author: Karen Etheridge <ether at cpan.org>
Date:   Sat Oct 1 20:35:34 2016 -0700

    fix some grammar and a few typos in the documentation
---
 lib/HTTP/Entity/Parser.pm | 29 ++++++++++++++---------------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/lib/HTTP/Entity/Parser.pm b/lib/HTTP/Entity/Parser.pm
index c99c149..34c7626 100644
--- a/lib/HTTP/Entity/Parser.pm
+++ b/lib/HTTP/Entity/Parser.pm
@@ -134,7 +134,7 @@ HTTP::Entity::Parser - PSGI compliant HTTP Entity Parser
 =head1 SYNOPSIS
 
     use HTTP::Entity::Parser;
-    
+
     my $parser = HTTP::Entity::Parser->new;
     $parser->register('application/x-www-form-urlencoded','HTTP::Entity::Parser::UrlEncoded');
     $parser->register('multipart/form-data','HTTP::Entity::Parser::MultiPart');
@@ -147,11 +147,10 @@ HTTP::Entity::Parser - PSGI compliant HTTP Entity Parser
 
 =head1 DESCRIPTION
 
-HTTP::Entity::Parser is PSGI compliant HTTP Entity parser. This module also has compatibility 
-with L<HTTP::Body>. Unlike HTTP::Body, HTTP::Entity::Parser reads HTTP entity from 
-PSGI's env C<$env-E<gt>{'psgi.input'}> and parse it.
-This module support application/x-www-form-urlencoded, multipart/form-data and application/json.
-
+HTTP::Entity::Parser is a PSGI-compliant HTTP Entity parser. This module also is compatible
+with L<HTTP::Body>. Unlike HTTP::Body, HTTP::Entity::Parser reads HTTP entities from
+PSGI's environment C<< $env->{'psgi.input'} >> and parses it.
+This module supports application/x-www-form-urlencoded, multipart/form-data and application/json.
 
 =head1 METHODS
 
@@ -165,7 +164,7 @@ Create the instance.
 
 =item buffer_length
 
-buffer length, HTTP::Entity::Parser read from psgi.input. 16384 by default.
+The buffer length that HTTP::Entity::Parser reads from psgi.input. 16384 by default.
 
 =back
 
@@ -177,27 +176,27 @@ Register parser class.
   $parser->register('multipart/form-data','HTTP::Entity::Parser::MultiPart');
   $parser->register('application/json','HTTP::Entity::Parser::JSON');
 
-If the request content_type match registered type, HTTP::Entity::Parser uses registered 
+If the request content_type matches the registered type, HTTP::Entity::Parser uses the registered
 parser class. If content_type does not match any registered type, HTTP::Entity::Parser::OctetStream is used.
 
 =item parse($env:HashRef)
 
-parse HTTP entity from PSGI's env.
+parse HTTP entities from PSGI's env.
 
   my ( $params:ArrayRef, $uploads:ArrayRef) = $parser->parse($env);
 
-C<$param> is key-value pair list.
+C<$param> is a key-value pair list.
 
    my ( $params, $uploads) = $parser->parse($env);
    my $body_parameters = Hash::MultiValue->new(@$params);
 
-C<$uploads> is ArrayRef of HashRef.
+C<$uploads> is an ArrayRef of HashRef.
 
    my ( $params, $uploads) = $parser->parse($env);
    warn Dumper($uploads->[0]);
    {
        "name" => "upload", #field name
-       "headeres" => [
+       "headers" => [
            "Content-Type" => "application/octet-stream",
            "Content-Disposition" => "form-data; name=\"upload\"; filename=\"hello.pl\""           
        ],
@@ -206,7 +205,7 @@ C<$uploads> is ArrayRef of HashRef.
        "tempname" => "/tmp/XXXXX", # path to the temporary file where uploaded file is saved
    }
 
-use with Plack::Request::Upload
+When used with L<Plack::Request::Upload>:
 
    my ( $params, $uploads) = $parser->parse($env);
     my $upload_hmv = Hash::MultiValue->new();
@@ -238,9 +237,9 @@ MultiPart parser use L<HTTP::MultiPartParser>.
 
 =item JSON
 
-For C<application/json>. This parser decode JSON body automatically. 
+For C<application/json>. This parser decodes JSON body automatically.
 
-It is convenient to use with Ajax form.
+It is convenient to use with Ajax forms.
 
 =back
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-perl/packages/libhttp-entity-parser-perl.git



More information about the Pkg-perl-cvs-commits mailing list