function get_function_doc_comments($func, $clsname) { $text = format_doc_desc($func, empty($clsname) ? 'function' : $clsname); if ($func['args']) { foreach ($func['args'] as $arg) { $desc = idx($arg, 'desc', ''); if (idx($func, 'ref')) { $desc = '(output) ' . $desc; } $text .= format_doc_arg($arg['name'], idx($arg, 'type'), $desc); } } $ret = $func['return'] !== null || !empty($func['ret_desc']); if ($func['args'] && $ret) { $text .= "\n"; } if ($ret) { $text .= format_doc_arg('return', $func['return'], $func['ret_desc']); } return format_doc_comment($text); }
function get_function_doc_comments($func, $clsname) { $text = format_doc_desc($func, 'function'); if ($func['args']) { foreach ($func['args'] as $arg) { $desc = idx($arg, 'desc', ''); if (idx($func, 'ref')) { $desc = '(output) ' . $desc; } $text .= format_doc_arg($arg['name'], idx($arg, 'type'), $desc); } $text .= "\n"; } $text .= format_doc_arg('return', $func['return'], $func['ret_desc']); return format_doc_comment($text); }