Merge branch 'master' of github.com:cakephp/cakephp

src/View/View.php

@@ -551,6 +551,23 @@ public function blocks()
     /**
      * Start capturing output for a 'block'
      *
+     * You can use start on a block multiple times to
+     * append or prepend content in a capture mode.
+     *
+     * ```
+     * // Append content to an existing block.
+     * $this->start('content');
+     * echo $this->fetch('content');
+     * echo 'Some new content';
+     * $this->end();
+     *
+     * // Prepend content to an existing block
+     * $this->start('content');
+     * echo 'Some new content';
+     * echo $this->fetch('content');
+     * $this->end();
+     * ```
+     *
      * @param string $name The name of the block to capture for.
      * @return void
      * @see ViewBlock::start()

src/View/ViewBlock.php

@@ -57,9 +57,8 @@ class ViewBlock
     /**
      * Should the currently captured content be discarded on ViewBlock::end()
      *
-     * @var bool
      * @see ViewBlock::end()
-     * @see ViewBlock::startIfEmpty()
+     * @var bool
      */
     protected $_discardActiveBufferOnEnd = false;