doc regular expression: add a note about normalize of search keywords

groonga · Nov 1, 2018 · 022161c · 022161c
1 parent e93ee6d
commit 022161c
Show file tree

Hide file tree

Showing 2 changed files with 35 additions and 0 deletions.
diff --git a/doc/locale/ja/LC_MESSAGES/reference.po b/doc/locale/ja/LC_MESSAGES/reference.po
@@ -24510,6 +24510,28 @@ msgstr ""
 "もし、大文字小文字を区別しないマッチに ``disk`` という正規表現を使うなら、"
 "Groongaはインデックスを使ってこのパターンを検索できます。これは高速です。"
 
+msgid ""
+"By full text search normally, Groonga normalize search keywords using the "
+"normalizer specified in a lexicon. By using regular expression search, "
+"Groonga doesn't normalize search keywords. Because the regular expression "
+"has specified meaning in uppercase and lowercase."
+msgstr ""
+"全文検索では通常、Groongaは検索キーワードを語彙表に指定されているノーマライ"
+"ザーを使って正規化します。正規表現を使った検索では、Groongaは、検索キーワード"
+"を正規化しません。これは、正規表現は大文字と小文字に意味があるためです。"
+
+msgid ""
+"So, if you regular expression search that doesn't use the index, we suggest "
+"that use :doc:`/reference/commands/normalize` command to normalize search "
+"keywords before a search. By using :doc:`/reference/commands/normalize` "
+"command, you don't have to need to think about how to normalize search "
+"keywords."
+msgstr ""
+"したがって、インデックスを使えない正規表現検索では、 :doc:`/reference/"
+"commands/normalize` コマンドで検索前に検索キーワードを正規化することをおすす"
+"めします。:doc:`/reference/commands/normalize` コマンドを使うことで、検索キー"
+"ワードをどのように正規化するか考る必要がなくなります。"
+
 msgid ""
 "You may feel the behavior is strange. But fast search based on this behavior "
 "will help you."

diff --git a/doc/source/reference/regular_expression.rst b/doc/source/reference/regular_expression.rst
@@ -46,6 +46,19 @@ that can be evaluated by index are described later.
    If you write ``disk`` regular expression for case-insensitive
    match, Groonga can search the pattern with index. It's fast.
 
+   By full text search normally, Groonga normalize search keywords
+   using the normalizer specified in a lexicon.
+   By using regular expression search, Groonga doesn't normalize search
+   keywords.
+   Because the regular expression has specified meaning in uppercase and
+   lowercase.
+
+   So, if you regular expression search that doesn't use the index,
+   we suggest that use :doc:`/reference/commands/normalize` command to
+   normalize search keywords before a search.
+   By using :doc:`/reference/commands/normalize` command, you don't have
+   to need to think about how to normalize search keywords.
+
    You may feel the behavior is strange. But fast search based on this
    behavior will help you.