--- ISOLatin1AccentFilter-dist.java	2007-10-16 08:54:15.493000000 +0300
+++ /cygdrive/c/Users/aspa/workspaces/terveystalo/lucene-test/src/org/apache/lucene/analysis/ISOLatin1AccentFilter.java	2007-10-16 09:50:14.175000000 +0300
@@ -18,11 +18,27 @@
  */
 
 /**
- * A filter that replaces accented characters in the ISO Latin 1 character set 
- * (ISO-8859-1) by their unaccented equivalent. The case will not be altered.
+ * A filter that replaces non-ASCII characters in the ISO Latin 1 character set 
+ * (ISO-8859-1) with ASCII characters. The replacement is done without considering
+ * semantic character equivalence. The case will not be altered.
+ * 
  * <p>
  * For instance, '&agrave;' will be replaced by 'a'.
  * <p>
+ * 
+ * <p>
+ * The purpose of this class is to allow users easy entry with a keyboard of another language.
+ * It should not be used when search accuracy is considered to be more important than ease of
+ * entry with a another type of keyboard.
+ * </p>
+ * 
+ * <p>
+ * <b>
+ * Please note that the replacements performed by this filter will result in words changing their original semantic meaning in many cases.<br>
+ * It will also be impossible to search for the word in its original form.
+ * </b>
+ * </p>
+ * 
  */
 public class ISOLatin1AccentFilter extends TokenFilter {
   public ISOLatin1AccentFilter(TokenStream input) {