method docs, refs #1305