@@ -38,7 +38,7 @@ discard block  | 
                                                    ||
| 38 | 38 | *  | 
                                                        
| 39 | 39 | * A null argument will log the file and line number of the l() call.  | 
                                                        
| 40 | 40 | *  | 
                                                        
| 41 | - * @param mixed $stuff Information to log.  | 
                                                        |
| 41 | + * @param string $stuff Information to log.  | 
                                                        |
| 42 | 42 | */  | 
                                                        
| 43 | 43 |  function l( $stuff = null ) { | 
                                                        
| 44 | 44 | // Do nothing when debugging is off.  | 
                                                        
@@ -166,7 +166,7 @@ discard block  | 
                                                    ||
| 166 | 166 | *  | 
                                                        
| 167 | 167 | * @param string $name Timer name.  | 
                                                        
| 168 | 168 | *  | 
                                                        
| 169 | - * @return mixed void or elapsed time.  | 
                                                        |
| 169 | + * @return null|double void or elapsed time.  | 
                                                        |
| 170 | 170 | */  | 
                                                        
| 171 | 171 |  function e( $name = '' ) { | 
                                                        
| 172 | 172 | static $times = array();  | 
                                                        
@@ -9,6 +9,9 @@  | 
                                                    ||
| 9 | 9 | |
| 10 | 10 |  class Differences extends PersistentList { | 
                                                        
| 11 | 11 | |
| 12 | + /**  | 
                                                        |
| 13 | + * @param string $path  | 
                                                        |
| 14 | + */  | 
                                                        |
| 12 | 15 |  	private function slashit( $path ) { | 
                                                        
| 13 | 16 | $path .= ( substr( $path, -1 ) == '/' ? '' : '/' );  | 
                                                        
| 14 | 17 | return $path;  | 
                                                        
@@ -37,6 +37,9 @@  | 
                                                    ||
| 37 | 37 | }  | 
                                                        
| 38 | 38 | }  | 
                                                        
| 39 | 39 | |
| 40 | + /**  | 
                                                        |
| 41 | + * @param string $root  | 
                                                        |
| 42 | + */  | 
                                                        |
| 40 | 43 |  	public function scan_dir( $root, $exclude = array() ) { | 
                                                        
| 41 | 44 |  		$filter = function ( $file, $key, $iterator ) use ( $exclude ) { | 
                                                        
| 42 | 45 |  			if ( $iterator->hasChildren() && ! in_array( $file->getFilename(), $exclude ) ) { | 
                                                        
@@ -31,6 +31,7 @@  | 
                                                    ||
| 31 | 31 | |
| 32 | 32 | /**  | 
                                                        
| 33 | 33 | * Saves the items to a file and returns the file contents  | 
                                                        
| 34 | + * @param string $file_path  | 
                                                        |
| 34 | 35 | */  | 
                                                        
| 35 | 36 |  	public function save( $file_path, $allow_empty = true ) { | 
                                                        
| 36 | 37 | |
@@ -11,6 +11,9 @@  | 
                                                    ||
| 11 | 11 | private $declarations;  | 
                                                        
| 12 | 12 | private $current_relative_path;  | 
                                                        
| 13 | 13 | |
| 14 | + /**  | 
                                                        |
| 15 | + * @param $declarations  | 
                                                        |
| 16 | + */  | 
                                                        |
| 14 | 17 |  	public function __construct( $current_relative_path, $declarations ) { | 
                                                        
| 15 | 18 | $this->current_relative_path = $current_relative_path;  | 
                                                        
| 16 | 19 | $this->declarations = $declarations;  | 
                                                        
@@ -9,6 +9,9 @@  | 
                                                    ||
| 9 | 9 | public $declaration;  | 
                                                        
| 10 | 10 | public $invocation_root;  | 
                                                        
| 11 | 11 | |
| 12 | + /**  | 
                                                        |
| 13 | + * @param string $invocation_root  | 
                                                        |
| 14 | + */  | 
                                                        |
| 12 | 15 |  	function __construct( $invocation, $declaration, $invocation_root = null ) { | 
                                                        
| 13 | 16 | $this->invocation = $invocation;  | 
                                                        
| 14 | 17 | $this->declaration = $declaration;  | 
                                                        
@@ -9,6 +9,9 @@  | 
                                                    ||
| 9 | 9 | private $invocations;  | 
                                                        
| 10 | 10 | private $file_path;  | 
                                                        
| 11 | 11 | |
| 12 | + /**  | 
                                                        |
| 13 | + * @param $invocations  | 
                                                        |
| 14 | + */  | 
                                                        |
| 12 | 15 |  	public function __construct( $file_path, $invocations ) { | 
                                                        
| 13 | 16 | $this->file_path = $file_path;  | 
                                                        
| 14 | 17 | $this->invocations = $invocations;  | 
                                                        
@@ -50,6 +50,7 @@  | 
                                                    ||
| 50 | 50 | * Perform the IXR request.  | 
                                                        
| 51 | 51 | *  | 
                                                        
| 52 | 52 | * @param string[] ...$args IXR args.  | 
                                                        
| 53 | + * @param string $args  | 
                                                        |
| 53 | 54 | *  | 
                                                        
| 54 | 55 | * @return bool True if request succeeded, false otherwise.  | 
                                                        
| 55 | 56 | */  | 
                                                        
@@ -25,6 +25,7 @@  | 
                                                    ||
| 25 | 25 | * The rest of the arguments are the params specified to the method.  | 
                                                        
| 26 | 26 | *  | 
                                                        
| 27 | 27 | * @param string[] ...$args IXR args.  | 
                                                        
| 28 | + * @param string $args  | 
                                                        |
| 28 | 29 | */  | 
                                                        
| 29 | 30 |  	public function addCall( ...$args ) { | 
                                                        
| 30 | 31 | $method_name = array_shift( $args );  |