Revise wording of integer alignment guarantee

Let's make this wording a bit more clear, and let's fix the em dash to
use `---` since that's what our renderer expects.