Added documentation for the g:syntastic_c_checker option

Continuation of pull request #314

This merely adds documentation for the option on the file. I refrained from renaming the option as to not break other people's workflow (I'm a nice guy like that).