documentation and a quick bug fix. here we go...