SOLR-3056: document expectations in these files

git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/trunk@1241960 13f79535-47bb-0310-9956-ffa450edef68

modules/analysis/common/src/resources/org/apache/lucene/analysis/ar/stopwords.txt

@@ -2,6 +2,8 @@
 # See http://members.unine.ch/jacques.savoy/clef/index.html.
 # Also see http://www.opensource.org/licenses/bsd-license.html
 # Cleaned on October 11, 2009 (not normalized, so use before normalization)
+# This means that when modifying this list, you might need to add some 
+# redundant entries, for example containing forms with both أ and ا
 من
 ومن
 منها

modules/analysis/common/src/resources/org/apache/lucene/analysis/el/stopwords.txt

@@ -1,4 +1,6 @@
 # Lucene Greek Stopwords list
+# Note: by default this file is used after GreekLowerCaseFilter,
+# so when modifying this file use 'σ' instead of 'ς' 
 ο
 η
 το

modules/analysis/common/src/resources/org/apache/lucene/analysis/fa/stopwords.txt

@@ -1,6 +1,8 @@
 # This file was created by Jacques Savoy and is distributed under the BSD license.
 # See http://members.unine.ch/jacques.savoy/clef/index.html.
 # Also see http://www.opensource.org/licenses/bsd-license.html
+# Note: by default this file is used after normalization, so when adding entries
+# to this file, use the arabic 'ي' instead of 'ی'
 انان
 نداشته
 سراسر

modules/analysis/common/src/resources/org/apache/lucene/analysis/hi/stopwords.txt

@@ -1,6 +1,10 @@
 # Also see http://www.opensource.org/licenses/bsd-license.html
 # See http://members.unine.ch/jacques.savoy/clef/index.html.
 # This file was created by Jacques Savoy and is distributed under the BSD license.
+# Note: by default this file also contains forms normalized by HindiNormalizer 
+# for spelling variation (see section below), such that it can be used whether or 
+# not you enable that feature. When adding additional entries to this list,
+# please add the normalized form as well. 
 अंदर
 अत
 अपना

solr/example/solr/conf/lang/stopwords_ar.txt

@@ -2,6 +2,8 @@
 # See http://members.unine.ch/jacques.savoy/clef/index.html.
 # Also see http://www.opensource.org/licenses/bsd-license.html
 # Cleaned on October 11, 2009 (not normalized, so use before normalization)
+# This means that when modifying this list, you might need to add some 
+# redundant entries, for example containing forms with both أ and ا
 من
 ومن
 منها

solr/example/solr/conf/lang/stopwords_el.txt

@@ -1,4 +1,6 @@
 # Lucene Greek Stopwords list
+# Note: by default this file is used after GreekLowerCaseFilter,
+# so when modifying this file use 'σ' instead of 'ς' 
 ο
 η
 το

solr/example/solr/conf/lang/stopwords_fa.txt

@@ -1,6 +1,8 @@
 # This file was created by Jacques Savoy and is distributed under the BSD license.
 # See http://members.unine.ch/jacques.savoy/clef/index.html.
 # Also see http://www.opensource.org/licenses/bsd-license.html
+# Note: by default this file is used after normalization, so when adding entries
+# to this file, use the arabic 'ي' instead of 'ی'
 انان
 نداشته
 سراسر

solr/example/solr/conf/lang/stopwords_hi.txt

@@ -1,6 +1,10 @@
 # Also see http://www.opensource.org/licenses/bsd-license.html
 # See http://members.unine.ch/jacques.savoy/clef/index.html.
 # This file was created by Jacques Savoy and is distributed under the BSD license.
+# Note: by default this file also contains forms normalized by HindiNormalizer 
+# for spelling variation (see section below), such that it can be used whether or 
+# not you enable that feature. When adding additional entries to this list,
+# please add the normalized form as well. 
 अंदर
 अत
 अपना