updated function documentation
Merge remote-tracking branch 'origin/gh-pages' into gh-pages