- added and fixed docblocks
- along the way, fixed two minor typos
Merged revisions d74dbb6d2921bc9c5a49a93b83e73570742f87a6 via svnmerge from 
http://svn.agavi.org/branches/dominik-validation-argument-sources