@@ -81,6 +81,9 @@  | 
                                                    ||
| 81 | 81 | return strlen($string);  | 
                                                        
| 82 | 82 | }  | 
                                                        
| 83 | 83 | |
| 84 | + /**  | 
                                                        |
| 85 | + * @param integer $start  | 
                                                        |
| 86 | + */  | 
                                                        |
| 84 | 87 | public static function substr($string, $start, $length = null, $encoding = false)  | 
                                                        
| 85 | 88 |      { | 
                                                        
| 86 | 89 |          if (extension_loaded('mbstring')) { | 
                                                        
@@ -9,6 +9,11 @@  | 
                                                    ||
| 9 | 9 | public $class = null;  | 
                                                        
| 10 | 10 |      public $hints = array('docstring'); | 
                                                        
| 11 | 11 | |
| 12 | + /**  | 
                                                        |
| 13 | + * @param string $docstring  | 
                                                        |
| 14 | + * @param string $file  | 
                                                        |
| 15 | + * @param integer $line  | 
                                                        |
| 16 | + */  | 
                                                        |
| 12 | 17 | public function __construct($docstring, $file, $line, $class = null)  | 
                                                        
| 13 | 18 |      { | 
                                                        
| 14 | 19 |          parent::__construct('Docstring'); | 
                                                        
@@ -59,6 +59,10 @@  | 
                                                    ||
| 59 | 59 | $o->addRepresentation($r, 0);  | 
                                                        
| 60 | 60 | }  | 
                                                        
| 61 | 61 | |
| 62 | + /**  | 
                                                        |
| 63 | + * @param string $var  | 
                                                        |
| 64 | + * @param string|null $parent_path  | 
                                                        |
| 65 | + */  | 
                                                        |
| 62 | 66 | protected static function xmlToSimpleXML($var, $parent_path)  | 
                                                        
| 63 | 67 |      { | 
                                                        
| 64 | 68 |          try { | 
                                                        
@@ -16,6 +16,7 @@  | 
                                                    ||
| 16 | 16 | |
| 17 | 17 | /**  | 
                                                        
| 18 | 18 | * Renders a locked header.  | 
                                                        
| 19 | + * @param string $content  | 
                                                        |
| 19 | 20 | */  | 
                                                        
| 20 | 21 | public function renderLockedHeader(BasicObject $o, $content)  | 
                                                        
| 21 | 22 |      { | 
                                                        
@@ -155,6 +155,9 @@ discard block  | 
                                                    ||
| 155 | 155 | return '<dl>'.$header.$children.'</dl>';  | 
                                                        
| 156 | 156 | }  | 
                                                        
| 157 | 157 | |
| 158 | + /**  | 
                                                        |
| 159 | + * @param boolean $has_children  | 
                                                        |
| 160 | + */  | 
                                                        |
| 158 | 161 | public function renderHeaderWrapper(BasicObject $o, $has_children, $contents)  | 
                                                        
| 159 | 162 |      { | 
                                                        
| 160 | 163 | $out = '<dt';  | 
                                                        
@@ -281,6 +284,9 @@ discard block  | 
                                                    ||
| 281 | 284 | return $output.'</dd>';  | 
                                                        
| 282 | 285 | }  | 
                                                        
| 283 | 286 | |
| 287 | + /**  | 
                                                        |
| 288 | + * @return string  | 
                                                        |
| 289 | + */  | 
                                                        |
| 284 | 290 | protected function renderTab(BasicObject $o, Representation $rep)  | 
                                                        
| 285 | 291 |      { | 
                                                        
| 286 | 292 |          if ($plugin = $this->getPlugin(self::$tab_plugins, $rep->hints)) { | 
                                                        
@@ -20,7 +20,7 @@  | 
                                                    ||
| 20 | 20 | /**  | 
                                                        
| 21 | 21 | * Asserts that a condition is true.  | 
                                                        
| 22 | 22 | *  | 
                                                        
| 23 | - * @param array $expected  | 
                                                        |
| 23 | + * @param string[] $expected  | 
                                                        |
| 24 | 24 | * @param string $actual  | 
                                                        
| 25 | 25 | * @param string $message  | 
                                                        
| 26 | 26 | *  | 
                                                        
@@ -55,6 +55,9 @@ discard block  | 
                                                    ||
| 55 | 55 | return true;  | 
                                                        
| 56 | 56 | }  | 
                                                        
| 57 | 57 | |
| 58 | + /**  | 
                                                        |
| 59 | + * @param integer $pos  | 
                                                        |
| 60 | + */  | 
                                                        |
| 58 | 61 | public function replaceRepresentation(Representation $rep, $pos = null)  | 
                                                        
| 59 | 62 |      { | 
                                                        
| 60 | 63 |          if ($pos === null) { | 
                                                        
@@ -74,6 +77,9 @@ discard block  | 
                                                    ||
| 74 | 77 | }  | 
                                                        
| 75 | 78 | }  | 
                                                        
| 76 | 79 | |
| 80 | + /**  | 
                                                        |
| 81 | + * @param string $name  | 
                                                        |
| 82 | + */  | 
                                                        |
| 77 | 83 | public function getRepresentation($name)  | 
                                                        
| 78 | 84 |      { | 
                                                        
| 79 | 85 |          if (isset($this->representations[$name])) { | 
                                                        
@@ -11,6 +11,10 @@  | 
                                                    ||
| 11 | 11 | |
| 12 | 12 | protected $name;  | 
                                                        
| 13 | 13 | |
| 14 | + /**  | 
                                                        |
| 15 | + * @param string $label  | 
                                                        |
| 16 | + * @param string $name  | 
                                                        |
| 17 | + */  | 
                                                        |
| 14 | 18 | public function __construct($label, $name = null)  | 
                                                        
| 15 | 19 |      { | 
                                                        
| 16 | 20 | $this->label = $label;  | 
                                                        
@@ -145,6 +145,9 @@  | 
                                                    ||
| 145 | 145 |          return "<a {$class}href=\"{$ideLink}\">{$shortenedPath}:{$line}</a>"; | 
                                                        
| 146 | 146 | }  | 
                                                        
| 147 | 147 | |
| 148 | + /**  | 
                                                        |
| 149 | + * @param string $string  | 
                                                        |
| 150 | + */  | 
                                                        |
| 148 | 151 | public function escape($string, $encoding = false)  | 
                                                        
| 149 | 152 |      { | 
                                                        
| 150 | 153 |          if ($encoding === false) { |