- make some links into the reference documentation relative for

off-line readers
- fix some minor typos and markup errors