added more email validation, minor doc changes

Hey Gary, 
The added validation is not very restrictive, but it adds some obvious cases that should be rejected.
-Meir