update docblocks
use ## titles instead of underlines; seems to help textmate find headings
add comments
if no data for args, populate from _SERVER
better exception messages