Update manpage based on current usage message

I've 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.