DOC: man page description shorting and clarification