Updates to README

- set version to 1.5.0
- document gemPath option
- use transitional AsciiDoc syntax where appropriate (i.e., [x-])
- use single-line doctitle
- use callouts in source listings
- update links and names of projects