[CHANGED] Docblock for pass-by-reference parameters.

This commit is contained in:
Roman Syroeshko 2014-07-03 16:11:15 +04:00
parent d0a609bc95
commit 8056b6926c
19 changed files with 42 additions and 42 deletions

View File

@ -38,7 +38,7 @@ class Media
* @param string $container section|headerx|footerx|footnote|endnote
* @param string $mediaType image|object|link
* @param string $source
* @param \PhpOffice\PhpWord\Element\Image $image
* @param \PhpOffice\PhpWord\Element\Image &$image
* @return integer
* @throws \PhpOffice\PhpWord\Exception\Exception
* @since 0.9.2

View File

@ -53,7 +53,7 @@ class ODText extends AbstractReader implements ReaderInterface
/**
* Read document part.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @param array $relationships
* @param string $partName
* @param string $docFile

View File

@ -30,7 +30,7 @@ class Content extends AbstractPart
/**
* Read content.xml.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @return void
*/
public function read(PhpWord &$phpWord)

View File

@ -30,7 +30,7 @@ class Meta extends AbstractPart
/**
* Read meta.xml.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @return void
* @todo Process property type
*/

View File

@ -129,7 +129,7 @@ class Document
* - Builds control words and control symbols
* - Pushes every other character into the text queue
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @return void
* @todo Use `fread` stream for scalability
*/

View File

@ -77,7 +77,7 @@ class Word2007 extends AbstractReader implements ReaderInterface
/**
* Read document part.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @param array $relationships
* @param string $partName
* @param string $docFile

View File

@ -94,7 +94,7 @@ abstract class AbstractPart
*
* @param \PhpOffice\PhpWord\Shared\XMLReader $xmlReader
* @param \DOMElement $domNode
* @param mixed $parent
* @param mixed &$parent
* @param string $docPart
* @return void
*
@ -185,7 +185,7 @@ abstract class AbstractPart
*
* @param \PhpOffice\PhpWord\Shared\XMLReader $xmlReader
* @param \DOMElement $domNode
* @param mixed $parent
* @param mixed &$parent
* @param string $docPart
* @param mixed $paragraphStyle
* @return void
@ -248,7 +248,7 @@ abstract class AbstractPart
*
* @param \PhpOffice\PhpWord\Shared\XMLReader $xmlReader
* @param \DOMElement $domNode
* @param mixed $parent
* @param mixed &$parent
* @param string $docPart
* @return void
*/

View File

@ -54,7 +54,7 @@ class DocPropsCore extends AbstractPart
/**
* Read core/extended document properties.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @return void
*/
public function read(PhpWord &$phpWord)

View File

@ -31,7 +31,7 @@ class DocPropsCustom extends AbstractPart
/**
* Read custom document properties.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @return void
*/
public function read(PhpWord &$phpWord)

View File

@ -39,7 +39,7 @@ class Document extends AbstractPart
/**
* Read document.xml.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @return void
*/
public function read(PhpWord &$phpWord)
@ -65,7 +65,7 @@ class Document extends AbstractPart
* Read header footer.
*
* @param array $settings
* @param \PhpOffice\PhpWord\Element\Section $section
* @param \PhpOffice\PhpWord\Element\Section &$section
* @return void
*/
private function readHeaderFooter($settings, Section &$section)
@ -144,7 +144,7 @@ class Document extends AbstractPart
*
* @param \PhpOffice\PhpWord\Shared\XMLReader $xmlReader
* @param \DOMElement $node
* @param \PhpOffice\PhpWord\Element\Section $section
* @param \PhpOffice\PhpWord\Element\Section &$section
* @return void
*
* @todo <w:lastRenderedPageBreak>
@ -174,7 +174,7 @@ class Document extends AbstractPart
*
* @param \PhpOffice\PhpWord\Shared\XMLReader $xmlReader
* @param \DOMElement $node
* @param \PhpOffice\PhpWord\Element\Section $section
* @param \PhpOffice\PhpWord\Element\Section &$section
* @return void
*/
private function readWSectPrNode(XMLReader $xmlReader, \DOMElement $node, Section &$section)

View File

@ -44,7 +44,7 @@ class Footnotes extends AbstractPart
/**
* Read (footnotes|endnotes).xml.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @return void
*/
public function read(PhpWord &$phpWord)

View File

@ -30,7 +30,7 @@ class Numbering extends AbstractPart
/**
* Read numbering.xml.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @return void
*/
public function read(PhpWord &$phpWord)

View File

@ -30,7 +30,7 @@ class Styles extends AbstractPart
/**
* Read styles.xml.
*
* @param \PhpOffice\PhpWord\PhpWord $phpWord
* @param \PhpOffice\PhpWord\PhpWord &$phpWord
* @return void
*/
public function read(PhpWord &$phpWord)

View File

@ -191,7 +191,7 @@ class Html
*
* @param \DOMNode $node
* @param \PhpOffice\PhpWord\Element\AbstractContainer $element
* @param array $styles
* @param array &$styles
* @return \PhpOffice\PhpWord\Element\TextRun
*/
private static function parseParagraph($node, $element, &$styles)
@ -206,7 +206,7 @@ class Html
* Parse heading node
*
* @param \PhpOffice\PhpWord\Element\AbstractContainer $element
* @param array $styles
* @param array &$styles
* @param string $argument1 Name of heading style
* @return \PhpOffice\PhpWord\Element\TextRun
*
@ -226,7 +226,7 @@ class Html
*
* @param \DOMNode $node
* @param \PhpOffice\PhpWord\Element\AbstractContainer $element
* @param array $styles
* @param array &$styles
* @return null
*/
private static function parseText($node, $element, &$styles)
@ -245,7 +245,7 @@ class Html
/**
* Parse property node
*
* @param array $styles
* @param array &$styles
* @param string $argument1 Style name
* @param string $argument2 Style value
* @return null
@ -262,7 +262,7 @@ class Html
*
* @param \DOMNode $node
* @param \PhpOffice\PhpWord\Element\AbstractContainer $element
* @param array $styles
* @param array &$styles
* @param string $argument1 Method name
* @return \PhpOffice\PhpWord\Element\AbstractContainer $element
*
@ -292,8 +292,8 @@ class Html
/**
* Parse list node
*
* @param array $styles
* @param array $data
* @param array &$styles
* @param array &$data
* @param string $argument1 List type
* @return null
*/
@ -314,7 +314,7 @@ class Html
*
* @param \DOMNode $node
* @param \PhpOffice\PhpWord\Element\AbstractContainer $element
* @param array $styles
* @param array &$styles
* @param array $data
* @return null
*

View File

@ -297,7 +297,7 @@ abstract class AbstractStyle
*
* @param mixed $value
* @param string $styleName
* @param mixed $style
* @param mixed &$style
* @return mixed
*/
protected function setObjectVal($value, $styleName, &$style)
@ -319,8 +319,8 @@ abstract class AbstractStyle
/**
* Set $property value and set $pairProperty = false when $value = true
*
* @param bool $property
* @param bool $pairProperty
* @param bool &$property
* @param bool &$pairProperty
* @param bool $value
* @return self
*/

View File

@ -106,7 +106,7 @@ class Template
/**
* Applies XSL style sheet to template's parts.
*
* @param \DOMDocument $xslDOMDocument
* @param \DOMDocument &$xslDOMDocument
* @param array $xslOptions
* @param string $xslOptionsURI
* @return void

View File

@ -23,10 +23,10 @@ use PhpOffice\PhpWord\Element\Text;
use PhpOffice\PhpWord\Element\TextRun;
use PhpOffice\PhpWord\PhpWord;
use PhpOffice\PhpWord\Shared\XMLWriter;
use PhpOffice\PhpWord\Style;
use PhpOffice\PhpWord\Style\Font;
use PhpOffice\PhpWord\Style\Paragraph;
use PhpOffice\PhpWord\Style\Table as TableStyle;
use PhpOffice\PhpWord\Style;
use PhpOffice\PhpWord\Writer\ODText\Element\Container;
use PhpOffice\PhpWord\Writer\ODText\Style\Paragraph as ParagraphStyleWriter;
@ -190,8 +190,8 @@ class Content extends AbstractPart
* Table style can be null or string of the style name
*
* @param \PhpOffice\PhpWord\Element\AbstractContainer $container
* @param int $paragraphStyleCount
* @param int $fontStyleCount
* @param int &$paragraphStyleCount
* @param int &$fontStyleCount
* @return void
* @todo Simplify the logic
*/
@ -223,9 +223,9 @@ class Content extends AbstractPart
/**
* Get style of individual element
*
* @param \PhpOffice\PhpWord\Element\Text $element
* @param int $paragraphStyleCount
* @param int $fontStyleCount
* @param \PhpOffice\PhpWord\Element\Text &$element
* @param int &$paragraphStyleCount
* @param int &$fontStyleCount
* @return void
*/
private function getElementStyle(&$element, &$paragraphStyleCount, &$fontStyleCount)

View File

@ -19,8 +19,8 @@ namespace PhpOffice\PhpWord\Writer\RTF\Part;
use PhpOffice\PhpWord\Settings;
use PhpOffice\PhpWord\Shared\Converter;
use PhpOffice\PhpWord\Style\Font;
use PhpOffice\PhpWord\Style;
use PhpOffice\PhpWord\Style\Font;
/**
* RTF header part writer
@ -246,7 +246,7 @@ class Header extends AbstractPart
/**
* Register individual font and color.
*
* @param array $table
* @param array &$table
* @param string $value
* @param string $default
* @return void

View File

@ -192,10 +192,10 @@ class Word2007 extends AbstractWriter implements WriterInterface
/**
* Add header/footer content.
*
* @param \PhpOffice\PhpWord\Element\Section $section
* @param \PhpOffice\PhpWord\Element\Section &$section
* @param \PhpOffice\PhpWord\Shared\ZipArchive $zip
* @param string $elmType header|footer
* @param integer $rId
* @param integer &$rId
* @return void
*/
private function addHeaderFooterContent(Section &$section, ZipArchive $zip, $elmType, &$rId)
@ -221,7 +221,7 @@ class Word2007 extends AbstractWriter implements WriterInterface
* Add footnotes/endnotes
*
* @param \PhpOffice\PhpWord\Shared\ZipArchive $zip
* @param integer $rId
* @param integer &$rId
* @param string $noteType
* @return void
*/
@ -259,7 +259,7 @@ class Word2007 extends AbstractWriter implements WriterInterface
* Add chart.
*
* @param \PhpOffice\PhpWord\Shared\ZipArchive $zip
* @param integer $rId
* @param integer &$rId
* @return void
*/
private function addChart(ZipArchive $zip, &$rId)