Add missing DocBlock (info).

Author: mvriel

src/phpDocumentor/Reflection/DocBlock.php

@@ -303,6 +303,24 @@ public function getLongDescription()
     }
 
     /**
+     * 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 @@ public function isTemplateStart()
     }
 
     /**
+     * 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()

tests/phpDocumentor/Reflection/DocBlockTest.php

@@ -71,8 +71,7 @@ public function testConstruct()
 
     /**
      * @covers \phpDocumentor\Reflection\DocBlock::splitDocBlock
-     * @group test
-     * 
+     *
      * @return void
      */
     public function testConstructWithTagsOnly()
@@ -92,6 +91,9 @@ public function testConstructWithTagsOnly()
         $this->assertFalse($object->hasTag('category'));
     }
 
+    /**
+     * @covers \phpDocumentor\Reflection\DocBlock::isTemplateStart
+     */
     public function testIfStartOfTemplateIsDiscovered()
     {
         $fixture = <<<DOCBLOCK
@@ -110,6 +112,9 @@ public function testIfStartOfTemplateIsDiscovered()
         $this->assertTrue($object->isTemplateStart());
     }
 
+    /**
+     * @covers \phpDocumentor\Reflection\DocBlock::isTemplateEnd
+     */
     public function testIfEndOfTemplateIsDiscovered()
     {
         $fixture = <<<DOCBLOCK