Added documentation-generation to the Makefile: run 'make doc' to
build it, then point your browser to
"_build/documentation.docdir/index.html" to see the results. Tidied
up the comments at the top of each source file, so that ocamldoc can
read them.