BF: include examples/ into source distribution

to match description on the web (pypi) saying to look under examples
ENH: add shebangs and make example scripts executable

consider stripping .py suffix
ENH: just few typos and adjusted shebang (and executable permissions for setup.py)