Improve inline documentation, minor refactoring.
Update README, bump stable to 1.0.4 and tested up-to to 3.9.0.