Phpdoc structure

laid out the basic phpdoc structure, no functional changes;