PK_ERROR_code_t PK_LOOP_euler_transfer
(
--- received arguments ---
PK_LOOP_t       loop,    --- loop to transfer
PK_FACE_t       face     --- destination face
)


This function transfers a loop from one face to another.


Specific Errors:
    PK_ERROR_different_shells       faces are in different shells
    PK_ERROR_face_contains_loop     loop is already in destination face
    PK_ERROR_only_one_loop          attempt to remove the last loop from face


The originating face of loop and its destination face must have the same
front and back shells.  loop must not already be in face and must not be
the only loop in its originating face.