be less verbose in plot examples
DOC minor fixes / add max-product to option strings.