MarcusSchwarz / lesserphp

src/LesserPhp/Compiler.php

Doc Comments +20 added lines, -1 removed lines

@@ -181,7 +181,7 @@ 
     /**
      * attempts to find the path of an import url, returns null for css files
      *
-     * @param $url
+     * @param string $url
      *
      * @return null|string
      */
@@ -197,6 +197,9 @@ 
         return null;
     }
 
+    /**
+     * @param string $name
+     */
     protected function fileExists($name)
     {
         return is_file($name);
@@ -398,6 +401,9 @@ 
         return $scope;
     }
 
+    /**
+     * @param string[] $selectors
+     */
     protected function compileNestedBlock($block, $selectors)
     {
         $this->pushEnv($this->env, $block);
@@ -418,6 +424,9 @@ 
         $this->popEnv();
     }
 
+    /**
+     * @param \stdClass $out
+     */
     protected function compileProps($block, $out)
     {
         foreach ($this->sortProps($block->props) as $prop) {
@@ -1349,6 +1358,9 @@ 
         return $value;
     }
 
+    /**
+     * @param boolean $a
+     */
     public function toBool($a)
     {
         if ($a) {
@@ -1565,6 +1577,10 @@ 
     }
 
     // the state of execution
+
+    /**
+     * @param NodeEnv $parent
+     */
     protected function pushEnv($parent, $block = null)
     {
         $e = new \LesserPhp\NodeEnv();
@@ -1875,6 +1891,9 @@ 
         return $out;
     }
 
+    /**
+     * @param string|null $name
+     */
     protected function makeParser($name)
     {
         $parser = new \LesserPhp\Parser($this, $name);

src/LesserPhp/Parser.php

Doc Comments +26 added lines

@@ -114,6 +114,9 @@ 
         }
     }
 
+    /**
+     * @param string $buffer
+     */
     public function parse($buffer)
     {
         $this->count = 0;
@@ -483,6 +486,7 @@ 
 
     /**
      * recursively parse infix equation with $lhs at precedence $minP
+     * @param integer $minP
      */
     protected function expHelper($lhs, $minP)
     {
@@ -775,6 +779,11 @@ 
     }
 
     // an unbounded string stopped by $end
+
+    /**
+     * @param string $end
+     * @param string[] $rejectStrs
+     */
     protected function openString($end, &$out, $nestingOpen = null, $rejectStrs = null)
     {
         $oldWhite = $this->eatWhiteDefault;
@@ -1429,6 +1438,9 @@ 
 
     /* raw parsing functions */
 
+    /**
+     * @param boolean $eatWhitespace
+     */
     protected function literal($what, $eatWhitespace = null)
     {
         if ($eatWhitespace === null) {
@@ -1456,6 +1468,9 @@ 
         return $this->match(self::$literalCache[$what], $m, $eatWhitespace);
     }
 
+    /**
+     * @param string $parseItem
+     */
     protected function genericList(&$out, $parseItem, $delim = "", $flatten = true)
     {
         $s = $this->seek();
@@ -1549,6 +1564,10 @@ 
     }
 
     // match something without consuming it
+
+    /**
+     * @param string $regex
+     */
     protected function peek($regex, &$out = null, $from = null)
     {
         if ($from === null) {
@@ -1572,6 +1591,9 @@ 
 
     /* misc functions */
 
+    /**
+     * @param integer $count
+     */
     public function throwError($msg = "parse error", $count = null)
     {
         $count = $count === null ? $this->count : $count;
@@ -1621,6 +1643,10 @@ 
     }
 
     // push a block that doesn't multiply tags
+
+    /**
+     * @param string $type
+     */
     protected function pushSpecialBlock($type)
     {
         return $this->pushBlock(null, $type);