@@ -799,6 +799,9 @@ |
||
799 | 799 | return $form; |
800 | 800 | } |
801 | 801 | |
802 | +/** |
|
803 | + * @param boolean $_dco_form |
|
804 | + */ |
|
802 | 805 | function elysia_cron_reset_statistics_form_submit($_dco_form, &$_dco_form_state) { |
803 | 806 | elysia_cron_reset_stats(); |
804 | 807 |
@@ -222,6 +222,7 @@ discard block |
||
222 | 222 | * A substitute for variable_get to avoid cache management |
223 | 223 | * Use ONLY for variables setted during cron execution: elysia_cron_semaphore, elysia_cron_last_run, elysia_cron_last_context, cron_semaphore, cron_last |
224 | 224 | * WARN_UPGRADE |
225 | + * @param string $name |
|
225 | 226 | */ |
226 | 227 | function _ec_variable_get($name, $default) { |
227 | 228 | global $_ec_variables, $_ec_variables_allowed; |
@@ -251,6 +252,7 @@ discard block |
||
251 | 252 | * A substitute for variable_set to avoid cache management |
252 | 253 | * Use ONLY for variables setted during cron execution: elysia_cron_semaphore, elysia_cron_last_run, elysia_cron_last_context, cron_semaphore, cron_last |
253 | 254 | * WARN_UPGRADE |
255 | + * @param string $name |
|
254 | 256 | */ |
255 | 257 | function _ec_variable_set($name, $value) { |
256 | 258 | global $_ec_variables, $_ec_variables_allowed; |
@@ -286,6 +288,7 @@ discard block |
||
286 | 288 | * A substitute for variable_del to avoid cache management |
287 | 289 | * Use ONLY for variables setted during cron execution: elysia_cron_semaphore, elysia_cron_last_run, elysia_cron_last_context, cron_semaphore, cron_last |
288 | 290 | * WARN_UPGRADE |
291 | + * @param string $name |
|
289 | 292 | */ |
290 | 293 | function _ec_variable_del($name) { |
291 | 294 | global $_ec_variables, $_ec_variables_allowed; |
@@ -407,6 +410,9 @@ discard block |
||
407 | 410 | unset($elysia_cron_db_cache[$name]); |
408 | 411 | } |
409 | 412 | |
413 | +/** |
|
414 | + * @param string $key |
|
415 | + */ |
|
410 | 416 | function elysia_cron_get($name, $channel = false, $key, $default, $refresh = false) { |
411 | 417 | global $elysia_cron_db_cache; |
412 | 418 | static $elysia_cron_defaults; |
@@ -450,6 +456,9 @@ discard block |
||
450 | 456 | return elysia_cron_get($channel, true, 'disable', $default, $refresh); |
451 | 457 | } |
452 | 458 | |
459 | +/** |
|
460 | + * @param string $v |
|
461 | + */ |
|
453 | 462 | function elysia_cron_set_channel_disabled($channel, $v) { |
454 | 463 | return elysia_cron_set($channel, true, array('disable' => $v ? 1 : 0)); |
455 | 464 | } |
@@ -466,6 +475,9 @@ discard block |
||
466 | 475 | return elysia_cron_get($channel, true, 'rule', $default, $refresh); |
467 | 476 | } |
468 | 477 | |
478 | +/** |
|
479 | + * @param string $v |
|
480 | + */ |
|
469 | 481 | function elysia_cron_set_channel_rule($channel, $v) { |
470 | 482 | return elysia_cron_set($channel, true, array('rule' => $v)); |
471 | 483 | } |
@@ -478,6 +490,9 @@ discard block |
||
478 | 490 | return elysia_cron_get($channel, true, 'running', $default, $refresh); |
479 | 491 | } |
480 | 492 | |
493 | +/** |
|
494 | + * @param integer $v |
|
495 | + */ |
|
481 | 496 | function elysia_cron_set_channel_running($channel, $v) { |
482 | 497 | return elysia_cron_set($channel, true, array('running' => $v)); |
483 | 498 | } |
@@ -569,6 +584,9 @@ discard block |
||
569 | 584 | return elysia_cron_get($job, false, 'rule', $default, $refresh); |
570 | 585 | } |
571 | 586 | |
587 | +/** |
|
588 | + * @param string $v |
|
589 | + */ |
|
572 | 590 | function elysia_cron_set_job_rule($job, $v) { |
573 | 591 | return elysia_cron_set($job, false, array('rule' => $v)); |
574 | 592 | } |
@@ -585,6 +603,9 @@ discard block |
||
585 | 603 | return elysia_cron_get($job, false, 'weight', $default, $refresh); |
586 | 604 | } |
587 | 605 | |
606 | +/** |
|
607 | + * @param string $v |
|
608 | + */ |
|
588 | 609 | function elysia_cron_set_job_weight($job, $v) { |
589 | 610 | return elysia_cron_set($job, false, array('weight' => $v)); |
590 | 611 | } |
@@ -601,6 +622,9 @@ discard block |
||
601 | 622 | return elysia_cron_get($job, false, 'disable', $default, $refresh); |
602 | 623 | } |
603 | 624 | |
625 | +/** |
|
626 | + * @param string $v |
|
627 | + */ |
|
604 | 628 | function elysia_cron_set_job_disabled($job, $v) { |
605 | 629 | return elysia_cron_set($job, false, array('disable' => $v ? 1 : 0)); |
606 | 630 | } |
@@ -620,6 +644,9 @@ discard block |
||
620 | 644 | return !$c ? $default : $c; |
621 | 645 | } |
622 | 646 | |
647 | +/** |
|
648 | + * @param string $v |
|
649 | + */ |
|
623 | 650 | function elysia_cron_set_job_channel($job, $v) { |
624 | 651 | return elysia_cron_set($job, false, array('context' => $v)); |
625 | 652 | } |
@@ -632,6 +659,9 @@ discard block |
||
632 | 659 | return elysia_cron_get($job, false, 'running', $default, $refresh); |
633 | 660 | } |
634 | 661 | |
662 | +/** |
|
663 | + * @param integer $v |
|
664 | + */ |
|
635 | 665 | function elysia_cron_set_job_running($job, $v) { |
636 | 666 | return elysia_cron_set($job, false, array('running' => $v)); |
637 | 667 | } |
@@ -92,6 +92,10 @@ discard block |
||
92 | 92 | return mktime($date[1], $date[0], 0, $date[3], $date[2], $date[4]); |
93 | 93 | } |
94 | 94 | |
95 | +/** |
|
96 | + * @param integer $range_start |
|
97 | + * @param integer $range_end |
|
98 | + */ |
|
95 | 99 | function __cronNextOrEqual($el, $arr, $range_start, $range_end) { |
96 | 100 | if (empty($arr)) { |
97 | 101 | return $el; |
@@ -104,6 +108,10 @@ discard block |
||
104 | 108 | return $range_end + reset($arr) + 1 - $range_start; |
105 | 109 | } |
106 | 110 | |
111 | +/** |
|
112 | + * @param integer $min |
|
113 | + * @param integer $max |
|
114 | + */ |
|
107 | 115 | function __cronDecodeRule($rule, $min, $max) { |
108 | 116 | if ($rule == '*') { |
109 | 117 | return array('n' => array(), 'd' => 0); |
@@ -125,6 +133,9 @@ discard block |
||
125 | 133 | return $result; |
126 | 134 | } |
127 | 135 | |
136 | +/** |
|
137 | + * @param string[] $rule |
|
138 | + */ |
|
128 | 139 | function __cronDecodeRuleMday($rule, $month, $year) { |
129 | 140 | $range_from = 1; |
130 | 141 | $range_to = $month != 2 ? (in_array($month, array(4,6,9,11)) ? 30 : 31) : ($year % 4 == 0 ? 29 : 28); |
@@ -129,6 +129,10 @@ |
||
129 | 129 | } |
130 | 130 | |
131 | 131 | // Used by elysia_cron_should_run |
132 | +/** |
|
133 | + * @param integer $min |
|
134 | + * @param integer $max |
|
135 | + */ |
|
132 | 136 | function _cronDecodeRule($rule, $min, $max) { |
133 | 137 | if ($rule == '*') { |
134 | 138 | return range($min, $max); |
@@ -6,14 +6,23 @@ discard block |
||
6 | 6 | * D6 VERSION |
7 | 7 | ***************************************************************/ |
8 | 8 | |
9 | +/** |
|
10 | + * @param string $module |
|
11 | + */ |
|
9 | 12 | function _dcf_hook_boot($module) { |
10 | 13 | return true; |
11 | 14 | } |
12 | 15 | |
16 | +/** |
|
17 | + * @param string $module |
|
18 | + */ |
|
13 | 19 | function _dcf_hook_init($module) { |
14 | 20 | return true; |
15 | 21 | } |
16 | 22 | |
23 | +/** |
|
24 | + * @param boolean $maycache |
|
25 | + */ |
|
17 | 26 | function _dcf_hook_menu($items, $maycache) { |
18 | 27 | $new_items = array(); |
19 | 28 | foreach ($items as $k => $v) |
@@ -57,14 +66,24 @@ discard block |
||
57 | 66 | ); |
58 | 67 | } |
59 | 68 | |
69 | +/** |
|
70 | + * @param string $string |
|
71 | + */ |
|
60 | 72 | function _dcf_t($string) { |
61 | 73 | return t($string); |
62 | 74 | } |
63 | 75 | |
76 | +/** |
|
77 | + * @param string $type |
|
78 | + * @param string $message |
|
79 | + */ |
|
64 | 80 | function _dco_watchdog($type, $message, $variables = array(), $severity = WATCHDOG_NOTICE, $link = NULL) { // WARN d7 changed WATCHDOG_ costants |
65 | 81 | return watchdog($type, $message, $variables, $severity, $link); |
66 | 82 | } |
67 | 83 | |
84 | +/** |
|
85 | + * @param string $path |
|
86 | + */ |
|
68 | 87 | function _dco_l($text, $path, array $options = array()) { |
69 | 88 | return l($text, $path, $options); |
70 | 89 | } |
@@ -73,6 +92,9 @@ discard block |
||
73 | 92 | return array('form' => &$form, 'form_state' => &$form_state); |
74 | 93 | } |
75 | 94 | |
95 | +/** |
|
96 | + * @param string $name |
|
97 | + */ |
|
76 | 98 | function _dco_theme($name, $args) { |
77 | 99 | return call_user_func_array('theme', array_merge(array($name), array_values($args))); |
78 | 100 | } |
@@ -116,10 +138,16 @@ discard block |
||
116 | 138 | db_result(db_query("select min(weight) from {system} where name != '%s'", $except_module)); |
117 | 139 | } |
118 | 140 | |
141 | +/** |
|
142 | + * @param string $name |
|
143 | + */ |
|
119 | 144 | function drupal_module_get_weight($name) { |
120 | 145 | return db_result(db_query("select weight from {system} where name = '%s'", $name)); |
121 | 146 | } |
122 | 147 | |
148 | +/** |
|
149 | + * @param string $name |
|
150 | + */ |
|
123 | 151 | function drupal_module_set_weight($name, $weight) { |
124 | 152 | db_query("update {system} set weight = %d where name = '%s'", $weight, $name); |
125 | 153 | } |
@@ -208,6 +208,9 @@ discard block |
||
208 | 208 | // (to accommodate long [pre] lines) |
209 | 209 | // and the left column (author info) has fixed size |
210 | 210 | // |
211 | +/** |
|
212 | + * @param string[] $headings |
|
213 | + */ |
|
211 | 214 | function start_forum_table($headings) { |
212 | 215 | $a = array(); |
213 | 216 | foreach ($headings as $h) { |
@@ -488,6 +491,9 @@ discard block |
||
488 | 491 | // Display an individual post. |
489 | 492 | // Generates a table row with two cells: author and message |
490 | 493 | // |
494 | +/** |
|
495 | + * @param integer $controls |
|
496 | + */ |
|
491 | 497 | function show_post( |
492 | 498 | $post, $thread, $forum, $logged_in_user, $start=0, |
493 | 499 | $latest_viewed=0, $controls=FORUM_CONTROLS, $filter=true |
@@ -857,6 +863,9 @@ discard block |
||
857 | 863 | // These take care of counts and timestamps. |
858 | 864 | // Don't do these things directly - use these functions |
859 | 865 | // |
866 | +/** |
|
867 | + * @param integer $parent_id |
|
868 | + */ |
|
860 | 869 | function create_post($content, $parent_id, $user, $forum, $thread, $signature) { |
861 | 870 | $content = substr($content, 0, 64000); |
862 | 871 | $content = BoincDb::escape_string($content); |
@@ -1089,6 +1098,9 @@ discard block |
||
1089 | 1098 | // $sort_style - string (checked by switch statement) |
1090 | 1099 | // $show_hidden - bool (not directly passed to SQL) |
1091 | 1100 | // |
1101 | +/** |
|
1102 | + * @param boolean $show_hidden |
|
1103 | + */ |
|
1092 | 1104 | function get_thread_posts($threadid, $sort_style, $show_hidden) { |
1093 | 1105 | $sql = "thread=$threadid"; |
1094 | 1106 | if (!$show_hidden) { |
@@ -1114,6 +1126,9 @@ discard block |
||
1114 | 1126 | // Show links for post moderation actions; |
1115 | 1127 | // logged in user has moderation rights. |
1116 | 1128 | // |
1129 | +/** |
|
1130 | + * @param string $config |
|
1131 | + */ |
|
1117 | 1132 | function show_post_moderation_links( |
1118 | 1133 | $config, $logged_in_user, $post, $forum, $tokens |
1119 | 1134 | ){ |
@@ -168,7 +168,7 @@ |
||
168 | 168 | * |
169 | 169 | * @param string $module_name |
170 | 170 | * The name of the feature module whose components should be reverted. |
171 | - * @return boolean |
|
171 | + * @return boolean|null |
|
172 | 172 | * TRUE or FALSE for whether the components were successfully reverted. |
173 | 173 | */ |
174 | 174 | function hook_features_revert($module_name) { |
@@ -226,6 +226,7 @@ |
||
226 | 226 | * An array of the context requested in this export. |
227 | 227 | * @param $module_name |
228 | 228 | * Optional. The name for the exported module. |
229 | + * @param string $directory |
|
229 | 230 | */ |
230 | 231 | function _drush_features_export($stub, $dependencies, $module_name = NULL, $directory = NULL) { |
231 | 232 | $root = drush_get_option(array('r', 'root'), drush_locate_root()); |
@@ -62,6 +62,7 @@ discard block |
||
62 | 62 | |
63 | 63 | /** |
64 | 64 | * Iterates over data and convert to dependencies if already defined elsewhere. |
65 | + * @param string $module_name |
|
65 | 66 | */ |
66 | 67 | function _features_resolve_dependencies(&$data, &$export, $module_name, $component) { |
67 | 68 | if ($map = features_get_default_map($component)) { |
@@ -371,7 +372,7 @@ discard block |
||
371 | 372 | * Array of parent keys (internal use only). |
372 | 373 | * |
373 | 374 | * @return |
374 | - * A code string ready to be written to a module's .info file. |
|
375 | + string A code string ready to be written to a module's .info file. |
|
375 | 376 | */ |
376 | 377 | function features_export_info($info, $parents = array()) { |
377 | 378 | $output = ''; |
@@ -402,7 +403,7 @@ discard block |
||
402 | 403 | * String contents of the file. |
403 | 404 | * |
404 | 405 | * @return |
405 | - * A string of the tar file contents. |
|
406 | + string A string of the tar file contents. |
|
406 | 407 | */ |
407 | 408 | function features_tar_create($name, $contents) { |
408 | 409 | $tar = ''; |
@@ -551,6 +552,7 @@ discard block |
||
551 | 552 | |
552 | 553 | /** |
553 | 554 | * Processing semaphore operations. |
555 | + * @param string $op |
|
554 | 556 | */ |
555 | 557 | function features_semaphore($op, $component) { |
556 | 558 | // Note: we don't use variable_get() here as the inited variable |
@@ -675,6 +677,8 @@ discard block |
||
675 | 677 | |
676 | 678 | /** |
677 | 679 | * Get a map of components to their providing modules. |
680 | + * @param string $attribute |
|
681 | + * @param string $callback |
|
678 | 682 | */ |
679 | 683 | function features_get_default_map($component, $attribute = NULL, $callback = NULL, $reset = FALSE) { |
680 | 684 | static $map = array(); |