Updated tag doc comments.

Author: boenrobot

src/phpDocumentor/Reflection/DocBlock/Tag/AuthorTag.php

@@ -32,7 +32,7 @@ class AuthorTag extends Tag
     /**
      * Parses a tag and populates the member variables.
      *
-     * @param string $type    Name of the tag.
+     * @param string $type    Tag identifier for this tag (should be 'author').
      * @param string $content The contents of the given tag.
      */
     public function __construct($type, $content)

src/phpDocumentor/Reflection/DocBlock/Tag/LinkTag.php

@@ -29,8 +29,8 @@ class LinkTag extends Tag
     /**
      * Parses a tag and populates the member variables.
      *
-     * @param string $type    Tag type
-     * @param string $content Content of the tag
+     * @param string $type    Tag identifier for this tag (should be 'link').
+     * @param string $content The contents of the given tag.
      */
     public function __construct($type, $content)
     {

src/phpDocumentor/Reflection/DocBlock/Tag/MethodTag.php

@@ -13,7 +13,7 @@
 namespace phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Reflection class for a {@method} in a Docblock.
+ * Reflection class for a @method in a Docblock.
  *
  * @author  Mike van Riel <[email protected]>
  * @license http://www.opensource.org/licenses/mit-license.php MIT
@@ -31,8 +31,8 @@ class MethodTag extends ParamTag
     /**
      * Parses a tag and populates the member variables.
      *
-     * @param string $type    Tag identifier for this tag (should be 'return')
-     * @param string $content Contents for this tag.
+     * @param string $type    Tag identifier for this tag (should be 'method').
+     * @param string $content The contents of the given tag.
      */
     public function __construct($type, $content)
     {

src/phpDocumentor/Reflection/DocBlock/Tag/ParamTag.php

@@ -15,7 +15,7 @@
 use phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Reflection class for a {@param} tag in a Docblock.
+ * Reflection class for a @param tag in a Docblock.
  *
  * @author  Mike van Riel <[email protected]>
  * @license http://www.opensource.org/licenses/mit-license.php MIT
@@ -34,7 +34,7 @@ class ParamTag extends Tag
     /**
      * Parses a tag and populates the member variables.
      *
-     * @param string $type    Tag identifier for this tag (should be 'param')
+     * @param string $type    Tag identifier for this tag (should be 'param').
      * @param string $content Contents for this tag.
      */
     public function __construct($type, $content)

src/phpDocumentor/Reflection/DocBlock/Tag/PropertyReadTag.php

@@ -13,7 +13,7 @@
 namespace phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Reflection class for a {@property} tag in a Docblock.
+ * Reflection class for a @property-read tag in a Docblock.
  *
  * @author  Mike van Riel <[email protected]>
  * @license http://www.opensource.org/licenses/mit-license.php MIT

src/phpDocumentor/Reflection/DocBlock/Tag/PropertyTag.php

@@ -13,7 +13,7 @@
 namespace phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Reflection class for a {@property} tag in a Docblock.
+ * Reflection class for a @property tag in a Docblock.
  *
  * @author  Mike van Riel <[email protected]>
  * @license http://www.opensource.org/licenses/mit-license.php MIT

src/phpDocumentor/Reflection/DocBlock/Tag/PropertyWriteTag.php

@@ -13,7 +13,7 @@
 namespace phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Reflection class for a {@property} tag in a Docblock.
+ * Reflection class for a @property-write tag in a Docblock.
  *
  * @author  Mike van Riel <[email protected]>
  * @license http://www.opensource.org/licenses/mit-license.php MIT

src/phpDocumentor/Reflection/DocBlock/Tag/ReturnTag.php

@@ -13,7 +13,7 @@
 namespace phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Reflection class for a {@return} tag in a Docblock.
+ * Reflection class for a @return tag in a Docblock.
  *
  * @author  Mike van Riel <[email protected]>
  * @license http://www.opensource.org/licenses/mit-license.php MIT
@@ -27,7 +27,7 @@ class ReturnTag extends ParamTag
     /**
      * Parses a tag and populates the member variables.
      *
-     * @param string $type    Tag identifier for this tag (should be 'return')
+     * @param string $type    Tag identifier for this tag (should be 'return').
      * @param string $content Contents for this tag.
      */
     public function __construct($type, $content)

src/phpDocumentor/Reflection/DocBlock/Tag/SeeTag.php

@@ -15,7 +15,7 @@
 use phpDocumentor\Reflection\DocBlock\Tag;
 
 /**
- * Reflection class for a {@see} tag in a Docblock.
+ * Reflection class for a @see tag in a Docblock.
  *
  * @author  Mike van Riel <[email protected]>
  * @license http://www.opensource.org/licenses/mit-license.php MIT
@@ -29,7 +29,7 @@ class SeeTag extends Tag
     /**
      * Parses a tag and populates the member variables.
      *
-     * @param string $type    Tag identifier for this tag (should be 'return')
+     * @param string $type    Tag identifier for this tag (should be 'see').
      * @param string $content Contents for this tag.
      */
     public function __construct($type, $content)

src/phpDocumentor/Reflection/DocBlock/Tag/ThrowTag.php

@@ -24,10 +24,10 @@
 class ThrowTag extends ThrowsTag
 {
     /**
-     * Sets the type to {@throws} and lets parent parse the tag and populates the
+     * Sets the type to @throws and lets parent parse the tag and populates the
      * member variables.
      *
-     * @param string $type    Tag identifier for this tag (should be 'return')
+     * @param string $type    Tag identifier for this tag (should be 'throw').
      * @param string $content Contents for this tag.
      */
     public function __construct($type, $content)