Fix a bug where a custom extractor terminate was being called twice.

Resolves issue #1503.

Clarify the custom extractor and collator terminate documentation while
I'm here.