nikic / PHP-Parser

grammar/analyze.php

Doc Comments +6 added lines

@@ -20,10 +20,16 @@
     'case_separator', 'optional_comma'
 ));
 
+/**
+ * @param string $regex
+ */
 function regex($regex) {
     return '~' . LIB . '(?:' . str_replace('~', '\~', $regex) . ')~';
 }
 
+/**
+ * @param string $regex
+ */
 function magicSplit($regex, $string) {
     $pieces = preg_split(regex('(?:(?&string)|(?&comment)|(?&code))(*SKIP)(*FAIL)|' . $regex), $string);
 

grammar/rebuildParsers.php

Doc Comments +9 added lines

@@ -175,6 +175,9 @@ 
     );
 }
 
+/**
+ * @param integer $num
+ */
 function assertArgs($num, $args, $name) {
     if ($num != count($args)) {
         die('Wrong argument count for ' . $name . '().');
@@ -203,10 +206,16 @@ 
 /// Regex helper functions ///
 //////////////////////////////
 
+/**
+ * @param string $regex
+ */
 function regex($regex) {
     return '~' . LIB . '(?:' . str_replace('~', '\~', $regex) . ')~';
 }
 
+/**
+ * @param string $regex
+ */
 function magicSplit($regex, $string) {
     $pieces = preg_split(regex('(?:(?&string)|(?&comment)|(?&code))(*SKIP)(*FAIL)|' . $regex), $string);
 

lib/PhpParser/Builder/Class_.php

Doc Comments -2 removed lines

@@ -44,8 +44,6 @@
     /**
      * Implements one or more interfaces.
      *
-     * @param Name|string $interface Name of interface to implement
-     * @param Name|string $...       More interfaces to implement
      *
      * @return $this The builder instance (for fluid interface)
      */

lib/PhpParser/Builder/Interface_.php

Doc Comments -2 removed lines

@@ -25,8 +25,6 @@
     /**
      * Extends one or more interfaces.
      *
-     * @param Name|string $interface Name of interface to extend
-     * @param Name|string $...       More interfaces to extend
      *
      * @return $this The builder instance (for fluid interface)
      */

lib/PhpParser/NodeVisitor/NameResolver.php

Doc Comments +3 added lines

@@ -110,6 +110,9 @@
         );
     }
 
+    /**
+     * @param Name $type
+     */
     protected function addAlias(Stmt\UseUse $use, $type, Name $prefix = null) {
         // Add prefix for group uses
         $name = $prefix ? Name::concat($prefix, $use->name) : $use->name;

lib/PhpParser/Parser/Multiple.php

Doc Comments +3 added lines

@@ -51,6 +51,9 @@
         return $this->errors;
     }
 
+    /**
+     * @param string $code
+     */
     private function tryParse(Parser $parser, $code) {
         $stmts = null;
         $error = null;

lib/PhpParser/PrettyPrinter/Standard.php

Doc Comments +12 added lines

@@ -534,6 +534,9 @@ 
              . ($node->name->getLast() !== $node->alias ? ' as ' . $node->alias : '');
     }
 
+    /**
+     * @param integer $type
+     */
     private function pUseType($type) {
         return $type === Stmt\Use_::TYPE_FUNCTION ? 'function '
             : ($type === Stmt\Use_::TYPE_CONSTANT ? 'const ' : '');
@@ -744,6 +747,9 @@ 
         return is_string($node) ? $node : $this->p($node);
     }
 
+    /**
+     * @param string $afterClassToken
+     */
     protected function pClassCommon(Stmt\Class_ $node, $afterClassToken) {
         return $this->pModifiers($node->type)
         . 'class' . $afterClassToken
@@ -760,6 +766,9 @@ 
         }
     }
 
+    /**
+     * @param integer $modifiers
+     */
     protected function pModifiers($modifiers) {
         return ($modifiers & Stmt\Class_::MODIFIER_PUBLIC    ? 'public '    : '')
              . ($modifiers & Stmt\Class_::MODIFIER_PROTECTED ? 'protected ' : '')
@@ -769,6 +778,9 @@ 
              . ($modifiers & Stmt\Class_::MODIFIER_FINAL     ? 'final '     : '');
     }
 
+    /**
+     * @param string $quote
+     */
     protected function pEncapsList(array $encapsList, $quote) {
         $return = '';
         foreach ($encapsList as $element) {

lib/PhpParser/PrettyPrinterAbstract.php

Doc Comments +13 added lines, -1 removed lines

@@ -187,6 +187,10 @@ 
         return $this->{'p' . $node->getType()}($node);
     }
 
+    /**
+     * @param string $type
+     * @param string $operatorString
+     */
     protected function pInfixOp($type, Node $leftNode, $operatorString, Node $rightNode) {
         list($precedence, $associativity) = $this->precedenceMap[$type];
 
@@ -195,11 +199,19 @@ 
              . $this->pPrec($rightNode, $precedence, $associativity, 1);
     }
 
+    /**
+     * @param string $type
+     * @param string $operatorString
+     */
     protected function pPrefixOp($type, $operatorString, Node $node) {
         list($precedence, $associativity) = $this->precedenceMap[$type];
         return $operatorString . $this->pPrec($node, $precedence, $associativity, 1);
     }
 
+    /**
+     * @param string $type
+     * @param string $operatorString
+     */
     protected function pPostfixOp($type, Node $node, $operatorString) {
         list($precedence, $associativity) = $this->precedenceMap[$type];
         return $this->pPrec($node, $precedence, $associativity, -1) . $operatorString;
@@ -264,7 +276,7 @@ 
      *
      * @param string $string Not to be indented string
      *
-     * @return mixed String marked with $this->noIndentToken's.
+     * @return string String marked with $this->noIndentToken's.
      */
     protected function pNoIndent($string) {
         return str_replace("\n", "\n" . $this->noIndentToken, $string);