doc/MarkdownFileIterator: Nail down PHPDoc

refs #4820

modules/doc/library/Doc/MarkdownFileIterator.php

@@ -7,12 +7,12 @@ namespace Icinga\Module\Doc;
 use RecursiveFilterIterator;
 
 /**
- * Iterator over Markdown files recursively
+ * Recursive iterator over Markdown files
  */
 class MarkdownFileIterator extends RecursiveFilterIterator
 {
     /**
-     * Accept files with .md suffix
+     * Accept files with '.md' suffix
      *
      * @return bool Whether the current element of the iterator is acceptable
      *              through this filter
@@ -20,6 +20,7 @@ class MarkdownFileIterator extends RecursiveFilterIterator
     public function accept()
     {
         $current = $this->getInnerIterator()->current();
+        /* @var $current \SplFileInfo */
         if (! $current->isFile()) {
             return false;
         }