Merge pull request #7682 from cakephp/layout-extension

Add an example for layout extensions

en/views.rst

@@ -252,9 +252,23 @@ as the ``content`` block.
     You should avoid using ``content`` as a block name in your application.
     CakePHP uses this for uncaptured content in extended views.
 
-You can get the list of all populated blocks using the ``blocks()`` method::
+Extending Layouts
+=================
+
+Just like views, layouts can also be extended. Like views, you use ``extend()``
+to extend layouts. Layout extensions can update or replace blocks, and update or
+replace the content rendered by the child layout. For example if we wanted to
+wrap a block with additional markup you could do::
+
+    // Our layout extends the application layout.
+    $this->extend('application');
+    $this->prepend('content', '<main class="nosidebar">');
+    $this->append('content', '</main>');
+
+    // Output more markup.
 
-    $list = $this->blocks();
+    // Remember to echo the contents of the previous layout.
+    echo $this->fetch('content');
 
 .. _view-blocks: