better synopsis examples

mojolicious · Jul 27, 2012 · dc9f883 · dc9f883
1 parent d773b22
commit dc9f883
Show file tree

Hide file tree

Showing 14 changed files with 29 additions and 17 deletions.
diff --git a/Changes b/Changes
@@ -1,5 +1,5 @@
 
-3.14  2012-07-26
+3.14  2012-07-27
   - Improved documentation.
 
 3.13  2012-07-24

diff --git a/lib/Mojo/ByteStream.pm b/lib/Mojo/ByteStream.pm
@@ -94,7 +94,7 @@ Mojo::ByteStream - ByteStream
   # Chain methods
   my $stream = Mojo::ByteStream->new('foo bar baz')->quote;
   $stream = $stream->unquote->encode('UTF-8')->b64_encode('');
-  say $stream;
+  say "$stream";
 
   # Use the alternative constructor
   use Mojo::ByteStream 'b';

diff --git a/lib/Mojo/Content/Single.pm b/lib/Mojo/Content/Single.pm
@@ -74,6 +74,7 @@ Mojo::Content::Single - HTTP 1.1 content container
 
   my $single = Mojo::Content::Single->new;
   $single->parse("Content-Length: 12\r\n\r\nHello World!");
+  say $single->headers->content_length;
 
 =head1 DESCRIPTION
 

diff --git a/lib/Mojo/Cookie/Request.pm b/lib/Mojo/Cookie/Request.pm
@@ -42,7 +42,7 @@ Mojo::Cookie::Request - HTTP 1.1 request cookie container
   my $cookie = Mojo::Cookie::Request->new;
   $cookie->name('foo');
   $cookie->value('bar');
-  say $cookie;
+  say "$cookie";
 
 =head1 DESCRIPTION
 

diff --git a/lib/Mojo/Cookie/Response.pm b/lib/Mojo/Cookie/Response.pm
@@ -96,7 +96,7 @@ Mojo::Cookie::Response - HTTP 1.1 response cookie container
   my $cookie = Mojo::Cookie::Response->new;
   $cookie->name('foo');
   $cookie->value('bar');
-  say $cookie;
+  say "$cookie";
 
 =head1 DESCRIPTION
 

diff --git a/lib/Mojo/Exception.pm b/lib/Mojo/Exception.pm
@@ -155,7 +155,8 @@ Mojo::Exception - Exceptions with context
 
   use Mojo::Exception;
 
-  my $e = Mojo::Exception->new;
+  my $e = Mojo::Exception->new('Not again!');
+  $e->throw;
 
 =head1 DESCRIPTION
 

diff --git a/lib/Mojo/Headers.pm b/lib/Mojo/Headers.pm
@@ -183,9 +183,15 @@ Mojo::Headers - Headers
 
   use Mojo::Headers;
 
+  # Parse
   my $headers = Mojo::Headers->new;
-  $headers->content_type('text/plain');
   $headers->parse("Content-Type: text/html\n\n");
+  say $headers->content_type;
+
+  # Build
+  my $headers = Mojo::Headers->new;
+  $headers->content_length(9001);
+  say $headers->to_string;
 
 =head1 DESCRIPTION
 

diff --git a/lib/Mojo/Parameters.pm b/lib/Mojo/Parameters.pm
@@ -205,7 +205,13 @@ Mojo::Parameters - Parameter container
 
   use Mojo::Parameters;
 
+  # Parse
+  my $p = Mojo::Parameters->new('foo=bar&baz=23');
+  say $p->param('baz');
+
+  # Build
   my $p = Mojo::Parameters->new(foo => 'bar', baz => 23);
+  say "$p";
 
 =head1 DESCRIPTION
 

diff --git a/lib/Mojo/Path.pm b/lib/Mojo/Path.pm
@@ -122,7 +122,7 @@ Mojo::Path - Path
 
   my $path = Mojo::Path->new('/foo%2Fbar%3B/baz.html');
   shift @{$path->parts};
-  say $path;
+  say "$path";
 
 =head1 DESCRIPTION
 

diff --git a/lib/Mojo/Server.pm b/lib/Mojo/Server.pm
@@ -8,13 +8,13 @@ use Scalar::Util 'blessed';
 
 has app => sub {
 
-  # Try to detect application
-  return $ENV{MOJO_APP} if ref $ENV{MOJO_APP};
+  # Already initialized application
+  my $app = $ENV{MOJO_APP} || 'Mojo::HelloWorld';
+  return $app if ref $app;
 
   # Load and initialize application
-  my $class = $ENV{MOJO_APP} ||= 'Mojo::HelloWorld';
-  if (my $e = Mojo::Loader->new->load($class)) { die $e if ref $e }
-  return $ENV{MOJO_APP} = $class->new;
+  if (my $e = Mojo::Loader->new->load($app)) { die $e if ref $e }
+  return $ENV{MOJO_APP} = $app->new;
 };
 
 sub new {

diff --git a/lib/Mojo/URL.pm b/lib/Mojo/URL.pm
@@ -264,7 +264,7 @@ Mojo::URL - Uniform Resource Locator
   $url->path('baz');
   $url->query->param(foo => 'bar');
   $url->fragment(23);
-  say $url;
+  say "$url";
 
 =head1 DESCRIPTION
 

diff --git a/lib/Mojolicious/Command/psgi.pm b/lib/Mojolicious/Command/psgi.pm
@@ -21,7 +21,7 @@ Mojolicious::Command::psgi - PSGI command
   use Mojolicious::Command::psgi;
 
   my $psgi = Mojolicious::Command::psgi->new;
-  my $app = $psgi->run;
+  my $app  = $psgi->run;
 
 =head1 DESCRIPTION
 

diff --git a/lib/Mojolicious/Lite.pm b/lib/Mojolicious/Lite.pm
@@ -28,8 +28,7 @@ sub import {
   my $routes = $app->routes->namespace('');
 
   # Default static and template class
-  $app->static->classes->[0]   = $caller;
-  $app->renderer->classes->[0] = $caller;
+  $app->static->classes->[0] = $app->renderer->classes->[0] = $caller;
 
   # Export
   no warnings 'redefine';

diff --git a/lib/Mojolicious/Plugins.pm b/lib/Mojolicious/Plugins.pm
@@ -77,7 +77,6 @@ Mojolicious::Plugins - Plugin manager
   use Mojolicious::Plugins;
 
   my $plugins = Mojolicious::Plugin->new;
-  $plugins->load_plugin('Config');
 
 =head1 DESCRIPTION