These changes are intended to make the section more informative and readable, without making any new normative claims.
* Specify that the alignment might be _less_ than the size, rather than just that it might be different. This is mandatory and stated in the previous section, but I think it's useful to reiterate here.
* Mention `u128`/`i128` as another example of alignment less than size, so that this doesn't sound like a mainly 32-bit thing.
* Add `usize`/`isize` to the size table, so it can be spotted at a glance.
Forms like 'ab'c are rejected, so we need some way to explain why they
don't tokenise as two consecutive LIFETIME_OR_LABEL tokens.
Address this by adding "not immediately followed by `'`" to each of the
lexer rules for the lifetime-like tokens.
This also means there can be no ambiguity between CHAR_LITERAL and these
tokens (at present we don't say how such ambiguities are resolved).
We spent a lot of text in the README describing how to use the nightly
Rust compiler with this project. Let's instead add a
`rust-toolchain.toml` file so that the nightly compiler is used
automatically, and let's redraft the README in that light.
With this revision, we'll add a section on installing dependencies in
which we'll describe how to ensure that the nightly compiler is
installed and up to date and how to install `mdbook`.
When describing how to clone the project, we'll suggest that people
clone the URL ending in `.git`. This is what GitHub recommends, and
it removes a level of redirection which sometimes matters.
For people who want to download a ZIP file rather than using `git`,
we'll provide a direct link rather than simply referencing the GitHub
page.
When describing how to build the book, we'll suggesting passing
`--open` to `mdbook`, as this is usually what people will want, and it
will save a step.
Along with these changes, we include some general copyediting.
In `README.md`, some lines were hard wrapped where others were not,
there was some trailing whitespace, and some list items were
terminated with a period where some were not. Let's clean these
things up by hard wrapping all lines, cleaning up the whitespace, and
terminating all list items with periods.
Eric Huss
MultisampledNight
Gary Guo
Kevin Reid
Conrad Ludgate
Jamie Lokier
Yotam Ofek
Shotaro Aoyama
Matthew Woodcraft
Georg Semmler
Georg Semmler
Michael Goulet
John-John Tedro
Travis Cross