method docs, refs #1211