don't use one-line var docblocks;

don't include varname in var docblock;

Author: ashnazg

src/phpDocumentor/Reflection/Php/Argument.php

@@ -24,16 +24,24 @@ final class Argument
      */
     private $name = null;
 
-    /** @var string[] $type an array of normalized types that should be in this Argument */
+    /**
+     * @var mixed[] an array of normalized types that should be in this Argument
+     */
     private $types = [];
 
-    /** @var string|null $default the default value for an argument or null if none is provided */
+    /**
+     * @var string|null the default value for an argument or null if none is provided
+     */
     private $default = null;
 
-    /** @var bool $byReference whether the argument passes the parameter by reference instead of by value */
+    /**
+     * @var bool whether the argument passes the parameter by reference instead of by value
+     */
     private $byReference = false;
 
-    /** @var boolean Determines if this Argument represents a variadic argument */
+    /**
+     * @var boolean Determines if this Argument represents a variadic argument
+     */
     private $isVariadic = false;
 
     /**

src/phpDocumentor/Reflection/Php/Class_.php

@@ -36,30 +36,44 @@ final class Class_ implements Element
      */
     private $docBlock = null;
 
-    /** @var boolean $abstract Whether this is an abstract class. */
+    /**
+     * @var boolean Whether this is an abstract class.
+     */
     private $abstract = false;
 
-    /** @var boolean $final Whether this class is marked as final and can't be subclassed. */
+    /**
+     * @var boolean Whether this class is marked as final and can't be subclassed.
+     */
     private $final = false;
 
     /**
      * @var null|Fqsen The class this class is extending.
      */
     private $parent = null;
 
-    /** @var Fqsen[] $implements References to interfaces that are implemented by this class. */
+    /**
+     * @var Fqsen[] References to interfaces that are implemented by this class.
+     */
     private $implements = [];
 
-    /** @var Constant[] $constants References to constants defined in this class. */
+    /**
+     * @var Constant[] References to constants defined in this class.
+     */
     private $constants = [];
 
-    /** @var Property[] $properties References to properties defined in this class. */
+    /**
+     * @var Property[] References to properties defined in this class.
+     */
     private $properties = [];
 
-    /** @var Method[] $methods References to methods defined in this class. */
+    /**
+     * @var Method[] References to methods defined in this class.
+     */
     private $methods = [];
 
-    /** @var Fqsen[] $usedTraits References to traits consumed by this class */
+    /**
+     * @var Fqsen[] References to traits consumed by this class
+     */
     private $usedTraits = [];
 
     /**

src/phpDocumentor/Reflection/Php/Factory/PropertyIterator.php

@@ -31,7 +31,9 @@ final class PropertyIterator implements Iterator
      */
     private $property;
 
-    /** @var int index of the current propertyProperty to use */
+    /**
+     * @var int index of the current propertyProperty to use
+     */
     private $index = 0;
 
     /**

src/phpDocumentor/Reflection/Php/File.php

@@ -27,43 +27,64 @@ final class File
      */
     private $docBlock = null;
 
-    /** @var string $hash */
+    /**
+     * @var string
+     */
     private $hash;
 
-    /** @var string $name */
+    /**
+     * @var string
+     */
     private $name = null;
 
-    /** @var string $path */
+    /**
+     * @var string
+     */
     private $path = null;
 
-    /** @var string $source */
+    /**
+     * @var string
+     */
     private $source = null;
 
-    /** @var Fqsen[] $namespaces */
+    /**
+     * @var Fqsen[]
+     */
     private $namespaces = [];
 
-    /** @var string[] $includes */
+    /**
+     * @var string[]
+     */
     private $includes = [];
 
-    /** @var Function_[] $functions */
+    /**
+     * @var Function_[]
+     */
     private $functions = [];
 
-    /** @var Constant[] $constants */
+    /**
+     * @var Constant[]
+     */
     private $constants = [];
 
-    /** @var Class_[] $classes */
+    /**
+     * @var Class_[]
+     */
     private $classes = [];
 
-    /** @var Interface_[] $interfaces */
+    /**
+     * @var Interface_[]
+     */
     private $interfaces = [];
 
-    /** @var Trait_[] $traits */
+    /**
+     * @var Trait_[]
+     */
     private $traits = [];
 
     /**
      * Initializes a new file descriptor with the given hash of its contents.
      *
-     *
      * @param string $hash An MD5 hash of the contents if this file.
      */
     public function __construct(string $hash, string $path, string $source = '', ?DocBlock $docBlock = null)

src/phpDocumentor/Reflection/Php/Interface_.php

@@ -36,13 +36,19 @@ final class Interface_ implements Element
      */
     private $docBlock;
 
-    /** @var Constant[] $constants */
+    /**
+     * @var Constant[]
+     */
     private $constants = [];
 
-    /** @var Method[] $methods */
+    /**
+     * @var Method[]
+     */
     private $methods = [];
 
-    /** @var Fqsen[] $parents */
+    /**
+     * @var Fqsen[]
+     */
     private $parents = [];
 
     /**

src/phpDocumentor/Reflection/Php/Method.php

@@ -36,19 +36,29 @@ final class Method implements Element
      */
     private $fqsen;
 
-    /** @var bool $abstract */
+    /**
+     * @var bool
+     */
     private $abstract = false;
 
-    /** @var bool $final */
+    /**
+     * @var bool
+     */
     private $final = false;
 
-    /** @var bool $static */
+    /**
+     * @var bool
+     */
     private $static = false;
 
-    /** @var null|Visibility visibility of this method */
+    /**
+     * @var null|Visibility visibility of this method
+     */
     private $visibility = null;
 
-    /** @var Argument[] */
+    /**
+     * @var Argument[]
+     */
     private $arguments = [];
 
     /**

src/phpDocumentor/Reflection/Php/Namespace_.php

@@ -29,19 +29,29 @@ final class Namespace_ implements Element
      */
     private $fqsen;
 
-    /** @var Fqsen[] $functions fqsen of all functions in this namespace */
+    /**
+     * @var Fqsen[] fqsen of all functions in this namespace
+     */
     private $functions = [];
 
-    /** @var Fqsen[] $constants fqsen of all constants in this namespace */
+    /**
+     * @var Fqsen[] fqsen of all constants in this namespace
+     */
     private $constants = [];
 
-    /** @var Fqsen[] $classes fqsen of all classes in this namespace */
+    /**
+     * @var Fqsen[] fqsen of all classes in this namespace
+     */
     private $classes = [];
 
-    /** @var Fqsen[] $interfaces fqsen of all interfaces in this namespace */
+    /**
+     * @var Fqsen[] fqsen of all interfaces in this namespace
+     */
     private $interfaces = [];
 
-    /** @var Fqsen[] $traits fqsen of all traits in this namespace */
+    /**
+     * @var Fqsen[] fqsen of all traits in this namespace
+     */
     private $traits = [];
 
     /**

src/phpDocumentor/Reflection/Php/Project.php

@@ -22,10 +22,14 @@
  */
 final class Project implements ProjectInterface
 {
-    /** @var string $name */
+    /**
+     * @var string
+     */
     private $name = '';
 
-    /** @var Namespace_|null */
+    /**
+     * @var Namespace_|null
+     */
     private $rootNamespace;
 
     /**