many improvements to the documentation, simplified setup.py, set version to 1.0 (not released yet)