update d/docs as appropriate
Merge pull request #2 from ttyS4/master

Looks sane.  Thanks!