This also changes some comments into doc-comments.
For more information about how rustc works, see the rustc dev guide.