Improved documentation.
(closes #46, closes #45, closes #25)