Docbloc mundanery *done*

This cleans up "errors" as documentor will claim them.   Some are simple moving of text so the documentor finds it, others were missing doc blocks or missing / extra params, You know the drill.

This is the admin controllers, up next, controllers, and subs, etc ... just 900 errors to go :palm_tree: :beers: 
Added a few more files to the mix, now just 830 errors to go !
Moar done ... just a piddly 734 left in subs + database :dancers: 
Pausing for the night ... 631 errors to go (in the sources tree)
Another pause ... now below 500 to go ! / 390 to go !

Done all I'm gonna do on this !  ... 
There is one file I did not update as I ran out of energy .. its VerificationControls.class and it has quite a few missing docblocks so if someone has the will to go through that file and document all those functions, well that would be the sauce!