DOC: explain some more of the parameters