added some more clarification & references to the jytok equiv
fixed doctest