some basic functions added to doc