Update manpage based on current usage message
auto merge of #4940 : hansjorg/rust/manpage_06, r=catamorphism

Updated the rustc manpage based on the usage message for 0.6 (including -Z options). Also added an example showing how to compile with debug info.

This targets incoming rather than master. #4936 can be closed.