This patch revises the markup section's introductory paragraph to read more smoothly.

I'll be slowly working the manual!