DOC:  improved documentation.