cleaning up doc strings; no more warnings thrown by Sphinx