swap2axis decorator, fixed doc references, included test doc

swap2axis decorator, fixed doc references, included test doc