Index: trunk/tools/testswarm/scripts/testswarm-mw-fetcher.php |
— | — | @@ -118,7 +118,7 @@ |
119 | 119 | } |
120 | 120 | |
121 | 121 | /** |
122 | | - * Try to fetch the next revision (relative latest checkout in the checkouts directory). |
| 122 | + * Try to fetch the next revision (relative to the latest checkout in the checkouts directory). |
123 | 123 | * This is the main entry point after construction. |
124 | 124 | */ |
125 | 125 | public function tryFetchNextRev() { |
— | — | @@ -312,9 +312,9 @@ |
313 | 313 | /** LOGGING **/ |
314 | 314 | |
315 | 315 | /** |
316 | | - * Utility function to log a message for a given id. |
| 316 | + * Utility function to save a message to the log file. |
317 | 317 | * |
318 | | - * @param $msg string: message to log. Will be prefixed with date("c") |
| 318 | + * @param $msg string: message to log. Will be prefixed with a timestamp. |
319 | 319 | * @param $callee string: Callee function to be logged as origin. |
320 | 320 | */ |
321 | 321 | public function log( $msg, $callee = '', $prefix = '' ) { |
— | — | @@ -330,10 +330,13 @@ |
331 | 331 | } |
332 | 332 | |
333 | 333 | /** |
334 | | - * Log a debug message. Only logged in debug mode. |
| 334 | + * Echo a debug message directly to the output. Ignored when not in debug mode. |
335 | 335 | * Messages are prefixed with "DEBUG> ". |
336 | 336 | * Multiline messages will be split up. |
337 | 337 | * |
| 338 | + * In contrary to log(), these are not saved in a file (you can save them if needed, |
| 339 | + * simply point output to a file from the shell; $ php foo.php > debug.log). |
| 340 | + * |
338 | 341 | * @param $msg string: Message to print. |
339 | 342 | * @param $callee string. |
340 | 343 | */ |