QA: Docblock improvements and -q parameter for phpdoc

Author: ivanlanin

.travis.yml

@@ -50,7 +50,7 @@ script:
     ## PHPUnit
     - phpunit -c ./ --coverage-text --coverage-html ./build/coverage
     ## PHPDocumentor
-    - vendor/bin/phpdoc.php -d ./src -t ./build/docs --ignore "*/src/PhpWord/Shared/*/*" --template="responsive-twig"
+    - vendor/bin/phpdoc.php -q -d ./src -t ./build/docs --ignore "*/src/PhpWord/Shared/*/*" --template="responsive-twig"
 
 after_script:
     ## PHPDocumentor

src/PhpWord/Reader/Word2007/AbstractPart.php

@@ -437,6 +437,7 @@ private function readCellStyle(XMLReader $xmlReader, \DOMElement $domNode)
      * @param \PhpOffice\PhpWord\Shared\XMLReader $xmlReader
      * @param \DOMElement $parentNode
      * @param array $styleDefs
+     * @ignoreScrutinizerPatch
      * @return array
      */
     protected function readStyleDefs(XMLReader $xmlReader, \DOMElement $parentNode = null, $styleDefs = array())
@@ -467,6 +468,7 @@ protected function readStyleDefs(XMLReader $xmlReader, \DOMElement $parentNode =
      * Return style definition based on conversion method
      *
      * @param string $method
+     * @ignoreScrutinizerPatch
      * @param mixed $attributeValue
      * @param mixed $expected
      * @return mixed

src/PhpWord/Reader/Word2007/Document.php

@@ -99,6 +99,7 @@ private function readHeaderFooter($settings, Section &$section)
      *
      * @param \PhpOffice\PhpWord\Shared\XMLReader $xmlReader
      * @param \DOMElement $domNode
+     * @ignoreScrutinizerPatch
      * @return array
      */
     private function readSectionStyle(XMLReader $xmlReader, \DOMElement $domNode)

src/PhpWord/Shared/Html.php

@@ -242,7 +242,9 @@ protected static function parseNode(
             $cNodes = $node->childNodes;
             if (count($cNodes) > 0) {
                 foreach ($cNodes as $cNode) {
-                    self::parseNode($cNode, $newobject, $styles, $data);
+                    if ($newobject instanceof \PhpOffice\PhpWord\Element\AbstractContainer) {
+                        self::parseNode($cNode, $newobject, $styles, $data);
+                    }
                 }
             }
         }

src/PhpWord/Style/Image.php

@@ -245,6 +245,7 @@ public function getMarginTop()
     /**
      * Set margin top
      *
+     * @ignoreScrutinizerPatch
      * @param int|float $value
      * @return self
      */
@@ -268,6 +269,7 @@ public function getMarginLeft()
     /**
      * Set margin left
      *
+     * @ignoreScrutinizerPatch
      * @param int|float $value
      * @return self
      */

src/PhpWord/Style/Paragraph.php

@@ -190,7 +190,7 @@ public function setStyleValue($key, $value)
      */
     public function getStyleValues()
     {
-        return array(
+        $styles = array(
             'name'              => $this->getStyleName(),
             'basedOn'           => $this->getBasedOn(),
             'next'              => $this->getNext(),
@@ -209,6 +209,8 @@ public function getStyleValues()
             ),
             'tabs'              => $this->getTabs(),
         );
+
+        return $styles;
     }
 
     /**

src/PhpWord/Writer/Word2007/Style/Paragraph.php

@@ -20,6 +20,7 @@
 use PhpOffice\PhpWord\Shared\XMLWriter;
 use PhpOffice\PhpWord\Style;
 use PhpOffice\PhpWord\Style\Alignment as AlignmentStyle;
+use PhpOffice\PhpWord\Style\Paragraph as ParagraphStyle;
 
 /**
  * Paragraph style writer
@@ -71,7 +72,7 @@ public function write()
     private function writeStyle()
     {
         $style = $this->getStyle();
-        if (!$style instanceof \PhpOffice\PhpWord\Style\Paragraph) {
+        if (!$style instanceof ParagraphStyle) {
             return;
         }
         $xmlWriter = $this->getXmlWriter();
@@ -114,7 +115,7 @@ private function writeStyle()
      *
      * @param \PhpOffice\PhpWord\Shared\XMLWriter $xmlWriter
      * @param string $name
-     * @param string $value
+     * @param mixed $value
      */
     private function writeChildStyle(XMLWriter $xmlWriter, $name, $value)
     {
@@ -131,7 +132,7 @@ private function writeChildStyle(XMLWriter $xmlWriter, $name, $value)
      * Write tabs
      *
      * @param \PhpOffice\PhpWord\Shared\XMLWriter $xmlWriter
-     * @param array $tabs
+     * @param \PhpOffice\PhpWord\Style\Tab[] $tabs
      */
     private function writeTabs(XMLWriter $xmlWriter, $tabs)
     {