Updates to user documentation to alleviate bug 1582