--- a/extensions.st	Sat Oct 03 15:07:33 2009 +0200
+++ b/extensions.st	Sat Oct 03 15:43:30 2009 +0200
@@ -1,7 +1,7 @@
 "{ Package: 'stx:libbasic2' }"
 !
 
-!CharacterArray methodsFor:'converting'!
+!CharacterArray methodsFor:'matching - phonetic'!
 
 asKoelnerPhoneticCode
     "return a koelner phonetic code.
@@ -9,7 +9,11 @@
      it returns simular strings for similar sounding words. 
      There are some differences to soundex, though: 
         its length is not limited to 4, but depends on the length of the original string;
-        it does not start with the first character of the input."
+        it does not start with the first character of the input.
+
+     Caveat: this phonetic code is especially suited for german words.
+             Please have a look at the other phonetic comparison operators found    
+             in PhoneticStringUtilities."
 
     ^ PhoneticStringUtilities koelnerPhoneticCodeOf:self 
 
@@ -64,14 +68,17 @@
     "
 ! !
 
-!CharacterArray methodsFor:'converting'!
+!CharacterArray methodsFor:'matching - phonetic'!
 
 asSoundexCode
     "return a soundex phonetic code or nil.
      Soundex returns similar codes for similar sounding words, making it a useful
      tool when searching for words where the correct spelling is unknown.
      (read Knuth or search the web if you dont know what a soundex code is).
-     Caveat: 'similar sounding words' means: 'similar sounding in english'."
+
+     Caveat: 'similar sounding words' means: 'similar sounding in english'
+             Please have a look at the other phonetic comparison operators found    
+             in PhoneticStringUtilities."
 
     ^ PhoneticStringUtilities soundexCodeOf:self