Correcting reported Doxygen syntax warnings.

Fixed wrong Doxygen syntax and add some of the available FIXME to
Doxygen documentation.
Updated Doxygen configuration to add also all capital letter tags.
Adding some more Doxygen documentation.
This commit is contained in:
Klaus Weidenbach
2015-03-22 00:06:08 +01:00
parent 76a6739b93
commit d0361582b0
31 changed files with 2846 additions and 2848 deletions

View File

@@ -101,7 +101,7 @@ function comanche_parser(&$a, $s, $pass = 0) {
}
function comanche_menu($name,$class = '') {
function comanche_menu($name, $class = '') {
$channel_id = comanche_get_channel_id();
if($channel_id) {
$m = menu_fetch($name,$channel_id, get_observer_hash());
@@ -111,20 +111,23 @@ function comanche_menu($name,$class = '') {
function comanche_replace_region($match) {
$a = get_app();
if(array_key_exists($match[1], $a->page)) {
if (array_key_exists($match[1], $a->page)) {
return $a->page[$match[1]];
}
}
/**
* @function comanche_get_channel_id()
* Returns the channel_id of the profile owner of the page, or the local_channel if there is no profile owner.
* Otherwise returns 0
*/
* @brief Returns the channel_id of the profile owner of the page.
*
* Returns the channel_id of the profile owner of the page, or the local_channel
* if there is no profile owner. Otherwise returns 0.
*
* @return channel_id
*/
function comanche_get_channel_id() {
$channel_id = ((is_array(get_app()->profile)) ? get_app()->profile['profile_uid'] : 0);
if((! $channel_id) && (local_channel()))
if ((! $channel_id) && (local_channel()))
$channel_id = local_channel();
return $channel_id;
@@ -173,23 +176,26 @@ function comanche_webpage(&$a,$s) {
}
// Widgets will have to get any operational arguments from the session,
// the global app environment, or config storage until we implement argument passing
/**
* Widgets will have to get any operational arguments from the session, the
* global app environment, or config storage until we implement argument passing
*
* @param string $name
* @param string $text
*/
function comanche_widget($name, $text) {
$vars = array();
$matches = array();
$cnt = preg_match_all("/\[var=(.*?)\](.*?)\[\/var\]/ism", $text, $matches, PREG_SET_ORDER);
if($cnt) {
foreach($matches as $mtch) {
if ($cnt) {
foreach ($matches as $mtch) {
$vars[$mtch[1]] = $mtch[2];
}
}
$func = 'widget_' . trim($name);
if(function_exists($func))
if (function_exists($func))
return $func($vars);
}