The former contain a codemap (which is per-crate), and the latter don't. This will be useful in order to allow more than one crate to be compiled in one run of the compiler.
If the first paragraph of documentation is short then it will be used as the brief description.
Closes #1595. Thanks to mikesamuel.
…al changes, though FIXMEs added)