phpdocumentor basic preparation, continued
authortassium <tassium@7612ce4b-ef26-0410-bec9-ea0150e637f0>
Tue, 28 Oct 2003 21:30:57 +0000 (21:30 +0000)
committertassium <tassium@7612ce4b-ef26-0410-bec9-ea0150e637f0>
Tue, 28 Oct 2003 21:30:57 +0000 (21:30 +0000)
git-svn-id: https://svn.code.sf.net/p/squirrelmail/code/trunk/squirrelmail@6041 7612ce4b-ef26-0410-bec9-ea0150e637f0

23 files changed:
class/deliver/Deliver.class.php
class/deliver/Deliver_IMAP.class.php
class/deliver/Deliver_SMTP.class.php
class/deliver/Deliver_SendMail.class.php
class/helper/VCard.class.php
class/html.class.php
class/index.php
class/mime.class.php
class/mime/AddressStructure.class.php
class/mime/ContentType.class.php
class/mime/Disposition.class.php
class/mime/Language.class.php
class/mime/Message.class.php
class/mime/MessageHeader.class.php
class/mime/Rfc822Header.class.php
class/mime/SMimeMessage.class.php
include/load_prefs.php
include/options/display.php
include/options/folder.php
include/options/personal.php
include/validate.php
plugins/mail_fetch/class.POP3.php
src/download.php

index cc7f3e4..190c576 100644 (file)
@@ -14,7 +14,6 @@
  * @package squirrelmail
  */
 
-
 /**
  * Deliver Class - called to actually deliver the message
  *
@@ -676,4 +675,4 @@ class Deliver {
         return $refer;
     }
 }
-?>
\ No newline at end of file
+?>
index 84f5d4b..83b8252 100644 (file)
@@ -8,10 +8,17 @@
  * Delivery backend for the Deliver class.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/** This of course depends upon Deliver.. */
+
 require_once(SM_PATH . 'class/deliver/Deliver.class.php');
 
+/**
+ * This class is incomplete and entirely undocumented.
+ * @package squirrelmail
+ */
 class Deliver_IMAP extends Deliver {
 
     function getBcc() {
index 19b3066..13f9b0b 100644 (file)
@@ -8,10 +8,16 @@
  * Delivery backend for the Deliver class.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/** This of course depends upon Deliver */
 require_once(SM_PATH . 'class/deliver/Deliver.class.php');
 
+/**
+ * Deliver messages using SMTP
+ * @package squirrelmail
+ */
 class Deliver_SMTP extends Deliver {
 
     function preWriteToStream(&$s) {
index d5c6fdb..20d2053 100644 (file)
@@ -8,10 +8,16 @@
  * Delivery backend for the Deliver class.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/** This of course depends upon Deliver */
 require_once(SM_PATH . 'class/deliver/Deliver.class.php');
 
+/**
+ * Delivers messages using the sendmail binary
+ * @package squirrelmail
+ */
 class Deliver_SendMail extends Deliver {
 
     function preWriteToStream(&$s) {
index 29fb896..cf369bf 100644 (file)
  * http://www.imc.org/pdi/vcard-21.txt
  *
  * $Id$
+ * @package squirrelmail
  */
 
-
+/**
+ * Undocumented class
+ * @package squirrelmail
+ */
 class VCard {
 
 function create_vcard ($value_array) {
index faa9b3c..93fbdf3 100644 (file)
@@ -8,8 +8,13 @@
  * This contains functions needed to generate html output.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/**
+ * This class needs documenting - volunteers?
+ * @package squirrelmail
+ */
 class html {
   var $tag, $text, $style, $class,  
       $id, $html_el = array(), $javascript, $xtr_prop;
index 269f898..68a0498 100644 (file)
@@ -11,6 +11,7 @@
  * the person is logged or not.
  *
  * $Id$
+ * @package squirrelmail
  */
 
 header("Location:../index.php");
index b4a4555..2e70650 100644 (file)
@@ -9,8 +9,10 @@
  * This contains functions needed to handle mime messages.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/** Load in the entire MIME system */
 require_once(SM_PATH . 'class/mime/Rfc822Header.class.php');
 require_once(SM_PATH . 'class/mime/MessageHeader.class.php');
 require_once(SM_PATH . 'class/mime/AddressStructure.class.php');
index 91e04e2..62e5049 100644 (file)
@@ -9,8 +9,13 @@
  * This contains functions needed to handle mime messages.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/**
+ * Undocumented class
+ * @package squirrelmail
+ */
 class AddressStructure {
     var $personal = '',
         $adl      = '',
index 85f24ab..cadb5d4 100644 (file)
@@ -9,8 +9,13 @@
  * This contains functions needed to handle mime messages.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/**
+ * Undocumented class
+ * @package squirrelmail
+ */
 class ContentType {
     var $type0      = 'text',
         $type1      = 'plain',
index e69dae8..10da401 100644 (file)
@@ -9,8 +9,13 @@
  * This contains functions needed to handle mime messages.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/**
+ * Undocumented class
+ * @package squirrelmail
+ */
 class Disposition {
     function Disposition($name) {
        $this->name = $name;
index 3b90118..0105106 100644 (file)
@@ -9,8 +9,13 @@
  * This contains functions needed to handle mime messages.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/**
+ * Undocumented class
+ * @package squirrelmail
+ */
 class Language {
     function Language($name) {
        $this->name = $name;
index 1480534..dc2b3da 100644 (file)
@@ -6,17 +6,22 @@
  * Copyright (c) 2003 The SquirrelMail Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
-  This contains functions needed to handle mime messages.
* This contains functions needed to handle mime messages.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/**
+ * The object that contains a message
+ *
+ * message is the object that contains messages.  It is a recursive
+ * object in that through the $entities variable, it can contain
+ * more objects of type message.  See documentation in mime.txt for
+ * a better description of how this works.
+ * @package squirrelmail
+ */
 class Message {
-    /** message is the object that contains messages.  It is a recursive
-        object in that through the $entities variable, it can contain
-        more objects of type message.  See documentation in mime.txt for
-        a better description of how this works.
-    **/
     var $rfc822_header = '',
         $mime_header = '',
         $flags = '',
index 2dc4cdb..e0dacf3 100644 (file)
@@ -9,8 +9,13 @@
  * This contains functions needed to handle mime messages.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/**
+ * Contains all variables available in a bodystructure 
+ * @package squirrelmail
+ */
 class MessageHeader {
     /** msg_header contains all variables available in a bodystructure **/
     /** entity like described in rfc2060                               **/
index 6cefdb1..d459fb5 100644 (file)
@@ -9,11 +9,12 @@
  * This contains functions needed to handle mime messages.
  *
  * $Id$
+ * @package squirrelmail
  */
 
-/*
- * rdc822_header class
+/**
  * input: header_string or array
+ * @package squirrelmail
  */
 class Rfc822Header {
     var $date = '',
index e6d4455..6689c2b 100644 (file)
@@ -9,8 +9,13 @@
  * This contains functions needed to handle mime messages.
  *
  * $Id$
+ * @package squirrelmail
  */
 
+/**
+ * Incomplete class, undocumented.
+ * @package squirrelmail
+ */
 class SMimeMessage {
 
 }
index 9f4038d..a565873 100644 (file)
  * every other script in the source directory and alswhere.
  *
  * $Id$
+ * @package squirrelmail
  */
 
-/* SquirrelMail required files. */
+/** SquirrelMail required files. */
 require_once(SM_PATH . 'include/validate.php');
 require_once(SM_PATH . 'functions/prefs.php');
 require_once(SM_PATH . 'functions/plugin.php');
index cbb3fbe..5a4f820 100644 (file)
@@ -9,9 +9,10 @@
  * Displays all optinos about display preferences
  *
  * $Id$
+ * @package squirrelmail
  */
 
-/* Define the group constants for the display options page. */
+/** Define the group constants for the display options page. */
 define('SMOPT_GRP_GENERAL', 0);
 define('SMOPT_GRP_MAILBOX', 1);
 define('SMOPT_GRP_MESSAGE', 2);
index c72b924..0a7a81d 100644 (file)
@@ -9,9 +9,10 @@
  * Displays all options relating to folders
  *
  * $Id$
+ * @package squirrelmail
  */
 
-/* SquirrelMail required files. */
+/** SquirrelMail required files. */
 require_once(SM_PATH . 'functions/imap.php');
 require_once(SM_PATH . 'functions/imap_general.php');
 
index 26b3793..a15d5ba 100644 (file)
@@ -9,9 +9,10 @@
  * Displays all options relating to personal information
  *
  * $Id$
+ * @package squirrelmail
  */
 
-/* SquirrelMail required files. */
+/** SquirrelMail required files. */
 require_once(SM_PATH . 'functions/imap.php');
 
 /* Define the group constants for the personal options page. */
index 3821345..8738cc3 100644 (file)
@@ -7,9 +7,10 @@
 * Licensed under the GNU GPL. For full terms see the file COPYING.
 *
 * $Id$
+* @package squirrelmail
 */
 
-/* include the mime class before the session start ! otherwise we can't store
+/** include the mime class before the session start ! otherwise we can't store
  * messages with a session_register.
  *
  * From http://www.php.net/manual/en/language.oop.serialization.php:
index 2e2dac4..7305431 100644 (file)
@@ -20,6 +20,7 @@
 
 /**
  * This is the pop3 class - DOCUMENT ME
+ * @package squirrelmail
  */
 class POP3 {
     var $ERROR      = '';       //  Error string.
index b4f3dc1..b14cfd8 100644 (file)
  * Also allows displaying of attachments when possible.
  *
  * $Id$
+ * @package squirrelmail
  */
 
-/* Path for SquirrelMail required files. */
+/** Path for SquirrelMail required files. */
 define('SM_PATH','../');
 
 /* SquirrelMail required files. */
@@ -141,4 +142,4 @@ if (isset($absolute_dl) && $absolute_dl) {
  * attachment in case of ERROR reporting = E_ALL and the output is the screen */
 mime_print_body_lines ($imapConnection, $passed_id, $ent_id, $encoding);
 
-?>
\ No newline at end of file
+?>