Fix HTML version of the keyword table.

This should really fix rust-lang/rust#17528.
src/doc/README.md: fix a dead link.

Also make some typographical changes.
auto merge of #17968 : nodakai/rust/really-fix-kw-table, r=alexcrichton

Really fix #17528.

Here is the resulting HTML output:

- https://dl.dropboxusercontent.com/u/107479221/reference.html#keywords

["Adjacent sibling selector" `+` was first introduced in CSS 2.1](https://developer.mozilla.org/en-US/docs/Web/CSS/Adjacent_sibling_selectors) and should be understood by many modern browsers.