minor changes and a bug or two in documentation.

Please view files for detail or communication thread here: https://groups.google.com/forum/#!topic/onebusaway-developers/3Qhf7QRU9wI