updated docs with options etc