Doc updates and fixes.

src/phpDocumentor/Reflection/DocBlock.php

@@ -46,11 +46,8 @@ class DocBlock implements \Reflector
      * Parses the given docblock and populates the member fields.
      *
      * The constructor may also receive namespace information such as the
-     * current namespace and aliases. This information is used in the
-     * {@link expandType()} method to transform a relative Type into a FQCN.
-     *
-     * For example the param and return tags use this to expand their type
-     * information.
+     * current namespace and aliases. This information is used by some tags
+     * (e.g. @return, @param, etc.) to turn a relative Type into a FQCN.
      *
      * @param \Reflector|string $docblock          A docblock comment (including
      *     asterisks) or reflector supporting the getDocComment method.
@@ -260,7 +257,7 @@ class DocBlock implements \Reflector
     }
 
     /**
-     * Returns an array of tags matching the given name; if no tags are found
+     * Returns an array of tags matching the given name. If no tags are found
      * an empty array is returned.
      *
      * @param string $name String to search by.

src/phpDocumentor/Reflection/DocBlock/Description.php

@@ -34,8 +34,7 @@ class Description implements \Reflector
     protected $docblock = null;
 
     /**
-     * Parses the string for inline tags and if the Markdown class is included;
-     * format the found text.
+     * Populates the fields of a description.
      *
      * @param string   $content  The DocBlock contents without asterisks.
      * @param DocBlock $docblock The DocBlock which this description belongs to.

tests/phpDocumentor/Reflection/DocBlock/DescriptionTest.php

@@ -13,7 +13,7 @@
 namespace phpDocumentor\Reflection\DocBlock;
 
 /**
- * Test class for phpDocumentor\Reflection\DocBlock\Description
+ * Test class for \phpDocumentor\Reflection\DocBlock\Description
  *
  * @author    Vasil Rangelov <[email protected]>
  * @copyright 2010-2011 Mike van Riel / Naenius. (http://www.naenius.com)

tests/phpDocumentor/Reflection/DocBlock/Tag/ParamTagTest.php

@@ -13,7 +13,7 @@
 namespace phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Test class for \phpDocumentor\Reflection\DocBlock\ParamTag.
+ * Test class for \phpDocumentor\Reflection\DocBlock\ParamTag
  *
  * @author    Mike van Riel <[email protected]>
  * @copyright 2010-2011 Mike van Riel / Naenius. (http://www.naenius.com)

tests/phpDocumentor/Reflection/DocBlock/Tag/ReturnTagTest.php

@@ -13,7 +13,7 @@
 namespace phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Test class for \phpDocumentor\Reflection\DocBlock\ReturnTag.
+ * Test class for \phpDocumentor\Reflection\DocBlock\ReturnTag
  *
  * @author    Mike van Riel <[email protected]>
  * @copyright 2010-2011 Mike van Riel / Naenius. (http://www.naenius.com)

tests/phpDocumentor/Reflection/DocBlock/Tag/ThrowsTagTest.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * phpDocumentor Return tag test.
+ * phpDocumentor Throws tag test.
  * 
  * PHP version 5.3
  *
@@ -13,7 +13,7 @@
 namespace phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Test class for \phpDocumentor\Reflection\DocBlock\ReturnTag.
+ * Test class for \phpDocumentor\Reflection\DocBlock\ThrowsTag
  *
  * @author    Mike van Riel <[email protected]>
  * @copyright 2010-2011 Mike van Riel / Naenius. (http://www.naenius.com)
@@ -23,8 +23,8 @@ namespace phpDocumentor\Reflection\DocBlock\Tag;
 class ThrowsTagTest extends \PHPUnit_Framework_TestCase
 {
     /**
-     * Test that the \phpDocumentor\Reflection\DocBlock\Tag\ReturnTag can
-     * understand the @return DocBlock.
+     * Test that the \phpDocumentor\Reflection\DocBlock\Tag\ThrowsTag can
+     * understand the @throws DocBlock.
      *
      * @param string $type
      * @param string $content