documented function #307

documented function #307