phpdoc blocks

plugins/administrator/auth.php

@@ -6,14 +6,17 @@
  *  
  *  Philippe Mingo
  *  
- *  $Id$
+ * @version $Id$
  * @package plugins
  * @subpackage administrator
  */
 
 /**
-*
-*/
+ * Check if user has access to administrative functions
+ *
+ * @return boolean
+ * @access private
+ */
 function adm_check_user() {
     global $PHP_SELF;
     require_once(SM_PATH . 'functions/global.php');
@@ -41,4 +44,4 @@ function adm_check_user() {
     return ($auth);
 }
 
-?>
+?>

plugins/administrator/defines.php

@@ -8,7 +8,7 @@
  *
  * Philippe Mingo
  *
- * $Id$
+ * @version $Id$
  * @package plugins
  * @subpackage administrator
  */
@@ -348,4 +348,4 @@ $defcfg = array( '$config_version' => array( 'name' => _("Config File Version"),
 
                );
 
-?>
+?>

plugins/administrator/index.php

@@ -1,17 +1,17 @@
 <?php
 
-   /**
-    **  index.php -- Displays the main frameset
-    **
-    **  Copyright (c) 1999-2004 The SquirrelMail development team
-    **  Licensed under the GNU GPL. For full terms see the file COPYING.
-    **
-    **  Redirects to the login page.
-    **
-    **  $Id$
-    * @package plugins
-    * @subpackage administrator
-    **/
+/**
+ *  index.php -- Displays the main frameset
+ *
+ *  Copyright (c) 1999-2004 The SquirrelMail development team
+ *  Licensed under the GNU GPL. For full terms see the file COPYING.
+ *
+ *  Redirects to the login page.
+ *
+ * @version $Id$
+ * @package plugins
+ * @subpackage administrator
+ */
 
    header("Location:../../src/login.php\n\n");
    exit();

plugins/administrator/options.php

@@ -8,13 +8,16 @@
  *
  * Philippe Mingo
  *
- * $Id$
+ * @version $Id$
  * @package plugins
  * @subpackage administrator
  */
 
 /**
  * parse the config file
+ *
+ * @param string $cfg_file
+ * @access private
  */
 function parseConfig( $cfg_file ) {
 
@@ -134,14 +137,19 @@ function parseConfig( $cfg_file ) {
     }
 }
 
-/* Change paths containing SM_PATH to admin-friendly paths
-   relative to the config dir, i.e.:
-     ''                          --> <empty string>
-     SM_PATH . 'images/logo.gif' --> ../images/logo.gif
-     '/absolute/path/logo.gif'   --> /absolute/path/logo.gif
-     'http://whatever/'          --> http://whatever
-   Note removal of quotes in returned value
-*/
+/**
+ * Change paths containing SM_PATH to admin-friendly paths
+ * relative to the config dir, i.e.:
+ *    ''                          --> <empty string>
+ *    SM_PATH . 'images/logo.gif' --> ../images/logo.gif
+ *    '/absolute/path/logo.gif'   --> /absolute/path/logo.gif
+ *    'http://whatever/'          --> http://whatever
+ *  Note removal of quotes in returned value
+ *  
+ * @param string $old_path path that has to be converted
+ * @return string new path
+ * @access private
+ */
 function change_to_rel_path($old_path) {
     $new_path = str_replace("SM_PATH . '", "../", $old_path); 
     $new_path = str_replace("../config/","", $new_path);
@@ -149,13 +157,18 @@ function change_to_rel_path($old_path) {
     return $new_path;
 }
 
-/* Change relative path (relative to config dir) to 
-   internal SM_PATH, i.e.:
-     empty_string            --> ''
-     ../images/logo.gif      --> SM_PATH . 'images/logo.gif'
-     images/logo.gif         --> SM_PATH . 'config/images/logo.gif'
-     /absolute/path/logo.gif --> '/absolute/path/logo.gif'
-     http://whatever/        --> 'http://whatever'
+/**
+ * Change relative path (relative to config dir) to 
+ *  internal SM_PATH, i.e.:
+ *     empty_string            --> ''
+ *     ../images/logo.gif      --> SM_PATH . 'images/logo.gif'
+ *     images/logo.gif         --> SM_PATH . 'config/images/logo.gif'
+ *     /absolute/path/logo.gif --> '/absolute/path/logo.gif'
+ *     http://whatever/        --> 'http://whatever'
+ *  
+ * @param string $old_path path that has to be converted
+ * @return string new path
+ * @access private
 */     
 function change_to_sm_path($old_path) {
    if ( $old_path === '' || $old_path == "''" ) {

plugins/administrator/setup.php

@@ -8,7 +8,7 @@
  *
  *  Administrator plugin. Allows remote administration.  Philippe Mingo
  *
- * $Id$
+ * @version $Id$
  * @package plugins
  * @subpackage administrator
  */
@@ -16,6 +16,10 @@
 /** @ignore */
 require_once(SM_PATH . 'plugins/administrator/auth.php');
 
+/**
+ * Init the plugin
+ * @access private
+ */
 function squirrelmail_plugin_init_administrator() {
     global $squirrelmail_plugin_hooks, $username;
 
@@ -25,6 +29,10 @@ function squirrelmail_plugin_init_administrator() {
     }
 }
 
+/**
+ * Register option block
+ * @access private
+ */
 function squirrelmail_administrator_optpage_register_block() {
     global $optpage_blocks;
     global $AllowSpamFilters;
@@ -36,4 +44,4 @@ function squirrelmail_administrator_optpage_register_block() {
         'js'   => false
     );
 }
-?>
+?>