Fixes to TreePair multiplication

Permutations were not being properly updated in __mul__.
- Added an option to show debug messages in __mul__
- Added an example of multiplication to the documentation.