restrict options passed to repository
README improvments