details addded to documentation
nnew function addition