avoid compiler warnings by using @pdoc for private funs