Initial groundwork to use phpdocumentor.

Added @package and @subpackage tags.
Some cases of define() for SM_PATH were tagged @ignore to reduce the number of phpdocumentor warnings - this may need to be done everywhere else, or removed where I've done it so far.  We'll see.

plugins/abook_take/setup.php

@@ -11,8 +11,14 @@
  * message.
  *
  * $Id$
+ * @package plugins
+ * @subpackage abook_take
  */
 
+/**
+ * If SM_PATH isn't defined, define it.  Required to include files.
+ * @ignore
+ */
 if (!defined('SM_PATH'))  {
     define('SM_PATH','../../');
 }
@@ -20,6 +26,9 @@ if (!defined('SM_PATH'))  {
 /* SquirrelMail required files. */
 require_once(SM_PATH . 'functions/url_parser.php');
 
+/**
+ * Initialize the plugin
+ */
 function squirrelmail_plugin_init_abook_take()
 {
     global $squirrelmail_plugin_hooks;

plugins/abook_take/take.php

@@ -10,9 +10,13 @@
  * the To, Cc, From and Reply-To headers.
  *
  * $Id$
+ * @package plugins
+ * @subpackage abook_take
  */
    
-/* Path for SquirrelMail required files. */
+/**
+ * Path for SquirrelMail required files.
+ * @ignore */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/administrator/auth.php

@@ -1,14 +1,19 @@
 <?php
 
-/*
+/**
  *  This function tell other modules what users have access
  *  to the plugin.
  *  
  *  Philippe Mingo
  *  
  *  $Id$
+ * @package plugins
+ * @subpackage administrator
  */
 
+/**
+*
+*/
 function adm_check_user() {
     global $PHP_SELF;
     require_once(SM_PATH . 'functions/global.php');

plugins/administrator/defines.php

@@ -9,8 +9,11 @@
  * Philippe Mingo
  *
  * $Id$
+ * @package plugins
+ * @subpackage administrator
  */
 
+/** */
 require_once( SM_PATH . 'functions/constants.php' );
 
 /* Define constants for the various option types. */

plugins/administrator/index.php

@@ -9,9 +9,11 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage administrator
     **/
 
    header("Location:../../src/login.php\n\n");
    exit();
 
-?>
+?>

plugins/administrator/options.php

@@ -9,8 +9,13 @@
  * Philippe Mingo
  *
  * $Id$
+ * @package plugins
+ * @subpackage administrator
  */
 
+/**
+ * parse the config file
+ */
 function parseConfig( $cfg_file ) {
 
     global $newcfg;
@@ -195,6 +200,7 @@ function change_to_sm_path($old_path) {
 
 /* ---------------------- main -------------------------- */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/administrator/setup.php

@@ -9,8 +9,11 @@
  *  Administrator plugin. Allows remote administration.  Philippe Mingo
  *
  * $Id$
+ * @package plugins
+ * @subpackage administrator
  */
 
+/** @ignore */
 require_once(SM_PATH . 'plugins/administrator/auth.php');
 
 function squirrelmail_plugin_init_administrator() {

plugins/bug_report/bug_report.php

@@ -14,8 +14,13 @@
  * This is a standard Squirrelmail-1.2 API for plugins.
  *
  * $Id$
+ * @package plugins
+ * @subpackage bug_report
  */
 
+/**
+ * @ignore
+ */
 define('SM_PATH','../../');
 
 require_once(SM_PATH . 'include/validate.php');

plugins/bug_report/index.php

@@ -9,6 +9,8 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage bug_report
     **/
 
    header("Location:../../src/login.php\n\n");

plugins/bug_report/setup.php

@@ -9,13 +9,18 @@
  * This is a standard Squirrelmail-1.2 API for plugins.
  *
  * $Id$
+ * @package plugins
+ * @subpackage bug_report
  */
 
 /* This button fills out a form with your setup information already
    gathered -- all you have to do is type. */
 
 
-/* Initialize the bug report plugin */
+/**
+ * Initialize the bug report plugin
+ * @return void
+ */
 function squirrelmail_plugin_init_bug_report() {
     global $squirrelmail_plugin_hooks;
 

plugins/calendar/calendar.php

@@ -11,7 +11,12 @@
  * Displays the main calendar page (month view).
  *
  * $Id$
+ * @package plugins
+ * @subpackage calendar
  */
+
+/**
+*/
 define('SM_PATH','../../');
 
 /* Calender plugin required files. */

plugins/calendar/calendar_data.php

@@ -11,18 +11,22 @@
  * functions to operate on calendar data files.
  *
  * $Id$
+ * @package plugins
+ * @subpackage calendar
  */
 
-// this is array that contains all events
-// it is three dimensional array with fallowing structure
-// $calendardata[date][time] = array(length,priority,title,message);
+/** this is array that contains all events
+ *  it is three dimensional array with fallowing structure
+ *  $calendardata[date][time] = array(length,priority,title,message); */
 $calendardata = array();
 
-//read events into array
-//data is | delimited, just like addresbook
-//files are structured like this:
-//date|time|length|priority|title|message);
-//files are divide by year for performance increase
+/**
+ * read events into array
+ *
+ * data is | delimited, just like addressbook
+ * files are structured like this:
+ * date|time|length|priority|title|message
+ * files are divided by year for performance increase */
 function readcalendardata() {
     global $calendardata, $username, $data_dir, $year;
 

plugins/calendar/day.php

@@ -11,8 +11,11 @@
  * Displays the day page (day view).
  *
  * $Id$
+ * @package plugins
+ * @subpackage calendar
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 /* Calender plugin required files. */

plugins/calendar/event_create.php

@@ -11,6 +11,12 @@
  * functions to create a event for calendar.
  *
  * $Id$
+ * @package plugins
+ * @subpackage calendar
+ */
+
+/**
+ * @ignore
  */
 define('SM_PATH','../../');
 

plugins/calendar/event_delete.php

@@ -11,6 +11,12 @@
  * Functions to delete a event. 
  *
  * $Id$
+ * @package plugins
+ * @subpackage calendar
+ */
+
+/**
+ * @ignore
  */
 define('SM_PATH','../../');
 

plugins/calendar/event_edit.php

@@ -11,7 +11,11 @@
  * Functions to edit an event.
  *
  * $Id$
+ * @package plugins
+ * @subpackage calendar
  */
+
+/** @ignore */
 define('SM_PATH','../../');
 
 /* Calender plugin required files. */

plugins/calendar/functions.php

@@ -11,9 +11,13 @@
  * miscelenous functions.
  *
  * $Id$
+ * @package plugins
+ * @subpackage calendar
  */
 
-
+/**
+ * @return void
+ */
 function calendar_header() {
     //Add Second layer ofCalendar links to upper menu
     global $color,$year,$day,$month;

plugins/calendar/index.php

@@ -9,6 +9,8 @@
  * Redirects to the login page.
  *
  * $Id$
+ * @package plugins
+ * @subpackage calendar
  */
 
 header("Location:../../src/login.php\n\n");

plugins/calendar/setup.php

@@ -11,8 +11,14 @@
  * init plugin into squirrelmail
  *
  * $Id$ 
+ * @package plugins
+ * @subpackage calendar
  */
 
+/**
+ * Initialize the plugin
+ * @return void
+ */
 function squirrelmail_plugin_init_calendar() {
     global $squirrelmail_plugin_hooks;
     $squirrelmail_plugin_hooks['menuline']['calendar'] = 'calendar';

plugins/delete_move_next/index.php

@@ -9,9 +9,11 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage delete_move_next
     **/
 
    header("Location:../../src/login.php\n\n");
    exit();
 
-?>
+?>

plugins/delete_move_next/setup.php

@@ -11,8 +11,14 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package plugins
+ * @subpackage delete_move_next
  */
 
+/**
+ * Initialize the plugin
+ * @return void
+ */
 function squirrelmail_plugin_init_delete_move_next() {
     global $squirrelmail_plugin_hooks;
 

plugins/filters/filters.php

@@ -23,8 +23,13 @@
  * Also view plugins/README.plugins for more information.
  *
  * $Id$
+ * @package plugins
+ * @subpackage filters
  */
 
+/**
+*
+*/
 function filters_SaveCache () {
     global $data_dir, $SpamFilters_DNScache;
 

plugins/filters/index.php

@@ -9,6 +9,8 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage filters
     **/
 
    header("Location:../../src/login.php\n\n");

plugins/filters/options.php

@@ -23,9 +23,11 @@
  * Also view plugins/README.plugins for more information.
  *
  * $Id$
+ * @package plugins
+ * @subpackage filters
  */
 
-/* Path for SquirrelMail required files. */
+/** Path for SquirrelMail required files. */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/filters/setup.php

@@ -22,9 +22,11 @@
  * Also view plugins/README.plugins for more information.
  *
  * $Id$
+ * @package plugins
+ * @subpackage filters
  */
 
-/* SquirrelMail required files. */
+/** SquirrelMail required files. */
 require_once(SM_PATH . 'plugins/filters/filters.php');
 
 /*

plugins/filters/spamoptions.php

@@ -22,9 +22,11 @@
  * Also view plugins/README.plugins for more information.
  *
  * $Id$
+ * @package plugins
+ * @subpackage filters
  */
 
-/* Path for SquirrelMail required files. */
+/** Path for SquirrelMail required files. */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/fortune/setup.php

@@ -12,8 +12,13 @@
  * fortune above the message listing.
  *
  * $Id$
+ * @package plugins
+ * @subpackage fortune
  */
 
+/**
+*
+*/
 function squirrelmail_plugin_init_fortune() {
   global $squirrelmail_plugin_hooks;
   

plugins/index.php

@@ -11,6 +11,7 @@
  * the person is logged or not.
  *
  * $Id$
+ * @package plugins
  */
 
 header("Location:../index.php");

plugins/info/functions.php

@@ -1,6 +1,7 @@
 <?PHP
 
-/* functions for info plugin
+/**
+ * functions for info plugin
  * Copyright (c) 1999-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
@@ -12,13 +13,22 @@
  * by: Jason Munro jason@stdbev.com
  *
  * $Id$ 
- *
+ * @package plugins
+ * @subpackage info
  */
 
+/**
+ * Get the IMAP capabilities
+ * @return array
+ */
 function get_caps($imap_stream) {
     return sqimap_run_command_list($imap_stream, 'CAPABILITY',false, $responses, $message,false);
 }
 
+/**
+ * Run an IMAP test and return the results
+ * @return array Response from the IMAP server
+ */
 function imap_test($imap_stream, $string) {
     global $default_charset;
     print "<TR><TD>".$string."</TD></TR>";
@@ -27,6 +37,9 @@ function imap_test($imap_stream, $string) {
     return $response;
 }
 
+/**
+ * Print the IMAP response to options.php
+ */
 function print_response($response) {
     foreach($response as $index=>$value) {
         if (is_array($value)) {

plugins/info/options.php

@@ -1,6 +1,7 @@
 <?PHP
 
-/* options page for IMAP info plugin 
+/**
+ * options page for IMAP info plugin 
  * Copyright (c) 1999-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *   
@@ -10,9 +11,11 @@
  * jason@stdbev.com
  * 
  * $Id$
- * 
+ * @package plugins
+ * @subpackage info
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/info/setup.php

@@ -1,15 +1,17 @@
 <?php
 
-/* setup file for the IMAP server info plugin
+/** setup file for the IMAP server info plugin
  * Copyright (c) 1999-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *   
  * by: Jason Munro jason@stdbev.com
  * 
  * $Id$
- * 
+ * @package plugins
+ * @subpackage info
  */
 
+/** @ignore */
 require_once (SM_PATH . 'plugins/info/functions.php');
 
 function squirrelmail_plugin_init_info() {

plugins/listcommands/index.php

@@ -9,9 +9,11 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage listcommands
     **/
 
    header("Location:../../src/login.php\n\n");
    exit();
 
-?>
+?>

plugins/listcommands/mailout.php

@@ -6,8 +6,11 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package plugins
+ * @subpackage listcommands
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/listcommands/setup.php

@@ -12,8 +12,13 @@
  * commands such as (un)subscribe, help and list archives.
  *
  * $Id$
+ * @package plugins
+ * @subpackage listcommands
  */
 
+/**
+ * Initialize the listcommands plugin
+ */
 function squirrelmail_plugin_init_listcommands () {
     global $squirrelmail_plugin_hooks;
 

plugins/mail_fetch/class.POP3.php

@@ -14,8 +14,13 @@
     * pop3 class
     *
     * $Id$
+    * @package plugins
+    * @subpackage mail_fetch
     */
 
+/**
+ * This is the pop3 class - DOCUMENT ME
+ */
 class POP3 {
     var $ERROR      = '';       //  Error string.
 

plugins/mail_fetch/fetch.php

@@ -9,8 +9,11 @@
  * Fetch code.
  *
  * $Id$
+ * @package plugins
+ * @subpackage mail_fetch
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 require_once(SM_PATH . 'include/validate.php');

plugins/mail_fetch/functions.php

@@ -13,8 +13,13 @@
     **  Adapted for MailFetch by Philippe Mingo <mingo@rotedic.com>
     **
     **  $Id$
+    * @package plugins
+    * @subpackage mail_fetch
     **/
 
+    /**
+     * hex2bin - document me
+     */
     function hex2bin( $data ) {
 
         /* Original code by josh@superfork.com */

plugins/mail_fetch/index.php

@@ -9,9 +9,11 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage mail_fetch
     **/
 
    header("Location:../../src/login.php\n\n");
    exit();
 
-?>
+?>

plugins/mail_fetch/options.php

@@ -9,8 +9,11 @@
  * Setup of the mailfetch plugin.
  *
  * $Id$
+ * @package plugins
+ * @subpackage mail_fetch
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 require_once(SM_PATH . 'include/validate.php');

plugins/mail_fetch/setup.php

@@ -9,10 +9,16 @@
     **  Setup of the mailfetch plugin.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage mail_fetch
     **/
-
+    
+    /**  */
     require_once(SM_PATH . 'plugins/mail_fetch/functions.php' );
 
+    /**
+     * Initialize the plugin
+     */
     function squirrelmail_plugin_init_mail_fetch() {
         global $squirrelmail_plugin_hooks;
 

plugins/message_details/message_details_bottom.php

@@ -8,8 +8,11 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  * 
  * $Id$
+ * @package plugins
+ * @subpackage message_details
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/message_details/message_details_main.php

@@ -7,9 +7,14 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  * 
  * $Id$
+ * @package plugins
+ * @subpackage message_details
  */
 
-/* Path for SquirrelMail required files. */
+/**
+ * Path for SquirrelMail required files.
+ * @ignore
+ */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/message_details/message_details_top.php

@@ -8,8 +8,11 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  * 
  * $Id$
+ * @package plugins
+ * @subpackage message_details
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/message_details/setup.php

@@ -7,9 +7,13 @@
 * Licensed under the GNU GPL. For full terms see the file COPYING.
 * 
 * $Id$
+* @package plugins
+* @subpackage message_details
 **/
 
-
+/**
+ * Initialize the plugin
+ */
 function squirrelmail_plugin_init_message_details()
 {
   global $squirrelmail_plugin_hooks;

plugins/newmail/index.php

@@ -9,9 +9,11 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage newmail
     **/
 
    header("Location:../../src/login.php\n\n");
    exit();
 
-?>
+?>

plugins/newmail/newmail.php

@@ -8,9 +8,12 @@
  *
  * Displays all options relating to new mail sounds
  *
- * $Id$    
+ * $Id$
+ * @package plugins
+ * @subpackage newmail
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/newmail/newmail_opt.php

@@ -9,8 +9,11 @@
  * Displays all options relating to new mail sounds
  *
  * $Id$
+ * @package plugins
+ * @subpackage newmail
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/newmail/setup.php

@@ -23,6 +23,11 @@
     * too (with a plugin).
     *
     * $Id$
+    * @package plugins
+    * @subpackage newmail
+    */
+
+    /**
     */
     include_once(SM_PATH . 'functions/display_messages.php');
 

plugins/newmail/testsound.php

@@ -7,8 +7,11 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.        
  *
  * $Id$
+ * @package plugins
+ * @subpackage newmail
  */
 
+/** @ignore */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/sent_subfolders/index.php

@@ -9,9 +9,11 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage sent_subfolders
     **/
 
    header("Location:../../src/login.php\n\n");
    exit();
 
-?>
+?>

plugins/sent_subfolders/setup.php

@@ -9,8 +9,13 @@
  * This is a standard Squirrelmail-1.2 API for plugins.
  *
  * $Id$
+ * @package plugins
+ * @subpackage sent_subfolders
  */
 
+/** 
+ * 
+ */
 define('SMPREF_SENT_SUBFOLDERS_DISABLED',  0);
 define('SMPREF_SENT_SUBFOLDERS_YEARLY',    1);
 define('SMPREF_SENT_SUBFOLDERS_QUARTERLY', 2);

plugins/spamcop/index.php

@@ -9,9 +9,11 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage spamcop
     **/
 
    header("Location:../../src/login.php\n\n");
    exit();
 
-?>
+?>

plugins/spamcop/options.php

@@ -7,8 +7,11 @@
     **  Licensed under the GNU GPL. For full terms see the file COPYING.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage spamcop
     **/
 
+/** @ignore */
 define('SM_PATH','../../');
 require_once(SM_PATH . 'include/validate.php');
 

plugins/spamcop/setup.php

@@ -5,13 +5,16 @@
     **  Copyright (c) 1999-2003 The SquirrelMail development team
     **  Licensed under the GNU GPL. For full terms see the file COPYING.
     **  
-    **  $Id$                                                         
+    **  $Id$
+    * @package plugins
+    * @subpackage spamcop
     **/
 
+/** @ignore */
 require_once(SM_PATH . 'functions/global.php');
 
 
-/* Initialize the plugin */
+/** Initialize the plugin */
 function squirrelmail_plugin_init_spamcop() {
    global $squirrelmail_plugin_hooks, $data_dir, $username,
       $spamcop_is_composing;

plugins/spamcop/spamcop.php

@@ -5,9 +5,12 @@
     **  Copyright (c) 1999-2003 The SquirrelMail development team
     **  Licensed under the GNU GPL. For full terms see the file COPYING.
     **  
-    **  $Id$                                                         
+    **  $Id$
+    * @package plugins
+    * @subpackage spamcop
     **/
 
+/** @ignore */
 define('SM_PATH','../../');
 
  /* SquirrelMail required files. */

plugins/squirrelspell/doc/index.php

@@ -9,6 +9,8 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage squirrelspell
     **/
 
    header("Location:../../../src/login.php\n\n");

plugins/squirrelspell/index.php

@@ -11,6 +11,8 @@
  * the person is logged or not.
  *
  * $Id$
+ * @package plugins
+ * @subpackage squirrelspell
  */
 
 header("Location: ../../index.php");

plugins/squirrelspell/js/index.php

@@ -9,6 +9,8 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage squirrelspell
     **/
 
    header("Location:../../../src/login.php\n\n");

plugins/squirrelspell/modules/index.php

@@ -9,9 +9,11 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage squirrelspell
     **/
 
    header("Location:../../../src/login.php\n\n");
    exit();
 
-?>
+?>

plugins/squirrelspell/setup.php

@@ -11,6 +11,8 @@
  *
  * @author Konstantin Riabitsev <icon@duke.edu> ($Author$)
  * @version $Date$
+ * @package plugins
+ * @subpackage squirrelspell
  */
 
 /**

plugins/squirrelspell/sqspell_config.php

@@ -8,8 +8,11 @@
  *
  *
  * $Id$
+ * @package plugins
+ * @subpackage squirrelspell
  */
 
+/** */
 require_once(SM_PATH . 'functions/prefs.php');
 
 /* Just for poor wretched souls with E_ALL. :) */

plugins/squirrelspell/sqspell_functions.php

@@ -11,6 +11,8 @@
  *
  * @author Konstantin Riabitsev <icon@duke.edu> ($Author$)
  * @version $Date$
+ * @package plugins
+ * @subpackage squirrelspell
  */
 
 /**

plugins/squirrelspell/sqspell_interface.php

@@ -15,6 +15,8 @@
  *
  * @author Konstantin Riabitsev <icon@duke.edu> ($Author$)
  * @version $Date$
+ * @package plugins
+ * @subpackage squirrelspell
  */
 
 /**    	
@@ -27,8 +29,8 @@ $SQSPELL_CRYPTO=FALSE;
     
 /**
  * Load the stuff needed from squirrelmail
+ * @ignore
  */
-
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/squirrelspell/sqspell_options.php

@@ -11,6 +11,8 @@
  *
  * @author Konstantin Riabitsev <icon@duke.edu> ($Author$)
  * @version $Date$
+ * @package plugins
+ * @subpackage squirrelspell
  */
 
 /**
@@ -22,6 +24,7 @@ $SQSPELL_CRYPTO=FALSE;
 
 /**
  * Load some necessary stuff from squirrelmail. 
+ * @ignore
  */
 define('SM_PATH','../../');
 

plugins/translate/index.php

@@ -9,9 +9,11 @@
     **  Redirects to the login page.
     **
     **  $Id$
+    * @package plugins
+    * @subpackage translate
     **/
 
    header("Location:../../src/login.php\n\n");
    exit();
 
-?>
+?>

plugins/translate/options.php

@@ -9,9 +9,14 @@
  * Pick your translator to translate the body of incoming mail messages
  *
  * $Id$
+ * @package plugins
+ * @subpackage translate
  */
 
-/* Path for SquirrelMail required files. */
+/**
+ * Path for SquirrelMail required files.
+ * @ignore
+ */
 define('SM_PATH','../../');
 
 /* SquirrelMail required files. */

plugins/translate/setup.php

@@ -7,6 +7,8 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package plugins
+ * @subpackage translate
  */
 
 /* Easy plugin that sends the body of the message to a new browser
@@ -31,7 +33,10 @@ outgoing message if you send it to someone in a different country.
 */
 
 
-/* Initialize the translation plugin */
+/**
+ * Initialize the translation plugin
+ * @return void
+ */
 function squirrelmail_plugin_init_translate() {
   global $squirrelmail_plugin_hooks;