initial docu for these routines