Documentation cleanup

Adds a little detail to the POD, corrects an error in the dancr.pl
source code.
reflect change
Merge branch 'docUpdate0827'