@@ -72,7 +72,7 @@  | 
                                                    ||
| 72 | 72 | /**  | 
                                                        
| 73 | 73 | * @param array  | 
                                                        
| 74 | 74 | *  | 
                                                        
| 75 | - * @return HTML  | 
                                                        |
| 75 | + * @return string  | 
                                                        |
| 76 | 76 | */  | 
                                                        
| 77 | 77 |  	public function getAttributesHTML($attrs = null) { | 
                                                        
| 78 | 78 | $exclude = (is_string($attrs)) ? func_get_args() : null;  | 
                                                        
@@ -14,6 +14,10 @@  | 
                                                    ||
| 14 | 14 | */  | 
                                                        
| 15 | 15 | protected $group;  | 
                                                        
| 16 | 16 | |
| 17 | + /**  | 
                                                        |
| 18 | + * @param SecurityAdmin $controller  | 
                                                        |
| 19 | + * @param string $name  | 
                                                        |
| 20 | + */  | 
                                                        |
| 17 | 21 |  	public function __construct($controller, $name, $fields = null, $actions = null, $validator = null) { | 
                                                        
| 18 | 22 |  		if(!$fields) { | 
                                                        
| 19 | 23 | $helpHtml = _t(  | 
                                                        
@@ -14,6 +14,10 @@ discard block  | 
                                                    ||
| 14 | 14 | */  | 
                                                        
| 15 | 15 | protected $group;  | 
                                                        
| 16 | 16 | |
| 17 | + /**  | 
                                                        |
| 18 | + * @param SecurityAdmin $controller  | 
                                                        |
| 19 | + * @param string $name  | 
                                                        |
| 20 | + */  | 
                                                        |
| 17 | 21 |  	public function __construct($controller, $name, $fields = null, $actions = null, $validator = null) { | 
                                                        
| 18 | 22 |  		if(!$fields) { | 
                                                        
| 19 | 23 | $helpHtml = _t(  | 
                                                        
@@ -100,7 +104,7 @@ discard block  | 
                                                    ||
| 100 | 104 | }  | 
                                                        
| 101 | 105 | |
| 102 | 106 | /**  | 
                                                        
| 103 | - * @param $group Group  | 
                                                        |
| 107 | + * @param DataObject $group Group  | 
                                                        |
| 104 | 108 | */  | 
                                                        
| 105 | 109 |  	public function setGroup($group) { | 
                                                        
| 106 | 110 | $this->group = $group;  | 
                                                        
@@ -45,7 +45,7 @@  | 
                                                    ||
| 45 | 45 | * @param DataObjectInterface $obj  | 
                                                        
| 46 | 46 | * @param $fields  | 
                                                        
| 47 | 47 | * @param $relations  | 
                                                        
| 48 | - * @return EmptyJSONObject  | 
                                                        |
| 48 | + * @return stdClass  | 
                                                        |
| 49 | 49 | */  | 
                                                        
| 50 | 50 |  	public function convertDataObjectToJSONObject(DataObjectInterface $obj, $fields = null, $relations = null) { | 
                                                        
| 51 | 51 | $className = $obj->class;  | 
                                                        
@@ -354,7 +354,7 @@ discard block  | 
                                                    ||
| 354 | 354 | *  | 
                                                        
| 355 | 355 | * @param string $property  | 
                                                        
| 356 | 356 | * the name of the property  | 
                                                        
| 357 | - * @param object $object  | 
                                                        |
| 357 | + * @param string $object  | 
                                                        |
| 358 | 358 | * the object to be set  | 
                                                        
| 359 | 359 | */  | 
                                                        
| 360 | 360 |  	public function addAutoProperty($property, $object) { | 
                                                        
@@ -448,7 +448,7 @@ discard block  | 
                                                    ||
| 448 | 448 | * The name of the service to update the definition for  | 
                                                        
| 449 | 449 | * @param string $property  | 
                                                        
| 450 | 450 | * The name of the property to update.  | 
                                                        
| 451 | - * @param mixed $value  | 
                                                        |
| 451 | + * @param string $value  | 
                                                        |
| 452 | 452 | * The value to set  | 
                                                        
| 453 | 453 | * @param boolean $append  | 
                                                        
| 454 | 454 | * Whether to append (the default) when the property is an array  | 
                                                        
@@ -753,6 +753,7 @@ discard block  | 
                                                    ||
| 753 | 753 | *  | 
                                                        
| 754 | 754 | * Will recursively call hasService for each depth of dotting  | 
                                                        
| 755 | 755 | *  | 
                                                        
| 756 | + * @param string $name  | 
                                                        |
| 756 | 757 | * @return string  | 
                                                        
| 757 | 758 | * The name of the service (as it might be different from the one passed in)  | 
                                                        
| 758 | 759 | */  | 
                                                        
@@ -929,8 +930,6 @@ discard block  | 
                                                    ||
| 929 | 930 | *  | 
                                                        
| 930 | 931 | * @param string $name  | 
                                                        
| 931 | 932 | * Name of the class to create an object of  | 
                                                        
| 932 | - * @param array $args  | 
                                                        |
| 933 | - * Arguments to pass to the constructor  | 
                                                        |
| 934 | 933 | * @return mixed  | 
                                                        
| 935 | 934 | */  | 
                                                        
| 936 | 935 |  	public function createWithArgs($name, $constructorArgs) { | 
                                                        
@@ -35,9 +35,9 @@ discard block  | 
                                                    ||
| 35 | 35 | protected $fragmentOverride = null;  | 
                                                        
| 36 | 36 | |
| 37 | 37 | /**  | 
                                                        
| 38 | - * @param RequestHandler $controller  | 
                                                        |
| 39 | 38 | * @param SS_HTTPResponse An existing response to reuse (optional)  | 
                                                        
| 40 | 39 | * @param Array $callbacks  | 
                                                        
| 40 | + * @param SS_HTTPResponse $response  | 
                                                        |
| 41 | 41 | */  | 
                                                        
| 42 | 42 |  	public function __construct($callbacks = array(), $response = null) { | 
                                                        
| 43 | 43 | $this->callbacks = $callbacks;  | 
                                                        
@@ -61,7 +61,6 @@ discard block  | 
                                                    ||
| 61 | 61 | * @param array $extraCallbacks List of anonymous functions or callables returning either a string  | 
                                                        
| 62 | 62 | * or SS_HTTPResponse, keyed by their fragment identifier. The 'default' key can  | 
                                                        
| 63 | 63 | * be used as a fallback for non-ajax responses.  | 
                                                        
| 64 | - * @param array $fragmentOverride Change the response fragments.  | 
                                                        |
| 65 | 64 | * @return SS_HTTPResponse  | 
                                                        
| 66 | 65 | */  | 
                                                        
| 67 | 66 |  	public function respond(SS_HTTPRequest $request, $extraCallbacks = array()) { | 
                                                        
@@ -109,7 +108,7 @@ discard block  | 
                                                    ||
| 109 | 108 | /**  | 
                                                        
| 110 | 109 | * Set up fragment overriding - will completely replace the incoming fragments.  | 
                                                        
| 111 | 110 | *  | 
                                                        
| 112 | - * @param array $fragments Fragments to insert.  | 
                                                        |
| 111 | + * @param string[] $fragments Fragments to insert.  | 
                                                        |
| 113 | 112 | */  | 
                                                        
| 114 | 113 |  	public function setFragmentOverride($fragments) { | 
                                                        
| 115 | 114 | if (!is_array($fragments)) throw new InvalidArgumentException();  | 
                                                        
@@ -168,7 +168,7 @@  | 
                                                    ||
| 168 | 168 | *  | 
                                                        
| 169 | 169 | * Actually only one array argument is supported.  | 
                                                        
| 170 | 170 | *  | 
                                                        
| 171 | - * @param $f callback to apply  | 
                                                        |
| 171 | + * @param string $f callback to apply  | 
                                                        |
| 172 | 172 | * @param $array array  | 
                                                        
| 173 | 173 | * @return array  | 
                                                        
| 174 | 174 | */  | 
                                                        
@@ -219,6 +219,7 @@ discard block  | 
                                                    ||
| 219 | 219 | |
| 220 | 220 | /**  | 
                                                        
| 221 | 221 | * Returns true if the given class implements the given interface  | 
                                                        
| 222 | + * @param string $interfaceName  | 
                                                        |
| 222 | 223 | */  | 
                                                        
| 223 | 224 |  	public static function classImplements($className, $interfaceName) { | 
                                                        
| 224 | 225 | return in_array($className, self::implementorsOf($interfaceName));  | 
                                                        
@@ -269,6 +270,9 @@ discard block  | 
                                                    ||
| 269 | 270 | |
| 270 | 271 | private static $method_from_cache = array();  | 
                                                        
| 271 | 272 | |
| 273 | + /**  | 
                                                        |
| 274 | + * @param string $method  | 
                                                        |
| 275 | + */  | 
                                                        |
| 272 | 276 |  	public static function has_method_from($class, $method, $compclass) { | 
                                                        
| 273 | 277 | $lClass = strtolower($class);  | 
                                                        
| 274 | 278 | $lMethod = strtolower($method);  | 
                                                        
@@ -247,6 +247,10 @@ discard block  | 
                                                    ||
| 247 | 247 | * match. The caller must trim matching lines from the beginning and end  | 
                                                        
| 248 | 248 | * of the portions it is going to specify.  | 
                                                        
| 249 | 249 | */  | 
                                                        
| 250 | +  | 
                                                        |
| 251 | + /**  | 
                                                        |
| 252 | + * @param double $nchunks  | 
                                                        |
| 253 | + */  | 
                                                        |
| 250 | 254 |  	public function _diag ($xoff, $xlim, $yoff, $ylim, $nchunks) { | 
                                                        
| 251 | 255 | $flip = false;  | 
                                                        
| 252 | 256 | |
@@ -357,6 +361,11 @@ discard block  | 
                                                    ||
| 357 | 361 | * Note that XLIM, YLIM are exclusive bounds.  | 
                                                        
| 358 | 362 | * All line numbers are origin-0 and discarded lines are not counted.  | 
                                                        
| 359 | 363 | */  | 
                                                        
| 364 | +  | 
                                                        |
| 365 | + /**  | 
                                                        |
| 366 | + * @param integer $xoff  | 
                                                        |
| 367 | + * @param integer $yoff  | 
                                                        |
| 368 | + */  | 
                                                        |
| 360 | 369 |  	public function _compareseq ($xoff, $xlim, $yoff, $ylim) { | 
                                                        
| 361 | 370 | // Slide down the bottom initial diagonal.  | 
                                                        
| 362 | 371 | while ($xoff < $xlim && $yoff < $ylim  | 
                                                        
@@ -554,7 +563,7 @@ discard block  | 
                                                    ||
| 554 | 563 | *  | 
                                                        
| 555 | 564 | * $diff = new Diff($lines1, $lines2);  | 
                                                        
| 556 | 565 | * $rev = $diff->reverse();  | 
                                                        
| 557 | - * @return object A Diff object representing the inverse of the  | 
                                                        |
| 566 | + * @return Diff A Diff object representing the inverse of the  | 
                                                        |
| 558 | 567 | * original diff.  | 
                                                        
| 559 | 568 | */  | 
                                                        
| 560 | 569 |  	public function reverse () { |