Mostly new documentation

Added a few more doc strings. Also, moved public generic functions
to the top of file `connection.lisp' for faster reference. Exposed
a few more meant-to-be-public identifiers from the `defpackage'.