initial commit was garbage. second try.

updated docs as well.