update for #36 - added documentation for  option