Edits to sections 5.1 and 5.2

Not complete, and the region join section also has a big blob of code -- but Frank, let me know where you want me to (a) cut this down, or (b) add more detail?