Fixes for issues noticed while proof-reading

I've not checked the actual content yet against the 1.1 specification, but have identified some issues with the conversion to rst.  Some are fixed in these commits; others I've opened issues for.