some doc changes #25

Merged
merged 3 commits into from Jan 19, 2013