Many comments added.  There are now comments for all methods except
for the really obvious ones, like initialize().