[binarycloud-dev] $PACKAGE -> @package

[<bin...@li...>]

hi all,

Looking at pear and phpdoc's standards, packages are declared in a somewhat
different fashion than how we're doing it, and I like theirs better:

we have 

$PACKAGE="binarycloud.core";

which pollutes the global namespace and is sort of kludgey...

instead, I'd like to use:

Over every class title:

/**
 * Class Title
 *    
 * Functional Description
 *
 * @access public
 * @version $Revision:$
 * @package binarycloud.core
 */

so, pk2dir.pl would need to be changed (of course along with all those core
classes).. so it sees @package and parses the string next to it.

this has the distinct advantage of clarity, and compatibility with phpdoc
and pear.

I'll make the header changes tomorrow, as they're obviously not difficult to
do.

_alex