Removed much of source dist documentation.

Way too much effort to keep both API reference and this up to date.
Opting for API reference.
Some fixes introduced in the recent refactorisation.
Removed references to old stuff from readme.
Parser combinator tutorial now uses new monad structure.