updated docs. added - - - per new specs.