update readme to explain bool behavior