doc fixes
v0.003

          fix some confusing mistakes in the docs (thanks, George Hartzell)