Some documentation fixes and improvements

I have noticed some errors and some absences that I considered essential to the usability of rustc in zsh, so I included them and updated some of the man page.
I think this is `--debuginfo`.