Documentation fixed to src/rustdoc/README.md and debuginfo.rs

Changed the sample command in the Rustdoc readme to use --output instead of the outdated --output-dir 

Fixed markdown formatting of section headers in debuginfo.rs