slightly more consistent synopsis examples

mojolicious · Nov 19, 2013 · a74701e · a74701e
1 parent 77c5c4b
commit a74701e
Show file tree

Hide file tree

Showing 5 changed files with 11 additions and 6 deletions.
diff --git a/lib/Mojo/ByteStream.pm b/lib/Mojo/ByteStream.pm
@@ -74,8 +74,9 @@ Mojo::ByteStream - ByteStream
 
 =head1 SYNOPSIS
 
-  # Manipulate bytestreams
   use Mojo::ByteStream;
+
+  # Manipulate bytestream
   my $stream = Mojo::ByteStream->new('foo_bar_baz');
   say $stream->camelize;
 

diff --git a/lib/Mojo/Collection.pm b/lib/Mojo/Collection.pm
@@ -110,11 +110,14 @@ Mojo::Collection - Collection
 
 =head1 SYNOPSIS
 
-  # Manipulate collections
   use Mojo::Collection;
+
+  # Manipulate collection
   my $collection = Mojo::Collection->new(qw(just works));
   unshift @$collection, 'it';
-  $collection->map(sub { ucfirst })->each(sub {
+
+  # Chain methods
+  $collection->map(sub { ucfirst })->shuffle->each(sub {
     my ($word, $count) = @_;
     say "$count: $word";
   });

diff --git a/lib/Mojo/JSON.pm b/lib/Mojo/JSON.pm
@@ -329,8 +329,9 @@ Mojo::JSON - Minimalistic JSON
 
 =head1 SYNOPSIS
 
-  # Encode and decode JSON
   use Mojo::JSON;
+
+  # Encode and decode JSON
   my $json  = Mojo::JSON->new;
   my $bytes = $json->encode({foo => [1, 2], bar => 'hello!', baz => \1});
   my $hash  = $json->decode($bytes);

diff --git a/lib/Mojo/Template.pm b/lib/Mojo/Template.pm
@@ -326,9 +326,9 @@ Mojo::Template - Perl-ish templates!
 =head1 SYNOPSIS
 
   use Mojo::Template;
-  my $mt = Mojo::Template->new;
 
   # Simple
+  my $mt = Mojo::Template->new;
   my $output = $mt->render(<<'EOF');
   % use Time::Piece;
   <!DOCTYPE html>

diff --git a/lib/Mojo/UserAgent.pm b/lib/Mojo/UserAgent.pm
@@ -458,9 +458,9 @@ Mojo::UserAgent - Non-blocking I/O HTTP and WebSocket user agent
 =head1 SYNOPSIS
 
   use Mojo::UserAgent;
-  my $ua = Mojo::UserAgent->new;
 
   # Say hello to the Unicode snowman with "Do Not Track" header
+  my $ua = Mojo::UserAgent->new;
   say $ua->get('www.☃.net?hello=there' => {DNT => 1})->res->body;
 
   # Form POST with exception handling