improving Common.options documentation