diff --git a/Changes b/Changes index bddac2ffa3..8bd7358d81 100644 --- a/Changes +++ b/Changes @@ -1,4 +1,7 @@ +3.15 2012-07-28 + - Improved documentation. + 3.14 2012-07-27 - Improved documentation. diff --git a/README.pod b/README.pod index a4608c93c6..0d57eb021f 100644 --- a/README.pod +++ b/README.pod @@ -34,7 +34,7 @@ they are installed). =item * -Full stack HTTP 1.1 and WebSocket client/server implementation with IPv6, TLS, +Full stack HTTP and WebSocket client/server implementation with IPv6, TLS, IDNA, Comet (long polling), chunking and multipart support. =item * diff --git a/lib/Mojo.pm b/lib/Mojo.pm index 17e9139696..572cd53770 100644 --- a/lib/Mojo.pm +++ b/lib/Mojo.pm @@ -126,8 +126,8 @@ The logging layer of your application, defaults to a L object. my $ua = $app->ua; $app = $app->ua(Mojo::UserAgent->new); -A full featured HTTP 1.1 user agent for use in your applications, defaults to -a L object. Note that this user agent should not be used in +A full featured HTTP user agent for use in your applications, defaults to a +L object. Note that this user agent should not be used in plugins, since non-blocking requests that are already in progress will interfere with new blocking ones. diff --git a/lib/Mojo/Asset.pm b/lib/Mojo/Asset.pm index 01e47179d2..b67bcd42e8 100644 --- a/lib/Mojo/Asset.pm +++ b/lib/Mojo/Asset.pm @@ -21,7 +21,7 @@ sub slurp { croak 'Method "slurp" not implemented by subclass' } =head1 NAME -Mojo::Asset - HTTP 1.1 content storage base class +Mojo::Asset - HTTP content storage base class =head1 SYNOPSIS @@ -29,7 +29,7 @@ Mojo::Asset - HTTP 1.1 content storage base class =head1 DESCRIPTION -L is an abstract base class for HTTP 1.1 content storage. +L is an abstract base class for HTTP content storage. =head1 ATTRIBUTES diff --git a/lib/Mojo/Asset/File.pm b/lib/Mojo/Asset/File.pm index e3aa24ddbe..85a1589e9a 100644 --- a/lib/Mojo/Asset/File.pm +++ b/lib/Mojo/Asset/File.pm @@ -146,7 +146,7 @@ sub slurp { =head1 NAME -Mojo::Asset::File - File storage for HTTP 1.1 content +Mojo::Asset::File - File storage for HTTP content =head1 SYNOPSIS @@ -165,7 +165,7 @@ Mojo::Asset::File - File storage for HTTP 1.1 content =head1 DESCRIPTION -L is a file storage backend for HTTP 1.1 content. +L is a file storage backend for HTTP content. =head1 ATTRIBUTES diff --git a/lib/Mojo/Asset/Memory.pm b/lib/Mojo/Asset/Memory.pm index 267498486a..46616a8c8c 100644 --- a/lib/Mojo/Asset/Memory.pm +++ b/lib/Mojo/Asset/Memory.pm @@ -59,7 +59,7 @@ sub slurp { shift->{content} } =head1 NAME -Mojo::Asset::Memory - In-memory storage for HTTP 1.1 content +Mojo::Asset::Memory - In-memory storage for HTTP content =head1 SYNOPSIS @@ -71,7 +71,7 @@ Mojo::Asset::Memory - In-memory storage for HTTP 1.1 content =head1 DESCRIPTION -L is an in-memory storage backend for HTTP 1.1 content. +L is an in-memory storage backend for HTTP content. =head1 EVENTS diff --git a/lib/Mojo/Content.pm b/lib/Mojo/Content.pm index 50b16e4967..b5490de3de 100644 --- a/lib/Mojo/Content.pm +++ b/lib/Mojo/Content.pm @@ -335,7 +335,7 @@ sub _parse_headers { =head1 NAME -Mojo::Content - HTTP 1.1 content base class +Mojo::Content - HTTP content base class =head1 SYNOPSIS @@ -343,8 +343,8 @@ Mojo::Content - HTTP 1.1 content base class =head1 DESCRIPTION -L is an abstract base class for HTTP 1.1 content as described -in RFC 2616. +L is an abstract base class for HTTP content as described in +RFC 2616. =head1 EVENTS diff --git a/lib/Mojo/Content/MultiPart.pm b/lib/Mojo/Content/MultiPart.pm index cba96a956d..ce8ff2254d 100644 --- a/lib/Mojo/Content/MultiPart.pm +++ b/lib/Mojo/Content/MultiPart.pm @@ -228,7 +228,7 @@ sub _parse_multipart_preamble { =head1 NAME -Mojo::Content::MultiPart - HTTP 1.1 multipart content container +Mojo::Content::MultiPart - HTTP multipart content container =head1 SYNOPSIS @@ -240,7 +240,7 @@ Mojo::Content::MultiPart - HTTP 1.1 multipart content container =head1 DESCRIPTION -L is a container for HTTP 1.1 multipart content as +L is a container for HTTP multipart content as described in RFC 2616. =head1 EVENTS diff --git a/lib/Mojo/Content/Single.pm b/lib/Mojo/Content/Single.pm index de958f78fc..d98ecdb1e2 100644 --- a/lib/Mojo/Content/Single.pm +++ b/lib/Mojo/Content/Single.pm @@ -66,7 +66,7 @@ sub parse { =head1 NAME -Mojo::Content::Single - HTTP 1.1 content container +Mojo::Content::Single - HTTP content container =head1 SYNOPSIS @@ -78,8 +78,8 @@ Mojo::Content::Single - HTTP 1.1 content container =head1 DESCRIPTION -L is a container for HTTP 1.1 content as described in -RFC 2616. +L is a container for HTTP content as described in RFC +2616. =head1 EVENTS diff --git a/lib/Mojo/Cookie.pm b/lib/Mojo/Cookie.pm index 52c55db79c..6e761b34c3 100644 --- a/lib/Mojo/Cookie.pm +++ b/lib/Mojo/Cookie.pm @@ -53,7 +53,7 @@ sub _tokenize { =head1 NAME -Mojo::Cookie - HTTP 1.1 cookie base class +Mojo::Cookie - HTTP cookie base class =head1 SYNOPSIS @@ -61,7 +61,7 @@ Mojo::Cookie - HTTP 1.1 cookie base class =head1 DESCRIPTION -L is an abstract base class for HTTP 1.1 cookies. +L is an abstract base class for HTTP cookies. =head1 ATTRIBUTES diff --git a/lib/Mojo/Cookie/Request.pm b/lib/Mojo/Cookie/Request.pm index 183ef4ce75..cfa82b188a 100644 --- a/lib/Mojo/Cookie/Request.pm +++ b/lib/Mojo/Cookie/Request.pm @@ -33,7 +33,7 @@ sub to_string { =head1 NAME -Mojo::Cookie::Request - HTTP 1.1 request cookie container +Mojo::Cookie::Request - HTTP request cookie container =head1 SYNOPSIS @@ -46,7 +46,7 @@ Mojo::Cookie::Request - HTTP 1.1 request cookie container =head1 DESCRIPTION -L is a container for HTTP 1.1 request cookies. +L is a container for HTTP request cookies. =head1 ATTRIBUTES diff --git a/lib/Mojo/Cookie/Response.pm b/lib/Mojo/Cookie/Response.pm index 550d2e31de..c8fbda559d 100644 --- a/lib/Mojo/Cookie/Response.pm +++ b/lib/Mojo/Cookie/Response.pm @@ -87,7 +87,7 @@ sub to_string { =head1 NAME -Mojo::Cookie::Response - HTTP 1.1 response cookie container +Mojo::Cookie::Response - HTTP response cookie container =head1 SYNOPSIS @@ -100,7 +100,7 @@ Mojo::Cookie::Response - HTTP 1.1 response cookie container =head1 DESCRIPTION -L is a container for HTTP 1.1 response cookies. +L is a container for HTTP response cookies. =head1 ATTRIBUTES diff --git a/lib/Mojo/Date.pm b/lib/Mojo/Date.pm index 1c42c25d43..1b27ddb44a 100644 --- a/lib/Mojo/Date.pm +++ b/lib/Mojo/Date.pm @@ -70,7 +70,7 @@ sub to_string { =head1 NAME -Mojo::Date - HTTP 1.1 date container +Mojo::Date - HTTP date container =head1 SYNOPSIS @@ -83,8 +83,7 @@ Mojo::Date - HTTP 1.1 date container =head1 DESCRIPTION -L implements HTTP 1.1 date and time functions according to RFC -2616. +L implements HTTP date and time functions according to RFC 2616. Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 @@ -129,7 +128,7 @@ Parse date in one of the following formats. my $string = $date->to_string; my $string = "$date"; -Render date suitable for HTTP 1.1 messages. +Render date suitable for HTTP messages. =head1 SEE ALSO diff --git a/lib/Mojo/Headers.pm b/lib/Mojo/Headers.pm index eda7c307a7..3c8f51575b 100644 --- a/lib/Mojo/Headers.pm +++ b/lib/Mojo/Headers.pm @@ -528,7 +528,7 @@ line values are disabled by default. my $string = $headers->to_string; -Turn headers into a string, suitable for HTTP 1.1 messages. +Turn headers into a string, suitable for HTTP messages. =head2 C diff --git a/lib/Mojo/Message.pm b/lib/Mojo/Message.pm index 2fe878335e..03a55f21fd 100644 --- a/lib/Mojo/Message.pm +++ b/lib/Mojo/Message.pm @@ -416,7 +416,7 @@ sub _parse_start_line { } =head1 NAME -Mojo::Message - HTTP 1.1 message base class +Mojo::Message - HTTP message base class =head1 SYNOPSIS @@ -424,8 +424,8 @@ Mojo::Message - HTTP 1.1 message base class =head1 DESCRIPTION -L is an abstract base class for HTTP 1.1 messages as described -in RFC 2616 and RFC 2388. +L is an abstract base class for HTTP messages as described in +RFC 2616 and RFC 2388. =head1 EVENTS diff --git a/lib/Mojo/Message/Request.pm b/lib/Mojo/Message/Request.pm index 05dd0baf5b..4807e0fad0 100644 --- a/lib/Mojo/Message/Request.pm +++ b/lib/Mojo/Message/Request.pm @@ -279,7 +279,7 @@ sub _parse_start_line { =head1 NAME -Mojo::Message::Request - HTTP 1.1 request container +Mojo::Message::Request - HTTP request container =head1 SYNOPSIS @@ -301,8 +301,8 @@ Mojo::Message::Request - HTTP 1.1 request container =head1 DESCRIPTION -L is a container for HTTP 1.1 requests as described -in RFC 2616. +L is a container for HTTP requests as described in RFC +2616. =head1 EVENTS diff --git a/lib/Mojo/Message/Response.pm b/lib/Mojo/Message/Response.pm index 8768299d5d..59df33ae17 100644 --- a/lib/Mojo/Message/Response.pm +++ b/lib/Mojo/Message/Response.pm @@ -132,7 +132,7 @@ sub _parse_start_line { =head1 NAME -Mojo::Message::Response - HTTP 1.1 response container +Mojo::Message::Response - HTTP response container =head1 SYNOPSIS @@ -155,8 +155,8 @@ Mojo::Message::Response - HTTP 1.1 response container =head1 DESCRIPTION -L is a container for HTTP 1.1 responses as described -in RFC 2616. +L is a container for HTTP responses as described in +RFC 2616. =head1 EVENTS diff --git a/lib/Mojo/Server/Daemon.pm b/lib/Mojo/Server/Daemon.pm index 5987637b7a..5e9693cca4 100644 --- a/lib/Mojo/Server/Daemon.pm +++ b/lib/Mojo/Server/Daemon.pm @@ -270,7 +270,7 @@ sub _write { =head1 NAME -Mojo::Server::Daemon - Non-blocking I/O HTTP 1.1 and WebSocket server +Mojo::Server::Daemon - Non-blocking I/O HTTP and WebSocket server =head1 SYNOPSIS @@ -297,8 +297,8 @@ Mojo::Server::Daemon - Non-blocking I/O HTTP 1.1 and WebSocket server =head1 DESCRIPTION -L is a full featured non-blocking I/O HTTP 1.1 and -WebSocket server with C, C and C support. +L is a full featured non-blocking I/O HTTP and WebSocket +server with C, C and C support. Optional modules L (4.0+), L (0.16+) and L (1.75+) are supported transparently and used if installed. diff --git a/lib/Mojo/Server/Hypnotoad.pm b/lib/Mojo/Server/Hypnotoad.pm index b90c5c319c..f7382f79ef 100644 --- a/lib/Mojo/Server/Hypnotoad.pm +++ b/lib/Mojo/Server/Hypnotoad.pm @@ -365,9 +365,9 @@ Mojo::Server::Hypnotoad - ALL GLORY TO THE HYPNOTOAD! =head1 DESCRIPTION L is a full featured UNIX optimized preforking -non-blocking I/O HTTP 1.1 and WebSocket server built around the very well -tested and reliable L with C, C, C and -hot deployment support that just works. +non-blocking I/O HTTP and WebSocket server built around the very well tested +and reliable L with C, C, C and hot +deployment support that just works. To start applications with it you can use the L script. diff --git a/lib/Mojo/Server/Morbo.pm b/lib/Mojo/Server/Morbo.pm index 87349729e8..c4ef69042a 100644 --- a/lib/Mojo/Server/Morbo.pm +++ b/lib/Mojo/Server/Morbo.pm @@ -122,8 +122,8 @@ Mojo::Server::Morbo - DOOOOOOOOOOOOOOOOOOM! =head1 DESCRIPTION L is a full featured self-restart capable non-blocking -I/O HTTP 1.1 and WebSocket server built around the very well tested and -reliable L with C, C and C support. +I/O HTTP and WebSocket server built around the very well tested and reliable +L with C, C and C support. To start applications with it you can use the L script. diff --git a/lib/Mojo/Transaction.pm b/lib/Mojo/Transaction.pm index e07c7a66bb..3c85527bf0 100644 --- a/lib/Mojo/Transaction.pm +++ b/lib/Mojo/Transaction.pm @@ -171,14 +171,14 @@ Remote interface port. my $req = $tx->req; $tx = $tx->req(Mojo::Message::Request->new); -HTTP 1.1 request, defaults to a L object. +HTTP request, defaults to a L object. =head2 C my $res = $tx->res; $tx = $tx->res(Mojo::Message::Response->new); -HTTP 1.1 response, defaults to a L object. +HTTP response, defaults to a L object. =head1 METHODS diff --git a/lib/Mojo/Transaction/HTTP.pm b/lib/Mojo/Transaction/HTTP.pm index f0df0e91ff..42249aafff 100644 --- a/lib/Mojo/Transaction/HTTP.pm +++ b/lib/Mojo/Transaction/HTTP.pm @@ -249,7 +249,7 @@ sub _start_line { =head1 NAME -Mojo::Transaction::HTTP - HTTP 1.1 transaction container +Mojo::Transaction::HTTP - HTTP transaction container =head1 SYNOPSIS @@ -275,7 +275,7 @@ Mojo::Transaction::HTTP - HTTP 1.1 transaction container =head1 DESCRIPTION -L is a container for HTTP 1.1 transactions as +L is a container for HTTP transactions as described in RFC 2616. =head1 EVENTS diff --git a/lib/Mojo/UserAgent.pm b/lib/Mojo/UserAgent.pm index dd1ce7d711..c75986f155 100644 --- a/lib/Mojo/UserAgent.pm +++ b/lib/Mojo/UserAgent.pm @@ -524,7 +524,7 @@ sub _write { =head1 NAME -Mojo::UserAgent - Non-blocking I/O HTTP 1.1 and WebSocket user agent +Mojo::UserAgent - Non-blocking I/O HTTP and WebSocket user agent =head1 SYNOPSIS @@ -605,8 +605,8 @@ Mojo::UserAgent - Non-blocking I/O HTTP 1.1 and WebSocket user agent =head1 DESCRIPTION -L is a full featured non-blocking I/O HTTP 1.1 and WebSocket -user agent with C, C and C support. +L is a full featured non-blocking I/O HTTP and WebSocket user +agent with C, C and C support. Optional modules L (4.0+), L (0.16+) and L (1.75+) are supported transparently and used if installed. diff --git a/lib/Mojo/UserAgent/CookieJar.pm b/lib/Mojo/UserAgent/CookieJar.pm index 31613fadcb..b064dfc965 100644 --- a/lib/Mojo/UserAgent/CookieJar.pm +++ b/lib/Mojo/UserAgent/CookieJar.pm @@ -97,7 +97,7 @@ sub inject { =head1 NAME -Mojo::UserAgent::CookieJar - Cookie jar for HTTP 1.1 user agents +Mojo::UserAgent::CookieJar - Cookie jar for HTTP user agents =head1 SYNOPSIS @@ -108,7 +108,7 @@ Mojo::UserAgent::CookieJar - Cookie jar for HTTP 1.1 user agents =head1 DESCRIPTION L is a minimalistic and relaxed cookie jar for -HTTP 1.1 user agents. +HTTP user agents. =head1 ATTRIBUTES diff --git a/lib/Mojolicious.pm b/lib/Mojolicious.pm index b6e0dd9790..225a8f6749 100644 --- a/lib/Mojolicious.pm +++ b/lib/Mojolicious.pm @@ -34,7 +34,7 @@ has static => sub { Mojolicious::Static->new }; has types => sub { Mojolicious::Types->new }; our $CODENAME = 'Rainbow'; -our $VERSION = '3.14'; +our $VERSION = '3.15'; # "These old doomsday devices are dangerously unstable. # I'll rest easier not knowing where they are." diff --git a/lib/Mojolicious/Command/daemon.pm b/lib/Mojolicious/Command/daemon.pm index f61c2da0a7..b901301597 100644 --- a/lib/Mojolicious/Command/daemon.pm +++ b/lib/Mojolicious/Command/daemon.pm @@ -4,7 +4,7 @@ use Mojo::Base 'Mojolicious::Command'; use Getopt::Long qw(GetOptions :config no_auto_abbrev no_ignore_case); use Mojo::Server::Daemon; -has description => "Start application with HTTP 1.1 and WebSocket server.\n"; +has description => "Start application with HTTP and WebSocket server.\n"; has usage => <<"EOF"; usage: $0 daemon [OPTIONS] diff --git a/lib/Mojolicious/Command/get.pm b/lib/Mojolicious/Command/get.pm index 52e20a8a6e..e905a64788 100644 --- a/lib/Mojolicious/Command/get.pm +++ b/lib/Mojolicious/Command/get.pm @@ -9,7 +9,7 @@ use Mojo::JSON::Pointer; use Mojo::UserAgent; use Mojo::Util qw(decode encode); -has description => "Perform HTTP 1.1 request.\n"; +has description => "Perform HTTP request.\n"; has usage => <<"EOF"; usage: $0 get [OPTIONS] URL [SELECTOR|JSON-POINTER] [COMMANDS] diff --git a/lib/Mojolicious/Commands.pm b/lib/Mojolicious/Commands.pm index 1e3b2d764b..832a549e37 100644 --- a/lib/Mojolicious/Commands.pm +++ b/lib/Mojolicious/Commands.pm @@ -184,7 +184,7 @@ Upload files to CPAN. $ ./myapp.pl daemon -Start application with standalone HTTP 1.1 server backend. +Start application with standalone HTTP server backend. =head2 C diff --git a/lib/Mojolicious/Guides.pod b/lib/Mojolicious/Guides.pod index b5789d8bdd..8a970349d6 100644 --- a/lib/Mojolicious/Guides.pod +++ b/lib/Mojolicious/Guides.pod @@ -75,7 +75,7 @@ ones. =item L -Full featured non-blocking I/O HTTP 1.1 and WebSocket user agent. +Full featured non-blocking I/O HTTP and WebSocket user agent. =item L @@ -87,15 +87,13 @@ Minimalistic JSON implementation that just works. =item L -Highly portable non-blocking I/O HTTP 1.1 and WebSocket server with -self-restart support through L, perfect for development -and testing. +Highly portable non-blocking I/O HTTP and WebSocket server with self-restart +support through L, perfect for development and testing. =item L -Full featured UNIX optimized preforking non-blocking I/O HTTP 1.1 and -WebSocket server with support for zero downtime software upgrades (hot -deployment). +Full featured UNIX optimized preforking non-blocking I/O HTTP and WebSocket +server with support for zero downtime software upgrades (hot deployment). =item L, L diff --git a/lib/Mojolicious/Guides/Cookbook.pod b/lib/Mojolicious/Guides/Cookbook.pod index 776893b195..3f884848cd 100644 --- a/lib/Mojolicious/Guides/Cookbook.pod +++ b/lib/Mojolicious/Guides/Cookbook.pod @@ -16,10 +16,10 @@ to be able to use them to their full potential. =head2 Built-in web server -L contains a very portable non-blocking I/O HTTP 1.1 and -WebSocket server with L. It is usually used during -development and in the construction of more advanced web servers, but is solid -and fast enough for small to mid sized applications. +L contains a very portable non-blocking I/O HTTP and WebSocket +server with L. It is usually used during development and +in the construction of more advanced web servers, but is solid and fast enough +for small to mid sized applications. $ ./script/myapp daemon Server available at http://127.0.0.1:3000. diff --git a/lib/Mojolicious/Lite.pm b/lib/Mojolicious/Lite.pm index 6eed84f00c..40d483ed91 100644 --- a/lib/Mojolicious/Lite.pm +++ b/lib/Mojolicious/Lite.pm @@ -801,7 +801,7 @@ variable. =head2 User agent -With L there's a full featured HTTP 1.1 and +With L there's a full featured HTTP and WebSocket user agent built right in. Especially in combination with L and L this can be a very powerful tool. diff --git a/script/hypnotoad b/script/hypnotoad index 057e7045f5..79fcc91402 100755 --- a/script/hypnotoad +++ b/script/hypnotoad @@ -44,7 +44,7 @@ Mojo::Server::Hypnotoad->new->run($app); =head1 NAME -hypnotoad - Hypnotoad HTTP 1.1 and WebSocket server +hypnotoad - Hypnotoad HTTP and WebSocket server =head1 SYNOPSIS diff --git a/script/morbo b/script/morbo index f80a534d28..b5b85f4d3c 100755 --- a/script/morbo +++ b/script/morbo @@ -58,7 +58,7 @@ $morbo->run($app); =head1 NAME -morbo - Morbo HTTP 1.1 and WebSocket development server +morbo - Morbo HTTP and WebSocket development server =head1 SYNOPSIS