phpdoc
authorMichael M Slusarz <slusarz@curecanti.org>
Wed, 10 Nov 2010 17:38:03 +0000 (10:38 -0700)
committerMichael M Slusarz <slusarz@curecanti.org>
Thu, 11 Nov 2010 16:11:52 +0000 (09:11 -0700)
18 files changed:
imp/lib/Mailbox/List.php
imp/lib/Search/Element/Bulk.php
imp/lib/Search/Element/Date.php
imp/lib/Search/Element/Flag.php
imp/lib/Search/Element/Header.php
imp/lib/Search/Element/Mailinglist.php
imp/lib/Search/Element/Or.php
imp/lib/Search/Element/Personal.php
imp/lib/Search/Element/Recipient.php
imp/lib/Search/Element/Size.php
imp/lib/Search/Element/Text.php
imp/lib/Search/Element/Within.php
imp/lib/Search/Filter.php
imp/lib/Search/Filter/Builtin.php
imp/lib/Search/Filter/Bulk.php
imp/lib/Search/Filter/Mailinglist.php
imp/lib/Search/Filter/Personal.php
imp/lib/Search/Query.php

index b4062d7..6570a4d 100644 (file)
@@ -93,34 +93,30 @@ class IMP_Mailbox_List implements Countable, Serializable
      *                     If 2, forces addition of preview info.
      *                     DEFAULT: No preview information.
      * 'structure' - (boolean) Get structure information from server.
-     *               Contained in the 'strucutre' entry.
+     *               Contained in the 'structure' entry.
      *               DEFAULT: false
      * </pre>
      *
      * @return array  An array with the following keys:
      * <pre>
-     * 'overview' - (array) The overview information. Contains the following:
-     *              'envelope' - (array) Envelope information returned from
-     *                           the IMAP server. See
-     *                           Horde_Imap_Client::fetch() for format.
-     *              'flags' - (array) The list of IMAP flags returned from
-     *                        the server. See Horde_Imap_Client::fetch() for
-     *                        the format.
-     *              'headers' - (array) Any headers requested in
-     *                          $options['headers']. Horde_Mime_Headers objects
-     *                          are returned.  See Horde_Imap_Client::fetch()
-     *                          for the format.
-     *              'mailbox' - (string) The mailbox containing the message.
-     *              'preview' - (string) If requested in $options['preview'],
-     *                          the preview text.
-     *              'previewcut'- (boolean) Has the preview text been cut?
-     *              'size' - (integer) The size of the message in bytes.
-     *              'structure'- (array) The structure of the message. Only
-     *                           set if $options['structure'] is true. See
-     *                           Horde_Imap_Client::fetch() for format.
-     *              'uid' - (string) The unique ID of the message.
-     *
-     * 'uids' - (IMP_Indices) An indices object.
+     * overview - (array) The overview information. Contains the following:
+     *     envelope - (array) Envelope information returned from the IMAP
+     *                server. See Horde_Imap_Client::fetch() for format.
+     *     flags - (array) The list of IMAP flags returned from the server.
+     *             See Horde_Imap_Client::fetch() for the format.
+     *     headers - (array) Any headers requested in $options['headers'].
+     *               Horde_Mime_Headers objects are returned.  See
+     *               Horde_Imap_Client::fetch() for the format.
+     *     mailbox - (string) The mailbox containing the message.
+     *     preview - (string) If requested in $options['preview'], the preview
+     *               text.
+     *     previewcut - (boolean) Has the preview text been cut?
+     *     size - (integer) The size of the message in bytes.
+     *     structure - (array) The structure of the message. Only set if
+     *                 $options['structure'] is true. See
+     *                 Horde_Imap_Client::fetch() for format.
+     *     uid - (string) The unique ID of the message.
+     * uids - (IMP_Indices) An indices object.
      * </pre>
      */
     public function getMailboxArray($msgnum, $options = array())
index d913c3b..b51d7eb 100644 (file)
@@ -30,11 +30,6 @@ class IMP_Search_Element_Bulk extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -44,9 +39,6 @@ class IMP_Search_Element_Bulk extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index a9e74bf..ab3b0e0 100644 (file)
@@ -41,11 +41,6 @@ class IMP_Search_Element_Date extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -56,9 +51,6 @@ class IMP_Search_Element_Date extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index f2454ef..0be7a42 100644 (file)
@@ -40,11 +40,6 @@ class IMP_Search_Element_Flag extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -54,9 +49,6 @@ class IMP_Search_Element_Flag extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index 33d9b8a..e796b29 100644 (file)
@@ -34,11 +34,6 @@ class IMP_Search_Element_Header extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -48,9 +43,6 @@ class IMP_Search_Element_Header extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index f205b6e..e58f343 100644 (file)
@@ -29,11 +29,6 @@ class IMP_Search_Element_Mailinglist extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -43,9 +38,6 @@ class IMP_Search_Element_Mailinglist extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index bd17ad2..3ded706 100644 (file)
 class IMP_Search_Element_Or extends IMP_Search_Element
 {
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
-     *
      */
     public function createQuery($queryob)
     {
@@ -31,9 +25,6 @@ class IMP_Search_Element_Or extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index 62c6c9f..ba0c6c9 100644 (file)
@@ -29,11 +29,6 @@ class IMP_Search_Element_Personal extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -60,9 +55,6 @@ class IMP_Search_Element_Personal extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index 7f1132c..219a089 100644 (file)
@@ -31,11 +31,6 @@ class IMP_Search_Element_Recipient extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -59,9 +54,6 @@ class IMP_Search_Element_Recipient extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index 41f67f5..9023dfa 100644 (file)
@@ -38,11 +38,6 @@ class IMP_Search_Element_Size extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -52,9 +47,6 @@ class IMP_Search_Element_Size extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index 58b9e46..d93ad63 100644 (file)
@@ -35,11 +35,6 @@ class IMP_Search_Element_Text extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -49,9 +44,6 @@ class IMP_Search_Element_Text extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index 771efaa..2986eb3 100644 (file)
@@ -44,11 +44,6 @@ class IMP_Search_Element_Within extends IMP_Search_Element
     }
 
     /**
-     * Adds the current query item to the query object.
-     *
-     * @param Horde_Imap_Client_Search_Query  The query object.
-     *
-     * @return Horde_Imap_Client_Search_Query  The query object.
      */
     public function createQuery($queryob)
     {
@@ -71,9 +66,6 @@ class IMP_Search_Element_Within extends IMP_Search_Element
     }
 
     /**
-     * Return search query text representation.
-     *
-     * @return array  The textual description of this search element.
      */
     public function queryText()
     {
index c8a5b93..81a032b 100644 (file)
@@ -15,9 +15,6 @@
 class IMP_Search_Filter extends IMP_Search_Query
 {
     /**
-     * Get object properties.
-     *
-     * @see __get()
      */
     public function __get($name)
     {
index 4cb799b..1a56933 100644 (file)
 abstract class IMP_Search_Filter_Builtin extends IMP_Search_Filter
 {
     /**
-     * Can this query be edited?
-     *
-     * @var boolean
      */
     protected $_canEdit = false;
 
     /**
-     * List of serialize entries not to save.
-     *
-     * @var array
      */
     protected $_nosave = array('c', 'i', 'l');
 
@@ -43,16 +37,10 @@ abstract class IMP_Search_Filter_Builtin extends IMP_Search_Filter
     }
 
     /**
-     * Initialization tasks.
      */
     abstract protected function _init();
 
     /**
-     * Unserialization.
-     *
-     * @param string $data  Serialized data.
-     *
-     * @throws Exception
      */
     public function unserialize($data)
     {
index 098b890..6c29b93 100644 (file)
@@ -15,7 +15,6 @@
 class IMP_Search_Filter_Bulk extends IMP_Search_Filter_Builtin
 {
     /**
-     * Initialization tasks.
      */
     protected function _init()
     {
index 3fc936a..942204a 100644 (file)
@@ -15,7 +15,6 @@
 class IMP_Search_Filter_Mailinglist extends IMP_Search_Filter_Builtin
 {
     /**
-     * Initialization tasks.
      */
     protected function _init()
     {
index 6549b9c..2dca380 100644 (file)
@@ -15,7 +15,6 @@
 class IMP_Search_Filter_Personal extends IMP_Search_Filter_Builtin
 {
     /**
-     * Initialization tasks.
      */
     protected function _init()
     {
index d36c0ad..3f4f12c 100644 (file)
@@ -111,13 +111,13 @@ class IMP_Search_Query implements Serializable
      *
      * @param string $name  Available properties:
      * <pre>
-     * 'canEdit' - (boolean)
-     * 'id' - (string)
-     * 'label' - (string)
-     * 'mboxes' - (array)
-     * 'mid' - (string)
-     * 'query' - (Horde_Imap_Client_Search_Query)
-     * 'querytext' - (string)
+     * 'canEdit' - (boolean) Can this query be edited?
+     * 'id' - (string) The query ID.
+     * 'label' - (string) The query label.
+     * 'mboxes' - (array) The list of mailboxes to query.
+     * 'mid' - (string) The query ID with the search mailbox prefix.
+     * 'query' - (Horde_Imap_Client_Search_Query) The IMAP query object.
+     * 'querytext' - (string) The textual representation of the query.
      * </pre>
      *
      * @return mixed  Property value.