Update docs for agglo.py

The main agglomeration module was woefully undocumented. This PR improves the situation although much remains to be done.