* add to and from pivot functions
* document this and edit doc in general.
* tests for pivot code
* add iscyclic() and tests