added documentation for added function