phpDocumentor / phpDocumentor

tests/ReferenceImplementation.php

Doc Comments +7 added lines

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

src/Application/Application.php

Doc Comments +4 added lines

@@ -60,6 +60,10 @@
     }
 
     // TODO: Change this; plugins are not read from a config file provided on runtime
+
+    /**
+     * @param \DI\Container $container
+     */
     private function registerPlugins($container)
     {
         //TODO: refactor this method. Previously config was used here.

src/DomainModel/Dsn.php

Doc Comments +1 added lines, -1 removed lines

@@ -117,7 +117,7 @@
     /**
      * Returns the path part of the DSN
      *
-     * @return string
+     * @return Path
      */
     public function getPath()
     {

src/Infrastructure/Reflection/Middleware/CacheMiddleware.php

Doc Comments +1 added lines

@@ -81,6 +81,7 @@
      * Convert path to ItemName
      *
      * @param path
+     * @param string $path
      * @return string
      */
     private function getItemName($path)

src/Application/Renderer/TwigRenderer/Extension.php

Doc Comments +1 added lines, -1 removed lines

@@ -103,7 +103,7 @@
      * See the Class' DocBlock for a listing of functionality added by this
      * Extension.
      *
-     * @return \Twig_FunctionInterface[]
+     * @return \Twig_SimpleFunction[]
      */
     public function getFunctions()
     {

src/Application/Renderer/XslRenderer.php

Doc Comments +4 added lines, -4 removed lines

@@ -227,7 +227,7 @@ 
     }
 
     /**
-     * @param $structureFilename
+     * @param string $structureFilename
      * @return \DOMDocument
      */
     private function loadAst($structureFilename)
@@ -268,9 +268,9 @@ 
     }
 
     /**
-     * @param $filename
+     * @param string|null $filename
      * @param $proc
-     * @param $structure
+     * @param \DOMDocument $structure
      */
     private function writeToFile($filename, $proc, $structure)
     {
@@ -292,7 +292,7 @@ 
     /**
      * @param ProjectInterface $project
      * @param $element
-     * @return false|string
+     * @return string
      */
     private function generateUrlForXmlElement(ProjectInterface $project, $element)
     {

src/DomainModel/Renderer/Router/Renderer.php

Doc Comments +3 added lines

@@ -198,6 +198,9 @@
         return $collection;
     }
 
+    /**
+     * @param string $presentation
+     */
     protected function renderLink($path, $presentation)
     {
         $url  = false;

tests/unit/DomainModel/Parser/Documentation/Api/ApiTest.php

Doc Comments +1 added lines, -1 removed lines

@@ -89,7 +89,7 @@
      *
      * @param Fqsen $fqsen
      *
-     * @return m\MockInterface|Element
+     * @return m\MockInterface
      */
     private function givenAnElementWithFqsen($fqsen)
     {

tests/unit/DomainModel/Renderer/Router/QueueTest.php

Doc Comments +1 added lines, -1 removed lines

@@ -66,7 +66,7 @@
      * @param string $nodeName
      * @param mixed  $returns
      *
-     * @return m\MockInterface|RouterAbstract
+     * @return m\MockInterface
      */
     protected function givenARouterMatchingNodeWithResult($nodeName, $returns)
     {