[fix] class documentation missing type

This commit is contained in:
alban 2014-03-26 11:59:59 +01:00
parent 6dd6094b71
commit eb45d87d75
2 changed files with 77 additions and 74 deletions

View File

@ -33,7 +33,8 @@
class m_action { class m_action {
/* --------------------------------------------------------------------------- */ /* --------------------------------------------------------------------------- */
/** Constructor /**
* Constructor
*/ */
function m_action() { function m_action() {
@ -42,8 +43,8 @@ class m_action {
/** /**
* Plans the cration of a file * Plans the cration of a file
* *
* @global type $err * @global \m_err $err
* @global type $L_INOTIFY_DO_ACTION * @global string $L_INOTIFY_DO_ACTION
* @return boolean * @return boolean
*/ */
function do_action() { function do_action() {
@ -91,8 +92,8 @@ class m_action {
/** /**
* Plans a dir fix * Plans a dir fix
* *
* @param type $dir * @param string $dir
* @param type $user * @param m_user $user
* @return type * @return type
*/ */
function fix_dir($dir, $user = "root") { function fix_dir($dir, $user = "root") {
@ -102,8 +103,8 @@ class m_action {
/** /**
* Plans a file fix * Plans a file fix
* *
* @param type $file * @param string $file
* @param type $user * @param m_user $user
* @return type * @return type
*/ */
function fix_file($file, $user = "root") { function fix_file($file, $user = "root") {
@ -113,8 +114,8 @@ class m_action {
/** /**
* function to delete file / folder * function to delete file / folder
* *
* @param type $dir * @param string $dir
* @param type $user * @param m_user $user
* @return type * @return type
*/ */
function del($dir, $user = "root") { function del($dir, $user = "root") {
@ -124,9 +125,9 @@ class m_action {
/** /**
* function returning the first not locked line of the action table * function returning the first not locked line of the action table
* *
* @param type $src * @param string $src
* @param type $dst * @param string $dst
* @param type $user * @param m_user $user
* @return type * @return type
*/ */
function move($src, $dst, $user = "root") { function move($src, $dst, $user = "root") {
@ -137,12 +138,12 @@ class m_action {
* *
* function archiving a directory ( upon account deletion ) * function archiving a directory ( upon account deletion )
* *
* @global type $cuid * @global int $cuid
* @global type $db * @global m_mysql $db
* @global type $err * @global m_err $err
* @param type $archive Directory to archive within the archive_del_data folder if set in variable sql table * @param string $archive Directory to archive within the archive_del_data folder if set in variable sql table
* If archive_del_data is not set we delete the folder * If archive_del_data is not set we delete the folder
* @param type $dir sub_directory of the archive directory * @param string $dir sub_directory of the archive directory
* @return boolean * @return boolean
*/ */
function archive($archive, $dir = "html") { function archive($archive, $dir = "html") {
@ -172,11 +173,11 @@ class m_action {
/** /**
* function inserting the action in the sql table * function inserting the action in the sql table
* *
* @global type $db * @global m_mysql $db
* @global type $err * @global m_err $err
* @param type $type * @param string $type
* @param type $user * @param m_user $user
* @param type $parameters * @param mixed $parameters
* @return boolean * @return boolean
*/ */
function set($type, $user, $parameters) { function set($type, $user, $parameters) {
@ -220,8 +221,8 @@ class m_action {
/** /**
* This seems to be unused ? * This seems to be unused ?
* *
* @global type $err * @global m_err $err
* @global type $db * @global m_mysql $db
* @param type $all * @param type $all
* @return boolean * @return boolean
*/ */
@ -239,8 +240,8 @@ class m_action {
/** /**
* *
* @global type $err * @global m_err $err
* @global type $db * @global m_mysql $db
* @param type $all * @param type $all
* @return boolean * @return boolean
*/ */
@ -263,8 +264,8 @@ class m_action {
/** /**
* function returning the first not locked line of the action table * function returning the first not locked line of the action table
* *
* @global type $db * @global m_mysql $db
* @global type $err * @global m_err $err
* @return boolean or array * @return boolean or array
*/ */
function get_action() { function get_action() {
@ -283,9 +284,9 @@ class m_action {
/** /**
* function locking an entry while it is being executed by the action script * function locking an entry while it is being executed by the action script
* *
* @global type $db * @global m_mysql $db
* @global type $err * @global m_err $err
* @param type $id * @param int $id
* @return boolean * @return boolean
*/ */
function begin($id) { function begin($id) {
@ -300,9 +301,9 @@ class m_action {
/** /**
* function locking an entry while it is being executed by the action script * function locking an entry while it is being executed by the action script
* *
* @global type $db * @global m_mysql $db
* @global type $err * @global m_err $err
* @param type $id * @param int $id
* @param type $return * @param type $return
* @return boolean * @return boolean
*/ */
@ -317,9 +318,9 @@ class m_action {
/** /**
* *
* @global type $db * @global m_mysql $db
* @global type $err * @global m_err $err
* @param type $id * @param int $id
* @return boolean * @return boolean
*/ */
function reset_job($id) { function reset_job($id) {
@ -334,8 +335,8 @@ class m_action {
/** /**
* Returns a list of actions marked as executable and ready for execution * Returns a list of actions marked as executable and ready for execution
* *
* @global type $db * @global m_mysql $db
* @global type $err * @global m_err $err
* @return boolean * @return boolean
*/ */
function get_job() { function get_job() {
@ -353,8 +354,8 @@ class m_action {
/** /**
* function locking an entry while it is being executed by the action script * function locking an entry while it is being executed by the action script
* *
* @global type $db * @global m_mysql $db
* @param type $id * @param int $id
* @return boolean * @return boolean
*/ */
function cancel($id) { function cancel($id) {

View File

@ -100,11 +100,11 @@ class m_variables {
* *
* If $fqdn and $uid aren't specified, return the default value * If $fqdn and $uid aren't specified, return the default value
* *
* @global type $db * @global m_mysql $db
* @global type $err * @global m_err $err
* @param type $fqdn * @param string $fqdn
* @param type $uid * @param int $uid
* @param type $var * @param string $var
* @return array * @return array
*/ */
function get_impersonated($fqdn=null, $uid=null, $var=null) { function get_impersonated($fqdn=null, $uid=null, $var=null) {
@ -186,6 +186,7 @@ class m_variables {
* *
* @global $conf the global conf array * @global $conf the global conf array
* @uses variable_init() * @uses variable_init()
* @param boolean $force
*/ */
function variable_init_maybe($force=false) { function variable_init_maybe($force=false) {
global $conf; global $conf;
@ -198,16 +199,16 @@ class m_variables {
/** /**
* Return a persistent variable. * Return a persistent variable.
* *
* @param $name * @param string $name
* The name of the variable to return. * The name of the variable to return.
* @param $default * @param mixed $default
* The default value to use if this variable has never been set. * The default value to use if this variable has never been set.
* @param $createit_comment * @param string $createit_comment
* If variable doesn't exist, create it with the default value * If variable doesn't exist, create it with the default value
* and createit_comment value as comment * and createit_comment value as comment
* @return * @return mixed
* The value of the variable. * The value of the variable.
* @global $conf * @global array $conf
* A cache of the configuration. * A cache of the configuration.
*/ */
function variable_get($name, $default = null, $createit_comment = null, $type=null) { function variable_get($name, $default = null, $createit_comment = null, $type=null) {
@ -226,15 +227,15 @@ class m_variables {
/** /**
* Create or update a variable * Create or update a variable
* *
* @global type $db * @global m_mysql $db
* @global type $err * @global m_err $err
* @param type $var_name * @param string $var_name
* @param type $var_value * @param mixed $var_value
* @param type $strata * @param string $strata
* @param null $strata_id * @param int $strata_id
* @param null $var_id * @param int $var_id
* @param type $comment * @param string $comment
* @param type $type * @param string $type
* @return boolean * @return boolean
*/ */
function variable_update_or_create($var_name, $var_value, $strata=null, $strata_id=null, $var_id=null, $comment=null, $type=null) { function variable_update_or_create($var_name, $var_value, $strata=null, $strata_id=null, $var_id=null, $comment=null, $type=null) {
@ -277,8 +278,9 @@ class m_variables {
/** /**
* Unset a persistent variable. * Unset a persistent variable.
* *
* @param $name * @global m_mysql $db
* The name of the variable to undefine. * @param int $id
* @return type
*/ */
function del($id) { function del($id) {
global $db; global $db;
@ -290,9 +292,9 @@ class m_variables {
/** /**
* echo HTML code to display a variable passed in parameters * echo HTML code to display a variable passed in parameters
* *
* @param type $v * @param mixed $v
* @param type $varname * @param string $varname
* @param type $echo * @param boolean $echo
* @return type * @return type
*/ */
function display_valueraw_html($v,$varname,$echo = true) { function display_valueraw_html($v,$varname,$echo = true) {
@ -357,11 +359,11 @@ class m_variables {
/** /**
* Display a variable if is set * Display a variable if is set
* *
* @param type $tab * @param array $tab
* @param type $strata * @param string $strata
* @param type $id * @param int $id
* @param type $varname * @param string $varname
* @param type $echo * @param boolean $echo
* @return string * @return string
*/ */
function display_value_html($tab, $strata, $id, $varname, $echo = TRUE) { function display_value_html($tab, $strata, $id, $varname, $echo = TRUE) {
@ -381,7 +383,7 @@ class m_variables {
/** /**
* return hashtable with variable_name => comment for all the vars * return hashtable with variable_name => comment for all the vars
* *
* @global type $db * @global m_mysql $db
* @return type * @return type
*/ */
function variables_list_name() { function variables_list_name() {
@ -402,7 +404,7 @@ class m_variables {
/** /**
* return a multidimensionnal array used to build vars * return a multidimensionnal array used to build vars
* *
* @global type $db * @global m_mysql $db
* @return type * @return type
*/ */
function variables_list() { function variables_list() {