From 21feb61eb5f6d30428715e9aedd945ca5746cc54 Mon Sep 17 00:00:00 2001
From: Mike van Riel <me@mikevanriel.com>
Date: Sat, 30 Aug 2014 11:16:26 +0200
Subject: [PATCH] Add missing DocBlock (info).

---
 src/phpDocumentor/Reflection/DocBlock.php     | 22 +++++++++++++++++++
 .../phpDocumentor/Reflection/DocBlockTest.php |  9 ++++++--
 2 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/src/phpDocumentor/Reflection/DocBlock.php b/src/phpDocumentor/Reflection/DocBlock.php
index 5d76ba3..02968b1 100644
--- a/src/phpDocumentor/Reflection/DocBlock.php
+++ b/src/phpDocumentor/Reflection/DocBlock.php
@@ -303,6 +303,24 @@ class DocBlock implements \Reflector
     }
 
     /**
+     * Returns whether this DocBlock is the start of a Template section.
+     *
+     * A Docblock may serve as template for a series of subsequent DocBlocks. This is indicated by a special marker
+     * (`#@+`) that is appended directly after the opening `/**` of a DocBlock.
+     *
+     * An example of such an opening is:
+     *
+     * ```
+     * /**#@+
+     *  * My DocBlock
+     *  * /
+     * ```
+     *
+     * The description and tags (not the summary!) are copied onto all subsequent DocBlocks and also applied to all
+     * elements that follow until another DocBlock is found that contains the closing marker (`#@-`).
+     *
+     * @see self::isTemplateEnd() for the check whether a closing marker was provided.
+     *
      * @return boolean
      */
     public function isTemplateStart()
@@ -311,6 +329,10 @@ class DocBlock implements \Reflector
     }
 
     /**
+     * Returns whether this DocBlock is the end of a Template section.
+     *
+     * @see self::isTemplateStart() for a more complete description of the Docblock Template functionality.
+     *
      * @return boolean
      */
     public function isTemplateEnd()
diff --git a/tests/phpDocumentor/Reflection/DocBlockTest.php b/tests/phpDocumentor/Reflection/DocBlockTest.php
index fcce36e..30eedfc 100644
--- a/tests/phpDocumentor/Reflection/DocBlockTest.php
+++ b/tests/phpDocumentor/Reflection/DocBlockTest.php
@@ -71,8 +71,7 @@ DOCBLOCK;
 
     /**
      * @covers \phpDocumentor\Reflection\DocBlock::splitDocBlock
-     * @group test
-     * 
+     *
      * @return void
      */
     public function testConstructWithTagsOnly()
@@ -92,6 +91,9 @@ DOCBLOCK;
         $this->assertFalse($object->hasTag('category'));
     }
 
+    /**
+     * @covers \phpDocumentor\Reflection\DocBlock::isTemplateStart
+     */
     public function testIfStartOfTemplateIsDiscovered()
     {
         $fixture = <<<DOCBLOCK
@@ -110,6 +112,9 @@ DOCBLOCK;
         $this->assertTrue($object->isTemplateStart());
     }
 
+    /**
+     * @covers \phpDocumentor\Reflection\DocBlock::isTemplateEnd
+     */
     public function testIfEndOfTemplateIsDiscovered()
     {
         $fixture = <<<DOCBLOCK