Gittrac #3930:  Cleaned up code and test (of initial implementation
-- may need further cleanup after LIGO tries it).
Gittrac #3930:  Documented this.
Gittrac #3930:  Improvements to documentation.