some docs, refs #1355