added function doc strings