From c4309fbd89c120fad6921e58955fec5e0a592a0e Mon Sep 17 00:00:00 2001
From: tassium <tassium@7612ce4b-ef26-0410-bec9-ea0150e637f0>
Date: Tue, 28 Oct 2003 20:58:30 +0000
Subject: [PATCH] Added @package and @subpackage tags (and in some cases,
 @author tags) in preparation to begin using phpdocumentor. NOTE: Themes are
 part of package squirrelmail, subpackage themes.

git-svn-id: https://svn.code.sf.net/p/squirrelmail/code/trunk/squirrelmail@6038 7612ce4b-ef26-0410-bec9-ea0150e637f0
---
 themes/alien_glow.php               | 14 ++++++------
 themes/black_bean_burrito_theme.php |  4 +++-
 themes/blue_grey_theme.php          |  4 +++-
 themes/bluesnews_theme.php          | 15 +++++++------
 themes/bluesteel_theme.php          |  2 ++
 themes/christmas.php                |  4 +++-
 themes/dark_green.php               | 11 ++++++----
 themes/dark_grey_theme.php          |  4 +++-
 themes/darkness.php                 | 18 ++++++++-------
 themes/deepocean2_theme.php         | 10 +++++----
 themes/deepocean_theme.php          | 10 +++++----
 themes/default_theme.php            | 34 +++++++++++++++--------------
 themes/dompie_theme.php             | 10 +++++----
 themes/forest_theme.php             | 10 +++++----
 themes/greenhouse_effect.php        | 13 ++++++-----
 themes/high_contrast_theme.php      |  9 ++++----
 themes/ice_theme.php                |  9 ++++----
 themes/in_the_pink.php              | 12 +++++-----
 themes/kind_of_blue.php             | 14 +++++++-----
 themes/maize_theme.php              | 22 ++++++++++---------
 themes/methodical_theme.php         | 14 +++++++-----
 themes/midnight.php                 | 10 +++++----
 themes/minimal_bw.php               | 19 +++++++++-------
 themes/monostochastic.php           | 14 +++++++-----
 themes/penguin.php                  | 12 +++++-----
 themes/plain_blue_theme.php         | 10 ++++-----
 themes/purple_theme.php             | 13 ++++++-----
 themes/random.php                   | 12 +++++-----
 themes/sandstorm_theme.php          | 11 +++++-----
 themes/seaspray_theme.php           | 10 ++++-----
 themes/servery_theme.php            | 10 ++++-----
 themes/shades_of_grey.php           | 15 +++++++------
 themes/slashdot_theme.php           | 13 ++++++-----
 themes/spice_of_life.php            | 13 ++++++-----
 themes/spice_of_life_dark.php       | 13 ++++++-----
 themes/spice_of_life_lite.php       | 13 ++++++-----
 36 files changed, 243 insertions(+), 188 deletions(-)

diff --git a/themes/alien_glow.php b/themes/alien_glow.php
index 9c3ad4ae..92eaa986 100644
--- a/themes/alien_glow.php
+++ b/themes/alien_glow.php
@@ -1,11 +1,11 @@
 <?php
-   /** 
-	Author:       Todd Hammer <thammer@rtccom.com>
-	Name:		  Alien Glow Theme
-	Date:         May 2, 2002
-	Theme Name:   "Alien Glow Color Scheme"
-
-    **/
+/**
+ * @author Todd Hammer <thammer@rtccom.com>
+ * Name: Alien Glow Theme
+ * Date: May 2, 2002
+ * @package squirrelmail
+ * @subpackage themes
+ */
 
     $color[0]   = "#19881A"; //      TitleBar
     $color[1]   = "#800000"; // 
diff --git a/themes/black_bean_burrito_theme.php b/themes/black_bean_burrito_theme.php
index 846363e3..92959b9c 100644
--- a/themes/black_bean_burrito_theme.php
+++ b/themes/black_bean_burrito_theme.php
@@ -3,13 +3,15 @@
 /**
  * black_bean_burrito_theme.php
  *    Name:   Black Bean Burrito
- *    Author: Ray Black
+ * @author Ray Black
  *    Date:   August 15, 2000
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/blue_grey_theme.php b/themes/blue_grey_theme.php
index b2fc4f53..ab65a394 100644
--- a/themes/blue_grey_theme.php
+++ b/themes/blue_grey_theme.php
@@ -3,13 +3,15 @@
 /**
  * blue_grey_theme.php
  *    Name:   Blue-grey
- *    Author: M.J. Prinsen
+ * @author M.J. Prinsen
  *    Date:   July 20, 2001
  *
  * Copyright (c) 2001-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/bluesnews_theme.php b/themes/bluesnews_theme.php
index 36af7747..06e8d2dc 100644
--- a/themes/bluesnews_theme.php
+++ b/themes/bluesnews_theme.php
@@ -1,18 +1,19 @@
 <?php
 
 /**
- * black_bean_burrito_theme.php
- *    Name:    BluesNews
- *    Author:  Ray Black
- *    Date:    August 15, 2000
- *    Comment: In the long tradition of mimicing popular sites, I bring
- *             you the 'inspired by BluesNews.com' theme. Simple, high-
- *             contrast colorset, easy to read with very little eye strain.
+ * Name:    BluesNews
+ * @author Ray Black
+ * Date:    August 15, 2000
+ * Comment: In the long tradition of mimicing popular sites, I bring
+ *          you the 'inspired by BluesNews.com' theme. Simple, high-
+ *          contrast colorset, easy to read with very little eye strain.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/bluesteel_theme.php b/themes/bluesteel_theme.php
index 3ba3f55d..0950e68d 100644
--- a/themes/bluesteel_theme.php
+++ b/themes/bluesteel_theme.php
@@ -7,6 +7,8 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/christmas.php b/themes/christmas.php
index 33858f4f..c04e1e61 100644
--- a/themes/christmas.php
+++ b/themes/christmas.php
@@ -3,7 +3,7 @@
 /**
  * christmas.php
  *    Name:    Christmas
- *    Author:  Jon Tai
+ * @author Jon Tai
  *    Date:    December 23, 2001
  *    Comment: This is a Christmas theme shipped with SquirrelMail 1.2.0.
  *
@@ -11,6 +11,8 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/dark_green.php b/themes/dark_green.php
index 8acb5cb0..5bce80b7 100644
--- a/themes/dark_green.php
+++ b/themes/dark_green.php
@@ -1,8 +1,11 @@
 <?php
-   /** Author:       Jason Munro 
-       Date:         June 10 2002
-       Theme Name:   "Dark Green"
-    **/
+/**
+ * @author Jason Munro 
+ * Date:         June 10 2002
+ * Theme Name:   "Dark Green"
+ * @package squirrelmail
+ * @subpackage themes
+ */
 
     global $color;
     $color[0]   = "#0a2801"; 
diff --git a/themes/dark_grey_theme.php b/themes/dark_grey_theme.php
index 2a39d71c..048f3122 100644
--- a/themes/dark_grey_theme.php
+++ b/themes/dark_grey_theme.php
@@ -3,13 +3,15 @@
 /**
  * dark_grey_theme.php
  *    Name:   Dark Grey
- *    Author: Justin Miller
+ * @author Justin Miller
  *    Date:   July 24, 2000
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/darkness.php b/themes/darkness.php
index 6454e721..61fbb488 100755
--- a/themes/darkness.php
+++ b/themes/darkness.php
@@ -1,12 +1,14 @@
 <?php
-   /** Author:       Tyler Akins
-       Theme Name:   'Darkness'
-
-       Like black?
-       
-   **/
-
-
+/**
+ * @author Tyler Akins
+ * Theme Name:   'Darkness'
+ * Like black?
+ * @package squirrelmail
+ * @subpackage themes
+ */
+
+/**
+ * Load up the usual suspects.. */
 require_once(SM_PATH . 'functions/strings.php');
 
    // Note:  The text distance is actually pre-squared
diff --git a/themes/deepocean2_theme.php b/themes/deepocean2_theme.php
index d0aff413..9c6b0151 100644
--- a/themes/deepocean2_theme.php
+++ b/themes/deepocean2_theme.php
@@ -2,15 +2,17 @@
 
 /**
  * deepocean2_theme.php
- *    Name:    Deep Ocean 2
- *    Author:  M.J. Prinsen
- *    Date:    May 23, 2000
- *    Comment: Deep Ocean 2 is very blue with a white background.
+ * Name:    Deep Ocean 2
+ * @author M.J. Prinsen
+ * Date:    May 23, 2000
+ * Comment: Deep Ocean 2 is very blue with a white background.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/deepocean_theme.php b/themes/deepocean_theme.php
index 9a137c8c..ddd44303 100644
--- a/themes/deepocean_theme.php
+++ b/themes/deepocean_theme.php
@@ -2,15 +2,17 @@
 
 /**
  * deepocean_theme.php
- *    Name:    Deep Ocean
- *    Author:  M.J. Prinsen
- *    Date:    January 3, 2000
- *    Comment: Deep Ocean is a theme that is very blue.
+ * Name:    Deep Ocean
+ * @author M.J. Prinsen
+ * Date:    January 3, 2000
+ * Comment: Deep Ocean is a theme that is very blue.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/default_theme.php b/themes/default_theme.php
index b940dc3b..6c1b5f92 100644
--- a/themes/default_theme.php
+++ b/themes/default_theme.php
@@ -1,20 +1,22 @@
 <?php
-   /** Author:       Luke Ehresman
-       Date:         January 2, 2000
-       Theme Name:   'Default Theme'
-
-       This is the default theme that comes standard with SquirrelMail.
-       Most of the colors were taken from mail.yahoo.com's theme on their
-       site.
-
-       To create a new theme, just copy this file, and edit the colors.
-       Be sure to rename the file and keep the original, just in case.
-
-       NOTE:
-       You might want to submit the theme you create to our Patches tracker
-       on http://sourceforge.net/projects/squirrelmail
-       for inclusion in further releases of SquirrelMail.
-    **/
+/**
+ * @author Luke Ehresman
+ * January 2, 2000
+ * Theme Name:   'Default Theme'
+ * This is the default theme that comes standard with SquirrelMail.
+ * Most of the colors were taken from mail.yahoo.com's theme on their
+ * site.
+ *
+ * To create a new theme, just copy this file, and edit the colors.
+ * Be sure to rename the file and keep the original, just in case.
+ *
+ * NOTE:
+ * You might want to submit the theme you create to our Patches tracker
+ * on http://sourceforge.net/projects/squirrelmail
+ * for inclusion in further releases of SquirrelMail.
+ * @package squirrelmail
+ * @subpackage themes
+ **/
 
     global $color;
     $color[0]   = '#DCDCDC'; // (light gray)     TitleBar
diff --git a/themes/dompie_theme.php b/themes/dompie_theme.php
index 2c4019ee..49ea20cf 100644
--- a/themes/dompie_theme.php
+++ b/themes/dompie_theme.php
@@ -2,15 +2,17 @@
 
 /**
  * dompie_theme.php
- *    Name:    Dompie
- *    Author:  M.J. Prinsen
- *    Date:    November 19, 2001
- *    Comment: Has a dark blue left-bar and a white/grey right frame.
+ * Name:    Dompie
+ * @author M.J. Prinsen
+ * Date:    November 19, 2001
+ * Comment: Has a dark blue left-bar and a white/grey right frame.
  *
  * Copyright (c) 2001-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/forest_theme.php b/themes/forest_theme.php
index e478ddd2..5825f856 100644
--- a/themes/forest_theme.php
+++ b/themes/forest_theme.php
@@ -2,15 +2,17 @@
 
 /**
  * dompie_theme.php
- *    Name:    Forest
- *    Author:  Luke Ehresman
- *    Date:    January 7, 2000
- *    Comment: This theme uses Forest-ish colors (mostly green).
+ * Name:    Forest
+ * @author Luke Ehresman
+ * Date:    January 7, 2000
+ * Comment: This theme uses Forest-ish colors (mostly green).
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/greenhouse_effect.php b/themes/greenhouse_effect.php
index 192faecb..c3af1394 100755
--- a/themes/greenhouse_effect.php
+++ b/themes/greenhouse_effect.php
@@ -1,17 +1,18 @@
 <?php
 
 /**
- * dompie_theme.php
- *    Name:    Greenhouse Effect
- *    Author:  Joey Bump
- *    Date:    October 20, 2001
- *    Comment: This theme generates random colors, featuring a
- *             light greenish background.
+ * Name:    Greenhouse Effect
+ * @author Joey Bump
+ * Date:    October 20, 2001
+ * Comment: This theme generates random colors, featuring a
+ *          light greenish background.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 /** seed the random number generator **/
diff --git a/themes/high_contrast_theme.php b/themes/high_contrast_theme.php
index b82160ea..6905c3b6 100644
--- a/themes/high_contrast_theme.php
+++ b/themes/high_contrast_theme.php
@@ -2,15 +2,16 @@
 
 /**
  * high_contrast_theme.php
- *    Name:    High Contrast
- *    Author:  Casey A. Peel
- *    Date:    July 13, 2000
- *    Comment: 
+ * Name:    High Contrast
+ * @author Casey A. Peel
+ * Date:    July 13, 2000
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/ice_theme.php b/themes/ice_theme.php
index f8f0601f..4c092781 100644
--- a/themes/ice_theme.php
+++ b/themes/ice_theme.php
@@ -2,15 +2,16 @@
 
 /**
  * ice_theme.php
- *    Name:    Ice Theme
- *    Author:  Luke Ehresman
- *    Date:    January 7 2000
- *    Comment: 
+ * Name:    Ice Theme
+ * @author Luke Ehresman
+ * Date:    January 7 2000
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/in_the_pink.php b/themes/in_the_pink.php
index 14b4aafe..9254ec6e 100755
--- a/themes/in_the_pink.php
+++ b/themes/in_the_pink.php
@@ -2,16 +2,18 @@
 
 /**
  * in_the_pink.php
- *    Name:    In the Pink
- *    Author:  Jorey Bump
- *    Date:    October 20, 2001
- *    Comment: This theme generates random colors, featuring a reddish
- *             background with dark text.
+ * Name:    In the Pink
+ * @author Jorey Bump
+ * Date:    October 20, 2001
+ * Comment: This theme generates random colors, featuring a reddish
+ *          background with dark text.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 /* seed the random number generator */
diff --git a/themes/kind_of_blue.php b/themes/kind_of_blue.php
index c1afdcbe..99c8e523 100755
--- a/themes/kind_of_blue.php
+++ b/themes/kind_of_blue.php
@@ -2,19 +2,21 @@
 
 /**
  * kind_of_blue.php
- *    Name:    Kind of Blue
- *    Author:  Jorey Bump
- *    Date:    October 20, 2001
- *    Comment: This theme generates random colors, featuring a
- *             light bluish background with dark text.
+ * Name:    Kind of Blue
+ * @author Jorey Bump
+ * Date:    October 20, 2001
+ * Comment: This theme generates random colors, featuring a
+ *          light bluish background with dark text.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
    
-/* seed the random number generator */
+/** seed the random number generator */
 sq_mt_randomize();
 
 for ($i = 0; $i <= 15; $i++) {
diff --git a/themes/maize_theme.php b/themes/maize_theme.php
index 4a110182..00532098 100644
--- a/themes/maize_theme.php
+++ b/themes/maize_theme.php
@@ -2,21 +2,23 @@
 
 /**
  * maize_theme.php
- *    Name:    Maize
- *    Author:  Ray Black
- *    Date:    August 15, 2000
- *    Comment: Staying with the 'South of the border food' theme,
- *              Staying with the 'South of the border food' theme,
- *              I bring you Maize to accompany Black Bean Burrito.
- *              As the Furbies say: Yum! Oh, message highlighting
- *              looks best with colors in the neighborhood of
- *              #7A6A50, bumping up the red, green and blue where
- *              necessary.
+ * Name:    Maize
+ * @author Ray Black
+ * Date:    August 15, 2000
+ * Comment: Staying with the 'South of the border food' theme,
+ *          Staying with the 'South of the border food' theme,
+ *          I bring you Maize to accompany Black Bean Burrito.
+ *          As the Furbies say: Yum! Oh, message highlighting
+ *          looks best with colors in the neighborhood of
+ *          #7A6A50, bumping up the red, green and blue where
+ *          necessary.
  *             
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/methodical_theme.php b/themes/methodical_theme.php
index 554459a4..b9666aa5 100644
--- a/themes/methodical_theme.php
+++ b/themes/methodical_theme.php
@@ -2,17 +2,19 @@
 
 /**
  * methodical_theme.php
- *    Name:    Methodical
- *    Author:  Ray Black III
- *    Date:    November 19, 2001
- *    Comment: Methodical is a theme that's based on the dompie theme,
- *             but expands the blue across the entire page, and modifies
- *             some of the gray backgrounds.
+ * Name:    Methodical
+ * @author Ray Black III
+ * Date:    November 19, 2001
+ * Comment: Methodical is a theme that's based on the dompie theme,
+ *          but expands the blue across the entire page, and modifies
+ *          some of the gray backgrounds.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/midnight.php b/themes/midnight.php
index 669951be..404d3376 100644
--- a/themes/midnight.php
+++ b/themes/midnight.php
@@ -2,15 +2,17 @@
 
 /**
  * midnight.php
- *    Name:   Midnight
- *    Author: Jim Riffle
- *    Date:   November 14, 2001
- *    Comment: A popular theme with Jim's users
+ * Name:   Midnight
+ * @author Jim Riffle
+ * Date:   November 14, 2001
+ * Comment: A popular theme with Jim's users
  *
  * Copyright (c) 2001-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/minimal_bw.php b/themes/minimal_bw.php
index cd69e1e9..1c830bdd 100644
--- a/themes/minimal_bw.php
+++ b/themes/minimal_bw.php
@@ -1,12 +1,15 @@
 <?php
-   /** Author:       Tomas Kuliavas
-       Date:         July 26, 2003
-       Theme Name:   'Minimal BW Theme'
-    
-    This theme uses black color for text and white for background.
-    
-    Problem: $color[9] is used for background and for disabled links.
-    **/
+/**
+ * @author Tomas Kuliavas
+ * Date:         July 26, 2003
+ * Theme Name:   'Minimal BW Theme'
+ *    
+ * This theme uses black color for text and white for background.
+ * 
+ * Problem: $color[9] is used for background and for disabled links.
+ * @package squirrelmail
+ * @subpackage themes
+ */
 
     global $color;
     $color[0]   = '#FFFFFF'; // (white)   TitleBar
diff --git a/themes/monostochastic.php b/themes/monostochastic.php
index 35a5629a..1dba5953 100755
--- a/themes/monostochastic.php
+++ b/themes/monostochastic.php
@@ -2,19 +2,21 @@
 
 /**
  * monostochastic.php
- *    Name:    Monostochastic
- *    Author:  Jorey Bump
- *    Date:    October 20, 2001
- *    Comment: Generates random two-color frames, featuring either
- *             a dark or light background.
+ * Name:    Monostochastic
+ * @author Jorey Bump
+ * Date:    October 20, 2001
+ * Comment: Generates random two-color frames, featuring either
+ *          a dark or light background.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
-/* seed the random number generator */
+/** seed the random number generator */
 sq_mt_randomize();
 
 /** light(1) or dark(0) background toggle **/
diff --git a/themes/penguin.php b/themes/penguin.php
index 1c2894f4..b47eaee9 100644
--- a/themes/penguin.php
+++ b/themes/penguin.php
@@ -2,16 +2,18 @@
  
 /**
  * penguin.php
- *    Name:    Penguin
- *    Author:  Peter J. Vasquez Sr.
- *    Date:    Jult 25, 2002
- *    Comment: This theme is my attempt at using the colors of the
- *             ever-popular Linux penguin.  :)
+ * Name:    Penguin
+ * @author Peter J. Vasquez Sr.
+ * Date:    Jult 25, 2002
+ * Comment: This theme is my attempt at using the colors of the
+ *          ever-popular Linux penguin.  :)
  *
  * Copyright (c) 2001-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 $color[0]   = '#FFCC00'; // b  0: Title Bar at the top of the page header
diff --git a/themes/plain_blue_theme.php b/themes/plain_blue_theme.php
index 79713161..27189b8b 100644
--- a/themes/plain_blue_theme.php
+++ b/themes/plain_blue_theme.php
@@ -1,16 +1,16 @@
 <?php
 
 /**
- * plain_blue_theme.php
- *    Name:    Plain Blue
- *    Author:  Luke Ehresman
- *    Date:    April 30, 2000
- *    Comment: 
+ * Name: Plain Blue
+ * @author Luke Ehresman
+ * Date: April 30, 2000
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/purple_theme.php b/themes/purple_theme.php
index cfcea5fd..429a8b54 100644
--- a/themes/purple_theme.php
+++ b/themes/purple_theme.php
@@ -1,16 +1,17 @@
 <?php
 
 /**
- * purple_theme.php
- *    Name:    Purple Theme
- *    Author:  Luke Ehresman
- *    Date:    January 7, 2000
- *    Comment: This Theme is composed entirely of shades of purple.
+ * Name:   Purple Theme
+ * @author Luke Ehresman
+ * Date:   January 7, 2000
+ * Comment This Theme is composed entirely of shades of purple.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
@@ -28,4 +29,4 @@ $color[10]  = '#726987'; // (dark purp)      Darker version of #9
 $color[11]  = '#770000'; // (dark red)       Special Folders color
 $color[12]  = '#E0D9F2';
 
-?>
\ No newline at end of file
+?>
diff --git a/themes/random.php b/themes/random.php
index b6af679b..aee02320 100755
--- a/themes/random.php
+++ b/themes/random.php
@@ -1,18 +1,20 @@
 <?php
 
 /**
- * random.php
- *    Name:    Random Theme Every Login
- *    Author:  Tyler Akins
- *    Date:    December 24, 2001
- *    Comment: Guess what this does!
+ * Name:    Random Theme Every Login
+ * @author  Tyler Akins
+ * Date:    December 24, 2001
+ * Comment: Guess what this does!
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmai
+ * @subpackage themes
  */
 
+/** Initialize the random number generator */
 sq_mt_randomize();
 
 require_once(SM_PATH . 'functions/global.php');
diff --git a/themes/sandstorm_theme.php b/themes/sandstorm_theme.php
index b06e9b5f..494b07be 100644
--- a/themes/sandstorm_theme.php
+++ b/themes/sandstorm_theme.php
@@ -1,16 +1,17 @@
 <?php
 
 /**
- * sandstorm_theme.php
- *    Name:    Sand Storm
- *    Author:  Luke Ehresman
- *    Date:    January 2, 2000
- *    Comment: This is a theme using Tan as its main color.
+ * Name:    Sand Storm
+ * @author  Luke Ehresman
+ * Date:    January 2, 2000
+ * Comment: This is a theme using Tan as its main color.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/seaspray_theme.php b/themes/seaspray_theme.php
index f82e3528..8bf555ab 100644
--- a/themes/seaspray_theme.php
+++ b/themes/seaspray_theme.php
@@ -1,16 +1,16 @@
 <?php
 
 /**
- * seaspray_theme.php
- *    Name:    Sea Spray Theme
- *    Author:  Luke Ehresman
- *    Date:    March 3, 2000
- *    Comment: 
+ * Name:    Sea Spray Theme
+ * @author  Luke Ehresman
+ * Date:    March 3, 2000
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/servery_theme.php b/themes/servery_theme.php
index 264ec54b..8c0577a3 100644
--- a/themes/servery_theme.php
+++ b/themes/servery_theme.php
@@ -1,16 +1,16 @@
 <?php
 
 /**
- * servery_theme.php
- *    Name:    Servery.cz Theme
- *    Author:  Ondrej Sury <ondrej@globe.cz>
- *    Date:    August 18, 2000
- *    Comment: 
+ * Name:   Servery.cz Theme
+ * @author Ondrej Sury <ondrej@globe.cz>
+ * Date:   August 18, 2000
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/shades_of_grey.php b/themes/shades_of_grey.php
index 57dab01a..abc1b3d5 100755
--- a/themes/shades_of_grey.php
+++ b/themes/shades_of_grey.php
@@ -1,20 +1,21 @@
 <?php
 
 /**
- * shades_of_grey.php
- *    Name:    Shades of Grey
- *    Author:  Jorey Bump
- *    Date:    October 20, 2001
- *    Comment: This theme generates random colors, featuring a
- *             light greyish background with dark text.
+ * Name:   Shades of Grey
+ * @author Jorey Bump
+ * Date:   October 20, 2001
+ * Comment This theme generates random colors, featuring a
+ *         light greyish background with dark text.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
-/* seed the random number generator */
+/** seed the random number generator */
 sq_mt_randomize();
 
 for ($i = 0; $i <= 15; $i++) {
diff --git a/themes/slashdot_theme.php b/themes/slashdot_theme.php
index 3d91be08..6fe409fc 100644
--- a/themes/slashdot_theme.php
+++ b/themes/slashdot_theme.php
@@ -1,17 +1,18 @@
 <?php
 
 /**
- * slashdot_theme.php
- *    Name:    Slashdot Theme
- *    Author:  Luke Ehresman
- *    Date:    January 3, 2000
- *    Comment: This theme tries to mimic the color scheme from the
- *             "News for Nerds" web site, www.slashdot.org.
+ * Name:   Slashdot Theme
+ * @author Luke Ehresman
+ * Date:   January 3, 2000
+ * Comment This theme tries to mimic the color scheme from the
+ *         "News for Nerds" web site, www.slashdot.org.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 global $color;
diff --git a/themes/spice_of_life.php b/themes/spice_of_life.php
index a25d2e4f..eca95f3b 100755
--- a/themes/spice_of_life.php
+++ b/themes/spice_of_life.php
@@ -1,17 +1,18 @@
 <?php
 
 /**
- * spice_of_life.php
- *    Name:    Spice of Life
- *    Author:  Jorey Bump
- *    Date:    October 20, 2001
- *    Comment: Generates random colors for each frame,
- *             featuring either a dark or light background.
+ * Name:   Spice of Life
+ * @author Jorey Bump
+ * Date:   October 20, 2001
+ * Comment Generates random colors for each frame,
+ *         featuring either a dark or light background.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 /** seed the random number generator **/
diff --git a/themes/spice_of_life_dark.php b/themes/spice_of_life_dark.php
index 36c64553..e4919a95 100755
--- a/themes/spice_of_life_dark.php
+++ b/themes/spice_of_life_dark.php
@@ -1,17 +1,18 @@
 <?php
 
 /**
- * spice_of_life_dark.php
- *    Name:    Spice of Life - Dark
- *    Author:  Jorey Bump
- *    Date:    October 20, 2001
- *    Comment: This theme generates random colors,
- *             featuring a dark background with light text.
+ * Name:   Spice of Life - Dark
+ * @author Jorey Bump
+ * Date:   October 20, 2001
+ * Comment This theme generates random colors,
+ *         featuring a dark background with light text.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmail
+ * @subpackage themes
  */
 
 /** seed the random number generator **/
diff --git a/themes/spice_of_life_lite.php b/themes/spice_of_life_lite.php
index 5d86209d..11f1523a 100755
--- a/themes/spice_of_life_lite.php
+++ b/themes/spice_of_life_lite.php
@@ -1,17 +1,18 @@
 <?php
 
 /**
- * spice_of_life_lite.php
- *    Name:    Spice of Life - Lite
- *    Author:  Jorey Bump
- *    Date:    October 20, 2001
- *    Comment: This theme generates random colors, featuring a
- *             lite background with dark text.
+ * Name:   Spice of Life - Lite
+ * @author Jorey Bump
+ * Date:   October 20, 2001
+ * Comment This theme generates random colors, featuring a
+ *         lite background with dark text.
  *
  * Copyright (c) 2000-2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * $Id$
+ * @package squirrelmai
+ * @subpackage themes
  */
 
 /** seed the random number generator **/
-- 
2.25.1