phpdoc
authorMichael M Slusarz <slusarz@curecanti.org>
Tue, 18 Jan 2011 06:02:38 +0000 (23:02 -0700)
committerMichael M Slusarz <slusarz@curecanti.org>
Tue, 18 Jan 2011 06:25:59 +0000 (23:25 -0700)
framework/Mime_Viewer/lib/Horde/Mime/Viewer/Base.php
horde/lib/LoginTasks/SystemTask/GarbageCollection.php

index 9f95498..6044e02 100644 (file)
@@ -67,15 +67,15 @@ class Horde_Mime_Viewer_Base
      *
      * @param Horde_Mime_Part $mime_part  The object with the data to be
      *                                    rendered.
-     * @param array $conf
-     *     Configuration:
-     *     - 'temp_file': (callback) A callback function that returns a
-     *                    temporary filename.  Is passed one parameter: a
-     *                     prefix string. DEFAULT: Uses
-     *                     Horde_Util::getTempFile().
-     *     - 'text_filter': (callback) A callback function used to filter text.
-     *                      Is called the same as Horde_Text_Filter::filter().
-     *                      DEFAULT: Uses Horde_Text_Filter::filter().
+     * @param array $conf                 Configuration:
+     * <pre>
+     * temp_file - (callback) A callback function that returns a temporary
+     *             filename.  Is passed one parameter: a prefix string.
+     *             DEFAULT: Uses Horde_Util::getTempFile().
+     * text_filter - (callback) A callback function used to filter text. Is
+     *               called the same as Horde_Text_Filter::filter().
+     *               DEFAULT: Uses Horde_Text_Filter::filter().
+     * </pre>
      *
      * @throws InvalidArgumentException
      */
@@ -177,7 +177,8 @@ class Horde_Mime_Viewer_Base
     }
 
     /**
-     * Return the full rendered version of the Horde_Mime_Part object.
+     * Return the full HTML rendered version of the Horde_Mime_Part object.
+     * This MUST be text/html data.
      *
      * @return array  See render().
      * @throws Horde_Exception
@@ -192,6 +193,9 @@ class Horde_Mime_Viewer_Base
 
     /**
      * Return the rendered inline version of the Horde_Mime_Part object.
+     * This MUST be text/html data.
+     * This is not a full HTML document - only the HTML necessary to output
+     * the part.
      *
      * @return array  See render().
      * @throws Horde_Exception
@@ -219,7 +223,7 @@ class Horde_Mime_Viewer_Base
     }
 
     /**
-     * Return the rendered information about the Horde_Mime_Part object.
+     * Return the raw representation of the Horde_Mime_Part object.
      *
      * @return array  See render().
      * @throws Horde_Exception
index f90af08..5f74fae 100644 (file)
@@ -7,8 +7,10 @@
  * See the enclosed file COPYING for license information (GPL). If you
  * did not receive this file, see http://www.fsf.org/copyleft/gpl.html.
  *
- * @author  Michael Slusarz <slusarz@horde.org>
- * @package Horde_LoginTasks
+ * @author   Michael Slusarz <slusarz@horde.org>
+ * @category Horde
+ * @license  http://www.fsf.org/copyleft/gpl.html GPL
+ * @package  Horde
  */
 class Horde_LoginTasks_SystemTask_GarbageCollection extends Horde_LoginTasks_SystemTask
 {