added explanatory comments to most demos
only cosmetic
proofread manual; demo tweaks