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.
Merge pull request #1506 from wiredtiger/extractor-terminate

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