/**
 * @file
 *
 * Short description for file.
 *
 * Long description for file (if any)...
 *
 * @ingroup    GroupName
 * @author     Original Author <author@example.com>
 * @author     Another Author <another@example.com>
 * @copyright  1997-2005 Supernerd, LLC and Contributors
 * @license    http://www.gnu.org/copyleft/gpl.html  GPL License 2 or later
 * @version    CVS: $Id:$
 * @link       http://www.zoopframework.com/
 * @see        zoop::zoop
 * @since      File available since Release 1.2.0
 * @deprecated File deprecated in Release 2.0.0
 */
 
/*
 * Place includes, constant defines and $_GLOBAL settings here.
 * Make sure they have appropriate docblocks to avoid phpDocumentor
 * construing they are documented by the page-level docblock.
 */
 
/**
 * Short description for class.
 *
 * Long description for class (if any)...
 *
 * @ingroup    GroupName
 * @ingroup    AnotherGroup
 * @author     Original Author <author@example.com>
 * @author     Another Author <another@example.com>
 * @copyright  1997-2005 Supernerd, LLC and Contributors
 * @license    http://www.gnu.org/copyleft/gpl.html  GPL License 2 or later
 * @version    CVS: $Id:$
 * @link       http://www.zoopframework.com
 * @see        zoop, zoop::zoop()
 * @since      Class available since Release 1.2.0
 * @deprecated Class deprecated in Release 2.0.0
 */
class foo {
 
    /**
     * Brief method description.
     *
     * Extended description for method (if any)...
     * 
     * @code
     *   //code examples can be added with @ code blocks
     *   $var = fooFunction($arg);
     * @endcode
     *
     * @param mixed $arg1 Argument 1 description.
     * @param mixed $arg3 Argument 2 short description.
     *   Extended description for Argument 2. Perhaps talk about the default value?
     * @access public
     * @return mixed Return value description.
     *   Can also have an extended definition.
     */
    function fooFunction($arg1, $arg2 = 'default') {
        if (condition) {
            statement;
        }
        return $val;
    }
}