@@ -18,6 +18,10 @@ discard block |
||
18 | 18 | |
19 | 19 | // forms for account creation and login |
20 | 20 | |
21 | +/** |
|
22 | + * @param integer $teamid |
|
23 | + * @param string $next_url |
|
24 | + */ |
|
21 | 25 | function create_account_form($teamid, $next_url) { |
22 | 26 | global $recaptcha_public_key; |
23 | 27 | echo " |
@@ -92,6 +96,9 @@ discard block |
||
92 | 96 | echo "</form>\n"; |
93 | 97 | } |
94 | 98 | |
99 | +/** |
|
100 | + * @param string $next_url |
|
101 | + */ |
|
95 | 102 | function login_form($next_url) { |
96 | 103 | echo " |
97 | 104 | <form name=\"f\" method=\"post\" action=\"".secure_url_base()."/login_action.php\"> |
@@ -52,6 +52,9 @@ |
||
52 | 52 | } |
53 | 53 | } |
54 | 54 | |
55 | +/** |
|
56 | + * @param string $path |
|
57 | + */ |
|
55 | 58 | function akismet_request($request, $host, $path, $port = 80) { |
56 | 59 | $http_request = "POST $path HTTP/1.0\r\n"; |
57 | 60 | $http_request .= "Host: $host\r\n"; |
@@ -246,6 +246,9 @@ discard block |
||
246 | 246 | |
247 | 247 | } |
248 | 248 | |
249 | +/** |
|
250 | + * @param string $n |
|
251 | + */ |
|
249 | 252 | function name($n) { |
250 | 253 | return array('name', $n); |
251 | 254 | } |
@@ -254,10 +257,16 @@ discard block |
||
254 | 257 | return array('title', $n); |
255 | 258 | } |
256 | 259 | |
260 | +/** |
|
261 | + * @param integer $n |
|
262 | + */ |
|
257 | 263 | function number($n) { |
258 | 264 | return array('number', $n); |
259 | 265 | } |
260 | 266 | |
267 | +/** |
|
268 | + * @param string $n |
|
269 | + */ |
|
261 | 270 | function filename($n) { |
262 | 271 | return array('filename', $n); |
263 | 272 | } |
@@ -240,6 +240,10 @@ discard block |
||
240 | 240 | |
241 | 241 | class BoltFitbField { |
242 | 242 | public $textarea, $nrows, $ncols; |
243 | + |
|
244 | + /** |
|
245 | + * @param boolean $textarea |
|
246 | + */ |
|
243 | 247 | function __construct($textarea, $nrows, $ncols) { |
244 | 248 | $this->textarea = $textarea; |
245 | 249 | $this->nrows = $nrows; |
@@ -258,6 +262,10 @@ discard block |
||
258 | 262 | class BoltFitbAnswer { |
259 | 263 | public $type; // 0=constant, 1=regexp, 2=func |
260 | 264 | public $ans; |
265 | + |
|
266 | + /** |
|
267 | + * @param integer $type |
|
268 | + */ |
|
261 | 269 | function __construct($type, $ans) { |
262 | 270 | $this->type = $type; |
263 | 271 | $this->ans = $ans; |
@@ -52,6 +52,9 @@ |
||
52 | 52 | } |
53 | 53 | } |
54 | 54 | |
55 | +/** |
|
56 | + * @param string $n |
|
57 | + */ |
|
55 | 58 | function valuator($n) { |
56 | 59 | return array('valuator', $n); |
57 | 60 | } |
@@ -45,6 +45,9 @@ discard block |
||
45 | 45 | return "../bolt_snap/compare_snapshot_$x"; |
46 | 46 | } |
47 | 47 | |
48 | +/** |
|
49 | + * @param null|integer $dur |
|
50 | + */ |
|
48 | 51 | function write_compare_snapshot($course_id, $select_name, $xset_name, $dur) { |
49 | 52 | $now = time(); |
50 | 53 | $start = $now - $dur*86400; |
@@ -127,6 +130,9 @@ discard block |
||
127 | 130 | return "../bolt_snap/map_snapshot_".$course_id; |
128 | 131 | } |
129 | 132 | |
133 | +/** |
|
134 | + * @param null|integer $dur |
|
135 | + */ |
|
130 | 136 | function write_map_snapshot($course_id, $dur) { |
131 | 137 | $now = time(); |
132 | 138 | $start = $now - $dur*86400; |
@@ -23,6 +23,9 @@ discard block |
||
23 | 23 | |
24 | 24 | // get names of units of a given type |
25 | 25 | |
26 | +/** |
|
27 | + * @param string $type |
|
28 | + */ |
|
26 | 29 | function units_of_type($unit, $type) { |
27 | 30 | $names = array(); |
28 | 31 | if (get_class($unit) == $type) { |
@@ -118,6 +121,10 @@ discard block |
||
118 | 121 | |
119 | 122 | //////////// graph drawing |
120 | 123 | |
124 | +/** |
|
125 | + * @param integer $n |
|
126 | + * @param integer $width |
|
127 | + */ |
|
121 | 128 | function compare_bar($title, $n, $width, $lo, $hi) { |
122 | 129 | $x1 = $width*$lo; |
123 | 130 | $x2 = $width*($hi-$lo); |
@@ -137,6 +144,9 @@ discard block |
||
137 | 144 | "; |
138 | 145 | } |
139 | 146 | |
147 | +/** |
|
148 | + * @param integer $width |
|
149 | + */ |
|
140 | 150 | function compare_bar_insuff($title, $width) { |
141 | 151 | return " |
142 | 152 | <tr> |
@@ -150,6 +160,10 @@ discard block |
||
150 | 160 | "; |
151 | 161 | } |
152 | 162 | |
163 | +/** |
|
164 | + * @param integer[] $x |
|
165 | + * @param integer $width |
|
166 | + */ |
|
153 | 167 | function outcome_graph($x, $width) { |
154 | 168 | $n = $x[0]+$x[1]+$x[2]; |
155 | 169 | if (!$n) return empty_cell(); |
@@ -182,6 +196,9 @@ discard block |
||
182 | 196 | return $s; |
183 | 197 | } |
184 | 198 | |
199 | +/** |
|
200 | + * @param integer $w |
|
201 | + */ |
|
185 | 202 | function time_graph($t, $w) { |
186 | 203 | if ($t == 0) return "<td>---</td>"; |
187 | 204 | $x = (log10($t)+2)*$w/4; |
@@ -193,6 +210,10 @@ discard block |
||
193 | 210 | </td>"; |
194 | 211 | } |
195 | 212 | |
213 | +/** |
|
214 | + * @param integer $t |
|
215 | + * @param integer $w |
|
216 | + */ |
|
196 | 217 | function score_graph($t, $w) { |
197 | 218 | if ($t == 0) return "<td>---</td>"; |
198 | 219 | $x = $t*$w; |
@@ -22,6 +22,9 @@ discard block |
||
22 | 22 | public $weight; |
23 | 23 | public $callback; |
24 | 24 | |
25 | + /** |
|
26 | + * @param null|BoltRefresh $refresh |
|
27 | + */ |
|
25 | 28 | function __construct( |
26 | 29 | $name, $units, $number, $repeats, $refresh, $attrs, $callback, $weight |
27 | 30 | ) { |
@@ -156,10 +159,16 @@ discard block |
||
156 | 159 | define('REPEAT', 2); |
157 | 160 | define('NEXT', 4); |
158 | 161 | |
162 | +/** |
|
163 | + * @param integer $f |
|
164 | + */ |
|
159 | 165 | function repeat($s, $u, $f) { |
160 | 166 | return new BoltRepeat($s, $u, $f); |
161 | 167 | } |
162 | 168 | |
169 | +/** |
|
170 | + * @param integer[] $a |
|
171 | + */ |
|
163 | 172 | function refresh($a) { |
164 | 173 | return new BoltRefresh($a); |
165 | 174 | } |
@@ -38,6 +38,9 @@ |
||
38 | 38 | return $job->insert($clause); |
39 | 39 | } |
40 | 40 | |
41 | +/** |
|
42 | + * @param string $name |
|
43 | + */ |
|
41 | 44 | function bossa_batch_create($appid, $name, $calibration) { |
42 | 45 | $now = time(); |
43 | 46 | $c = $calibration?"1":"0"; |