@@ -178,7 +178,7 @@ |
||
178 | 178 | * |
179 | 179 | * @param $context |
180 | 180 | * The current action context. |
181 | - * @param $content_type |
|
181 | + * @param string $content_type |
|
182 | 182 | * The content type applicable to this action, such as "node" or "comment". |
183 | 183 | */ |
184 | 184 | function flag_action_form($context, $content_type) { |
@@ -258,6 +258,7 @@ |
||
258 | 258 | * |
259 | 259 | * This function is used to select the desired flag when setting up flag |
260 | 260 | * relationships and fields. |
261 | + * @param string $form_type |
|
261 | 262 | */ |
262 | 263 | function flag_views_flag_config_form($form_type, $content_type, $current_flag) { |
263 | 264 | $flags = flag_get_flags($content_type); |
@@ -116,6 +116,8 @@ |
||
116 | 116 | * Returns an option's value. |
117 | 117 | * |
118 | 118 | * Purpose: insulate us from the difference between Views 3 and Views 2. |
119 | + * @param string $option |
|
120 | + * @param string $default |
|
119 | 121 | */ |
120 | 122 | function _get_option($option, $default) { |
121 | 123 | if (_flag_is_views3()) { |
@@ -30,6 +30,7 @@ discard block |
||
30 | 30 | * |
31 | 31 | * This will also attempt to include all parents, though we're maxing the |
32 | 32 | * parent chain to 10 to prevent infinite loops. |
33 | + * @param string $type |
|
33 | 34 | */ |
34 | 35 | function views_include_handler($definition, $type, $count = 0) { |
35 | 36 | // Do not proceed if the class already exists. |
@@ -912,7 +913,7 @@ discard block |
||
912 | 913 | /** |
913 | 914 | * Helper function to create cross-database SQL date formatting. |
914 | 915 | * |
915 | - * @param $format |
|
916 | + * @param string $format |
|
916 | 917 | * A format string for the result, like 'Y-m-d H:i:s'. |
917 | 918 | * @param $field |
918 | 919 | * The real table and field name, like 'tablename.fieldname'. |
@@ -978,7 +979,7 @@ discard block |
||
978 | 979 | /** |
979 | 980 | * Helper function to create cross-database SQL date extraction. |
980 | 981 | * |
981 | - * @param $extract_type |
|
982 | + * @param string $extract_type |
|
982 | 983 | * The type of value to extract from the date, like 'MONTH'. |
983 | 984 | * @param $field |
984 | 985 | * The real table and field name, like 'tablename.fieldname'. |
@@ -1246,6 +1247,8 @@ discard block |
||
1246 | 1247 | class views_join { |
1247 | 1248 | /** |
1248 | 1249 | * Construct the views_join object. |
1250 | + * @param string $table |
|
1251 | + * @param string $field |
|
1249 | 1252 | */ |
1250 | 1253 | function construct($table = NULL, $left_table = NULL, $left_field = NULL, $field = NULL, $extra = array(), $type = 'LEFT') { |
1251 | 1254 | $this->extra_type = 'AND'; |
@@ -977,6 +977,7 @@ discard block |
||
977 | 977 | |
978 | 978 | /** |
979 | 979 | * Format a number to be displayed using a maximum number of digits |
980 | + * @param double $number |
|
980 | 981 | */ |
981 | 982 | function boincwork_format_stats($number, $max_digits = 4) { |
982 | 983 | $suffix = array( |
@@ -1187,6 +1188,9 @@ discard block |
||
1187 | 1188 | // xml_to_array(): Convert an XML DOM object to array format |
1188 | 1189 | //------------------------------------------------------------------------------------------------ |
1189 | 1190 | |
1191 | + /** |
|
1192 | + * @param DOMDocument $xml |
|
1193 | + */ |
|
1190 | 1194 | function xml_to_array($xml) { |
1191 | 1195 | $node = $xml->firstChild; //$xml->first_child(); |
1192 | 1196 | $result = ''; |
@@ -1269,6 +1273,7 @@ discard block |
||
1269 | 1273 | |
1270 | 1274 | /** |
1271 | 1275 | * Determine output for host list views when no hosts are found. |
1276 | + * @param string $context |
|
1272 | 1277 | */ |
1273 | 1278 | function boincwork_views_host_list_empty_text($context = NULL) { |
1274 | 1279 | |
@@ -1818,6 +1823,7 @@ discard block |
||
1818 | 1823 | |
1819 | 1824 | /** |
1820 | 1825 | * Function to delete a column from an array. |
1826 | + * @param integer $offset |
|
1821 | 1827 | */ |
1822 | 1828 | function delete_col(&$array, $offset) { |
1823 | 1829 | return array_walk($array, function (&$v) use ($offset) { |
@@ -48,6 +48,10 @@ discard block |
||
48 | 48 | return $x; |
49 | 49 | } |
50 | 50 | |
51 | +/** |
|
52 | + * @param null|integer $teamid |
|
53 | + * @param string $error |
|
54 | + */ |
|
51 | 55 | function pm_team_form($user, $teamid, $error=null) { |
52 | 56 | global $bbcode_html, $bbcode_js; |
53 | 57 | $team = BoincTeam::lookup_id($teamid); |
@@ -99,6 +103,9 @@ discard block |
||
99 | 103 | page_tail(); |
100 | 104 | } |
101 | 105 | |
106 | +/** |
|
107 | + * @param string $error |
|
108 | + */ |
|
102 | 109 | function pm_form($replyto, $userid, $error = null) { |
103 | 110 | global $bbcode_html, $bbcode_js; |
104 | 111 | global $g_logged_in_user; |
@@ -217,6 +224,9 @@ discard block |
||
217 | 224 | return "<a href=pm.php>".tra("Private message%1 from %2, subject:" , "</a>", $from_user->name )." $pm->subject"; |
218 | 225 | } |
219 | 226 | |
227 | +/** |
|
228 | + * @param boolean $send_email |
|
229 | + */ |
|
220 | 230 | function pm_send_msg($from_user, $to_user, $subject, $content, $send_email) { |
221 | 231 | $sql_subject = BoincDb::escape_string(sanitize_tags($subject)); |
222 | 232 | $sql_content = BoincDb::escape_string($content); |
@@ -245,6 +255,9 @@ discard block |
||
245 | 255 | BoincNotify::insert("(userid, create_time, type, opaque) values ($to_user->id, ".time().", ".NOTIFY_PM.", $mid)"); |
246 | 256 | } |
247 | 257 | |
258 | +/** |
|
259 | + * @param integer $duration |
|
260 | + */ |
|
248 | 261 | function pm_count($userid, $duration) { |
249 | 262 | $time = time() - $duration; |
250 | 263 |
@@ -179,6 +179,7 @@ |
||
179 | 179 | /** |
180 | 180 | * Implementation of hook_node_view(); add custom actions when a node |
181 | 181 | * is viewed (forward compatible to Drupal 7) |
182 | + * @param string $view_mode |
|
182 | 183 | */ |
183 | 184 | function boinctranslate_node_view($node, $view_mode, $langcode) { |
184 | 185 | switch($node->type) { |
@@ -512,6 +512,7 @@ discard block |
||
512 | 512 | |
513 | 513 | /** |
514 | 514 | * |
515 | + * @param string $type |
|
515 | 516 | */ |
516 | 517 | function boinctranslate_export_po_generate($language = NULL, $strings = array(), $header = NULL, $type = NULL) { |
517 | 518 | |
@@ -886,6 +887,7 @@ discard block |
||
886 | 887 | |
887 | 888 | /** |
888 | 889 | * |
890 | + * @param stdClass $file |
|
889 | 891 | */ |
890 | 892 | function _boinctranslate_locale_import_po($file, $langcode, $mode, $group = NULL) { |
891 | 893 | // Try to allocate enough time to parse and import the data. |
@@ -932,6 +934,7 @@ discard block |
||
932 | 934 | |
933 | 935 | /** |
934 | 936 | * |
937 | + * @param string $op |
|
935 | 938 | */ |
936 | 939 | function _boinctranslate_locale_import_read_po($op, $file, $mode = NULL, $lang = NULL, $group = 'default') { |
937 | 940 | |
@@ -1283,6 +1286,7 @@ discard block |
||
1283 | 1286 | * |
1284 | 1287 | * Textgroups 'boinc' and 'project' use the location string to |
1285 | 1288 | * uniquely identify rows in the locales_source database. |
1289 | + * @param string $textgroup |
|
1286 | 1290 | */ |
1287 | 1291 | function _boinctranslate_locale_import_one_string_db(&$report, $langcode, $source, $translation, $textgroup, $location, $mode, $plid = NULL, $plural = NULL) { |
1288 | 1292 |
@@ -220,6 +220,9 @@ discard block |
||
220 | 220 | // (to accommodate long [pre] lines) |
221 | 221 | // and the left column (author info) has fixed size |
222 | 222 | // |
223 | +/** |
|
224 | + * @param string[] $headings |
|
225 | + */ |
|
223 | 226 | function start_forum_table($headings) { |
224 | 227 | $a = array(); |
225 | 228 | foreach ($headings as $h) { |
@@ -500,6 +503,9 @@ discard block |
||
500 | 503 | // Display an individual post. |
501 | 504 | // Generates a table row with two cells: author and message |
502 | 505 | // |
506 | +/** |
|
507 | + * @param integer $controls |
|
508 | + */ |
|
503 | 509 | function show_post( |
504 | 510 | $post, $thread, $forum, $logged_in_user, $start=0, |
505 | 511 | $latest_viewed=0, $controls=FORUM_CONTROLS, $filter=true |
@@ -875,6 +881,9 @@ discard block |
||
875 | 881 | // These take care of counts and timestamps. |
876 | 882 | // Don't do these things directly - use these functions |
877 | 883 | // |
884 | +/** |
|
885 | + * @param integer $parent_id |
|
886 | + */ |
|
878 | 887 | function create_post($content, $parent_id, $user, $forum, $thread, $signature) { |
879 | 888 | if (POST_MAX_LINKS |
880 | 889 | && link_count($content) > POST_MAX_LINKS |
@@ -1119,6 +1128,9 @@ discard block |
||
1119 | 1128 | // $sort_style - string (checked by switch statement) |
1120 | 1129 | // $show_hidden - bool (not directly passed to SQL) |
1121 | 1130 | // |
1131 | +/** |
|
1132 | + * @param boolean $show_hidden |
|
1133 | + */ |
|
1122 | 1134 | function get_thread_posts($threadid, $sort_style, $show_hidden) { |
1123 | 1135 | $sql = "thread=$threadid"; |
1124 | 1136 | if (!$show_hidden) { |
@@ -1144,6 +1156,9 @@ discard block |
||
1144 | 1156 | // Show links for post moderation actions; |
1145 | 1157 | // logged in user has moderation rights. |
1146 | 1158 | // |
1159 | +/** |
|
1160 | + * @param string $config |
|
1161 | + */ |
|
1147 | 1162 | function show_post_moderation_links( |
1148 | 1163 | $config, $logged_in_user, $post, $forum, $tokens |
1149 | 1164 | ){ |