Did some more documenting, and in the process realized that the implementation of string matching is (partly) wrong.  Added comments and will correct later.
Did some more documenting, and in the process realized that the implementation of string matching is (partly) wrong.  Added comments and will correct later.

git-svn-id: 88252f78c26a59aa3354498574018049c1a7e6e4@13 e9066bae-eb34-0410-adca-61464099497e

shiblon/hagoth