phpDocumentor / phpDocumentor

tests/ReferenceImplementation.php

Doc Comments +7 added lines

@@ -163,6 +163,9 @@ 
     {
         const INTERFACE_CONSTANT = 'test';
 
+        /**
+         * @return SubInterface|null
+         */
         public function publicMethod();
     }
 
@@ -172,6 +175,10 @@ 
      */
     interface AnotherSuperInterface
     {
+
+        /**
+         * @return void
+         */
         public static function staticMethod();
     }
 }

tests/unit/phpDocumentor/Descriptor/Builder/Reflector/FileAssemblerTest.php

Unused Use Statements -1 removed lines

@@ -16,7 +16,6 @@
 use Mockery as m;
 use phpDocumentor\Descriptor\Collection;
 use phpDocumentor\Descriptor\PackageDescriptor;
-
 use phpDocumentor\Reflection\DocBlock;
 use phpDocumentor\Reflection\Php\File;
 

tests/unit/phpDocumentor/Descriptor/Builder/Reflector/PropertyAssemblerTest.php

Doc Comments +1 added lines

@@ -88,6 +88,7 @@
 
     /**
      * Generates a DocBlock object with applicable defaults for these tests.
+     * @param boolean $withTags
      */
     protected function givenADocBlockObject($withTags): DocBlock
     {

tests/unit/phpDocumentor/Descriptor/Builder/Reflector/MethodAssemblerTest.php

Doc Comments +1 added lines

@@ -88,6 +88,7 @@
 
     /**
      * Generates a DocBlock object with applicable defaults for these tests.
+     * @param boolean $withTags
      */
     protected function givenADocBlockObject($withTags): DocBlock
     {

src/phpDocumentor/Compiler/Pass/ResolveInlineLinkAndSeeTags.php

Doc Comments +3 added lines, -2 removed lines

@@ -171,7 +171,7 @@ 
      * If a relative QSEN is provided then this method will attempt to resolve it given the current namespace and
      * namespace aliases.
      *
-     * @param Fqsen|string $link
+     * @param string|null $link
      * @return Fqsen|string
      */
     private function resolveQsen($link)
@@ -188,6 +188,7 @@ 
      * be matched.
      *
      * @param Fqsen|string $link
+     * @param string $description
      */
     private function resolveElement(DescriptorAbstract $element, $link, ?string $description = null): string
     {
@@ -247,7 +248,7 @@ 
     /**
      * Generates a Markdown-formatted string representing a link with a description.
      *
-     * @param Fqsen|string $link
+     * @param string|null $link
      */
     private function generateMarkdownLink($link, string $description): string
     {

tests/unit/phpDocumentor/Configuration/ConfigurationFactoryTest.php

Doc Comments +10 added lines

@@ -116,6 +116,9 @@ 
         new ConfigurationFactory(['this_is_not_a_strategy'], []);
     }
 
+    /**
+     * @param string $content
+     */
     private function givenExampleConfigurationFileWithContent($content): string
     {
         vfsStream::newFile('foo.xml')
@@ -125,6 +128,10 @@ 
         return vfsStream::url('dir/foo.xml');
     }
 
+    /**
+     * @param string[] $expectedInputValue
+     * @param string[] $returnValue
+     */
     private function givenAMiddlewareThatReturns($expectedInputValue, $returnValue): \Closure
     {
         return function ($value) use ($expectedInputValue, $returnValue) {
@@ -134,6 +141,9 @@ 
         };
     }
 
+    /**
+     * @param string[] $result
+     */
     private function givenAValidStrategyThatReturns($result): Strategy
     {
         /** @var m\Mock $strategy */

src/phpDocumentor/Descriptor/Builder/Reflector/Tags/ReturnAssembler.php

Unused Use Statements -1 removed lines

@@ -18,7 +18,6 @@
 use phpDocumentor\Descriptor\Builder\Reflector\AssemblerAbstract;
 use phpDocumentor\Descriptor\Tag\ReturnDescriptor;
 use phpDocumentor\Reflection\DocBlock\Tags\Return_;
-use phpDocumentor\Reflection\Types\Compound;
 
 /**
  * Constructs a new descriptor from the Reflector for an `@return` tag.

src/phpDocumentor/Descriptor/Interfaces/ArgumentInterface.php

Doc Comments +3 added lines

@@ -38,6 +38,7 @@ 
      *     type.
      *
      * @todo update link to point to the final destination for the PHPDoc Standard.
+     * @return void
      */
     public function setType(?Type $type);
 
@@ -54,6 +55,7 @@ 
      * Sets the default value for an argument expressed as a string.
      *
      * @param string $value A textual representation of the default value.
+     * @return void
      */
     public function setDefault($value);
 
@@ -68,6 +70,7 @@ 
      * Sets whether this argument passes its parameter by reference or by value.
      *
      * @param boolean $byReference True if the parameter is passed by reference, otherwise it is by value.
+     * @return void
      */
     public function setByReference($byReference);
 

src/phpDocumentor/Descriptor/Builder/Reflector/Tags/ExampleAssembler.php

Unused Use Statements -1 removed lines

@@ -17,7 +17,6 @@
 
 use InvalidArgumentException;
 use phpDocumentor\Descriptor\Builder\Reflector\AssemblerAbstract;
-use phpDocumentor\Descriptor\Example\Finder;
 use phpDocumentor\Descriptor\Tag\ExampleDescriptor;
 use phpDocumentor\Reflection\DocBlock\ExampleFinder;
 use phpDocumentor\Reflection\DocBlock\Tags\Example;