QA: Docblock improvements and -q parameter for phpdoc

.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)
  {