improve phpdoc blocks

Author: alexrohleder96@outlook.com

src/Annotation.php

@@ -30,7 +30,7 @@ class Annotation
     /**
      * Formmated arguments, but not casted.
      *
-     * @var array
+     * @var string[]
      */
 
     protected $arguments;
@@ -70,16 +70,18 @@ public function getArguments()
     }
 
     /**
+     * @param string $name
+     * @param string $default = null
      * @return string
      */
 
-    public function getArgument($name)
+    public function getArgument($name, $default = null)
     {
-        return isset($this->arguments[$name]) ? $this->arguments[$name] : null;
+        return isset($this->arguments[$name]) ? $this->arguments[$name] : $default;
     }
 
     /**
-     * @return string
+     * @return int
      */
 
     public function getArgumentCount()
@@ -88,6 +90,7 @@ public function getArgumentCount()
     }
 
     /**
+     * @param string $name
      * @return boolean
      */
 

src/Reflection/AnnotationTrait.php

@@ -68,7 +68,7 @@ public function getAnnotation($name)
      * Get all annotations, or several of then. Note that here annotations can
      * have regex on they name.
      *
-     * @param array $names if empty will return all annotations. Can have regex.
+     * @param string[] $names if empty will return all annotations. Can have regex.
      * @return array ["AnnotationName" => Annotation]
      */
 
@@ -90,6 +90,7 @@ public function getAnnotations(array $names = array())
     /**
      * Check if an annotation exists
      *
+     * @param string $name
      * @return bool
      */
 
@@ -101,7 +102,8 @@ public function hasAnnotation($name)
     /**
      * Find all annotations that the name match the $pattern
      *
-     * @return array
+     * @param string $pattern
+     * @return string[]
      */
 
     protected function getMatchedAnnotations($pattern)
@@ -114,7 +116,7 @@ protected function getMatchedAnnotations($pattern)
      * Instantiate a new Annotation object, if the annotation has a specific object
      * then resolve the name and create it.
      *
-     * @param array $annotation The getMatchedAnnotation annotation return.
+     * @param string[] $annotation The getMatchedAnnotation annotation return.
      * @return Annotation
      */
 
@@ -139,7 +141,7 @@ protected function getAnnotationObject($annotation)
     /**
      * Get all use statements from the annotated reflection file.
      *
-     * @return array
+     * @return string[] [ALIAS_NAME => FULL_CLASS_NAME];
      */
 
     protected function getUseStatements()
@@ -187,6 +189,7 @@ private function getClassFileHeader()
     /**
      * Resolve annotation name.
      *
+     * @param string $name
      * @return string
      */