use more complete examples in rendering guide

mojolicious · Sep 13, 2014 · 63c991b · 63c991b
1 parent bcdba83
commit 63c991b
Show file tree

Hide file tree

Showing 2 changed files with 47 additions and 13 deletions.
diff --git a/lib/Mojo/DOM.pm b/lib/Mojo/DOM.pm
@@ -587,6 +587,9 @@ and C<tag> nodes) or raw content.
   # "<div><h1>123</h1></div>"
   $dom->parse('<div><h1>Test</h1></div>')->at('h1')->content('123')->root;
 
+  # "<p><i>123</i></p>"
+  $dom->parse('<p>Test</p>')->at('p')->content('<i>123</i>')->root;
+
   # "<div><h1></h1></div>"
   $dom->parse('<div><h1>Test</h1></div>')->at('h1')->content('')->root;
 
@@ -597,9 +600,6 @@ and C<tag> nodes) or raw content.
   $dom->parse('<div><!-- Test -->456</div>')->at('div')
     ->contents->first->content(' 123 ')->root;
 
-  # "<p><i>123</i></p>"
-  $dom->parse('<p>Test</p>')->at('p')->content('<i>123</i>')->root;
-
 =head2 contents
 
   my $collection = $dom->contents;

diff --git a/lib/Mojolicious/Guides/Rendering.pod b/lib/Mojolicious/Guides/Rendering.pod
@@ -970,8 +970,15 @@ Static files are automatically served from your C<DATA> sections and C<public>
 directories, and if that's not enough you can also serve them manually with
 L<Mojolicious::Plugin::DefaultHelpers/"reply-E<gt>static">.
 
-  $c->res->headers->content_disposition('attachment; filename=bar.png;');
-  $c->reply->static('foo/bar.png');
+  use Mojolicious::Lite;
+
+  get '/some_static_file' => sub {
+    my $c = shift;
+    $c->res->headers->content_disposition('attachment; filename=bar.png;');
+    $c->reply->static('foo/bar.png');
+  };
+
+  app->start;
 
 =head2 Custom responses
 
@@ -982,16 +989,30 @@ use the helper L<Mojolicious::Plugin::DefaultHelpers/"reply-E<gt>asset"> to
 serve them while allowing content negotiation to be performed with C<Range>,
 C<If-Modified-Since> and C<If-None-Match> headers.
 
-  $c->res->headers->content_type('text/plain');
-  $c->reply->asset(Mojo::Asset::File->new(path => '/etc/passwd'));
+  use Mojolicious::Lite;
+
+  get '/leak' => sub {
+    my $c = shift;
+    $c->res->headers->content_type('text/plain');
+    $c->reply->asset(Mojo::Asset::File->new(path => '/etc/passwd'));
+  };
+
+  app->start;
 
 For even more control you can also just skip the helper and use
 L<Mojolicious::Controller/"rendered"> to tell the renderer when you're done
 generating a response.
 
-  $c->res->headers->content_type('text/plain');
-  $c->res->content->asset(Mojo::Asset::File->new(path => '/etc/passwd'));
-  $c->rendered(200);
+  use Mojolicious::Lite;
+
+  get '/leak' => sub {
+    my $c = shift;
+    $c->res->headers->content_type('text/plain');
+    $c->res->content->asset(Mojo::Asset::File->new(path => '/etc/passwd'));
+    $c->rendered(200);
+  };
+
+  app->start;
 
 =head2 Helper plugins
 
@@ -1164,15 +1185,28 @@ L<Mojolicious::Controller/"write_chunk"> come in handy. A common use would be
 to send the C<head> section of an HTML document to the browser in advance and
 speed up preloading of referenced images and stylesheets.
 
-  $c->write_chunk('<html><head><title>Example</title></head>' => sub {
+  use Mojolicious::Lite;
+
+  get '/' => sub {
     my $c = shift;
-    $c->finish('<body>Example</body></html>');
-  });
+    $c->write_chunk('<html><head><title>Example</title></head>' => sub {
+      my $c = shift;
+      $c->finish('<body>Example</body></html>');
+    });
+  };
+
+  app->start;
 
 The optional drain callback ensures that all previous chunks have been
 written before processing continues. An empty chunk or call to
 L<Mojolicious::Controller/"finish"> marks the end of the stream.
 
+  HTTP/1.1 200 OK
+  Connection: keep-alive
+  Date: Sat, 13 Sep 2014 16:48:29 GMT
+  Transfer-Encoding: chunked
+  Server: Mojolicious (Perl)
+
   29
   <html><head><title>Example</title></head>
   1b