added documentation for the 'state' optional option