add two new functions, still under construction, first attempts to use doctests