phptal / PHPTAL

classes/PHPTAL/Php/Attribute/TAL/Attributes.php

Doc Comments +5 added lines

@@ -91,6 +91,7 @@ 
 
     /**
      * attribute will be output regardless of its evaluated value. NULL behaves just like "".
+     * @param string $code
      */
     private function prepareAttributeUnconditional(PHPTAL_Php_CodeWriter $codewriter, $qname, $code)
     {
@@ -107,6 +108,7 @@ 
 
     /**
      * If evaluated value of attribute is NULL, it will not be output at all.
+     * @param string $code
      */
     private function prepareAttributeConditional(PHPTAL_Php_CodeWriter $codewriter, $qname, $code)
     {
@@ -139,6 +141,9 @@ 
         $this->phpelement->getOrCreateAttributeNode($qname)->overwriteFullWithVariable($this->_attkey);
     }
 
+    /**
+     * @param string $code
+     */
     private function prepareBooleanAttribute(PHPTAL_Php_CodeWriter $codewriter, $qname, $code)
     {
         $attkey = $this->getVarName($qname, $codewriter);

classes/PHPTAL/Php/Attribute/TAL/Condition.php

Doc Comments +4 added lines

@@ -61,6 +61,10 @@
     }
 
 
+    /**
+     * @param string $exp
+     * @param boolean $islast
+     */
     public function talesChainPart(PHPTAL_Php_TalesChainExecutor $executor, $exp, $islast)
     {
         // check if the expression is empty

classes/PHPTAL/Php/State.php

Doc Comments +5 added lines, -2 removed lines

@@ -98,7 +98,7 @@ 
     /**
      * Syntax rules to follow in generated code
      *
-     * @return one of PHPTAL::XHTML, PHPTAL::XML, PHPTAL::HTML5
+     * @return integer of PHPTAL::XHTML, PHPTAL::XML, PHPTAL::HTML5
      */
     public function getOutputMode()
     {
@@ -183,6 +183,9 @@ 
         return $this->_interpolateTalesVarsCallback($matches, 'cdata');
     }
 
+    /**
+     * @param string $format
+     */
     private function _interpolateTalesVarsCallback($matches, $format)
     {
         // replaces $${ with literal ${ (or $$$${ with $${ etc)
@@ -225,7 +228,7 @@ 
      * expects PHP code and returns PHP code that will generate escaped string
      * Optimizes case when PHP string is given.
      *
-     * @return php code
+     * @return string code
      */
     public function htmlchars($php)
     {

classes/PHPTAL/Php/TalesInternal.php

Doc Comments +5 added lines

@@ -228,6 +228,7 @@ 
 
     /**
      * @param string $tales_prefix prefix added to all TALES in the string
+     * @param boolean $nothrow
      */
     static public function parseString($expression, $nothrow, $tales_prefix)
     {
@@ -435,6 +436,10 @@ 
      * helper function for compileToPHPExpression
      * @access private
      */
+
+    /**
+     * @param boolean $nothrow
+     */
     private static function convertExpressionsToExpression(array $array, $nothrow)
     {
         if (count($array)==1) return '($ctx->noThrow('.($nothrow?'true':'false').')||1?('.

classes/PHPTAL/PreFilter/Compress.php

Doc Comments +3 added lines

@@ -139,6 +139,9 @@
         'html','head','table','thead','tfoot','select','optgroup','dl','ol','ul','tr','datalist',
     );
 
+    /**
+     * @return PHPTAL_Dom_Element
+     */
     private function hasNoInterelementSpace(PHPTAL_Dom_Element $element)
     {
         if ($element->getLocalName() === 'block'

classes/PHPTAL/PreFilter/Normalize.php

Doc Comments +1 added lines

@@ -86,6 +86,7 @@
 
     /**
      * does not trim
+     * @return string
      */
     protected function normalizeSpace($text, $encoding)
     {

classes/PHPTAL/StringSource.php

Doc Comments +4 added lines

@@ -21,6 +21,10 @@
 {
     const NO_PATH_PREFIX = '<string ';
 
+    /**
+     * @param string $data
+     * @param string $realpath
+     */
     public function __construct($data, $realpath = null)
     {
         $this->_data = $data;

classes/PHPTAL/TalesRegistry.php

Doc Comments +1 added lines, -1 removed lines

@@ -75,7 +75,7 @@
      * callback.
      *
      * @param string $prefix
-     * @param mixed $callback
+     * @param string[] $callback
      * @param bool $is_fallback if true, method will be used as last resort (if there's no phptal_tales_foo)
      */
     public function registerPrefix($prefix, $callback, $is_fallback = false)

tools/phptal_lint.php

Doc Comments +13 added lines

@@ -127,6 +127,10 @@ 
         echo "  Use 'phptal_lint.php .' to scan current directory\n\n";
     }
 
+    /**
+     * @param integer $num
+     * @param string $word
+     */
     function plural($num, $word)
     {
         if ($num == 1) return "$num $word";
@@ -196,6 +200,9 @@ 
     public $skipped = 0, $skipped_filenames = array();
     public $checked = 0;
 
+    /**
+     * @param boolean $bool
+     */
     function skipUnknownModifiers($bool)
     {
         $this->skipUnknownModifiers = $bool;
@@ -205,11 +212,17 @@ 
         $this->accept_pattern = '/\.(?:' . implode('|', $ext) . ')$/i';
     }
 
+    /**
+     * @param string $symbol
+     */
     protected function reportProgress($symbol)
     {
         echo $symbol;
     }
 
+    /**
+     * @param string $path
+     */
     function scan($path)
     {
         foreach (new DirectoryIterator($path) as $entry) {