AG: commentary updates for __doc__ for files.