add doc and examples for the new "distance" field function