Restructured code comments to support doxygen/appledoc tools

Extracted method comment blocks from body files, parsed, and reinserted
as appropriate into the corresponding header file. This exposes the
comments in the expected location for tools such as doxygen and
appledoc.

This process was assisted with the included perl script. I expect some
comments to need attention.