Restored indentation in multi-line tag descriptions, and applied them where they were previously missing.

src/phpDocumentor/Reflection/DocBlock.php

@@ -25,8 +25,8 @@ class DocBlock implements \Reflector
     protected $short_description = '';
 
     /**
-     * @var \phpDocumentor\Reflection\DocBlock\LongDescription The actual description
+     * @var \phpDocumentor\Reflection\DocBlock\LongDescription The actual
-     *     for this docblock.
+     *     description for this docblock.
      */
     protected $long_description = null;
 
@@ -57,8 +57,8 @@ class DocBlock implements \Reflector
      * @param string            $namespace         The namespace where this
      *     DocBlock resides in; defaults to `\`.
      * @param string[]          $namespace_aliases A list of namespace aliases
-     * as provided by the `use` keyword; the key of the array is the alias name
+     *     as provided by the `use` keyword; the key of the array is the alias
-     * or last part of the alias array if no alias name is provided.
+     *     name or last part of the alias array if no alias name is provided.
      *
      * @throws \InvalidArgumentException if the given argument does not have the
      *     getDocComment method.
@@ -125,7 +125,7 @@ class DocBlock implements \Reflector
      * @param string $comment Comment to split into the sub-parts.
      *
      * @author RichardJ Special thanks to RichardJ for the regex responsible
-     *     for the split/
+     *     for the split.
      *
      * @return string[] containing the short-, long description and an element
      *     containing the tags.
@@ -312,9 +312,10 @@ class DocBlock implements \Reflector
      * @param string   $type            Type to expand into full namespaced
      *     equivalent.
      * @param string[] $ignore_keywords Whether to ignore given keywords, when
-     *     null it will use the default keywords: 'string', 'int', 'integer',
+     *     null it will use the default keywords:
-     *     'bool', 'boolean', 'float', 'double', 'object', 'mixed', 'array',
+     *     'string', 'int', 'integer', 'bool', 'boolean', 'float', 'double',
-     *     'resource', 'void', 'null', 'callback', 'false', 'true'.
+     *     'object', 'mixed', 'array', 'resource', 'void', 'null', 'callback',
+     *     'false', 'true', 'self', '$this', 'callable'.
      *     Default value for this parameter is null.
      *
      * @return string
@@ -327,9 +328,9 @@ class DocBlock implements \Reflector
 
         if ($ignore_keywords === null) {
             $ignore_keywords = array(
-                'string', 'int', 'integer', 'bool', 'boolean', 'float', 'double',
+                'string', 'int', 'integer', 'bool', 'boolean', 'float',
-                'object', 'mixed', 'array', 'resource', 'void', 'null',
+                'double', 'object', 'mixed', 'array', 'resource', 'void',
-                'callback', 'false', 'true', 'self', '$this', 'callable'
+                'null', 'callback', 'false', 'true', 'self', '$this', 'callable'
             );
         }
 

src/phpDocumentor/Reflection/DocBlock/LongDescription.php

@@ -109,7 +109,8 @@ class LongDescription implements \Reflector
     /**
      * Builds a string representation of this object.
      *
-     * @todo determine the exact format as used by PHP Reflection and implement it.
+     * @todo determine the exact format as used by PHP Reflection
+     *     and implement it.
      *
      * @return void
      */