If you use `///` rather than `//` for all these comments (including the ones of enum variants and struct fields), then they'll be "doc comments" which are understood by the compiler & the `rustdoc` tool, so that (if we ever use it) `rustdoc` run on these crates will include this text. (After this is fixed, it should be good to go; @mention me on the PR (github doesn't automatically notify about PR updates), or throw a link to this onto #rust-internals.)