Added some clarity to the comments and doc-strings.