updated doc blocks.
improved code docs.
Merge branch 'master' of github.com:ilios/ilios