Autogenerated comments for Civi dir

@totten I generated loads of missing php comment blocks & committed them - but I haven't merged this commit because it involves the new code in the civi directory - so I thought I'd get you to eyeball that this is the right format for those comment blocks (this is phpstorm of course)