documentation updates

Suggested doc updates from issues encountered while installing on Debian wheezy.