Fixes #2702. Also cleans up formatting and long lines in volumes doc.