Also adds better documentation and removes the one-off reimplementation
of the function in pica.h.