Add a clarifying comment about case folding.

Fixes #262.

Change-Id: I31a87f32fb780e40a7077a88168467d1c817fd3f
Reviewed-on: https://code-review.googlesource.com/c/re2/+/57230
Reviewed-by: Paul Wankadia <junyer@google.com>
diff --git a/re2/re2.h b/re2/re2.h
index 32b2718..55e732b 100644
--- a/re2/re2.h
+++ b/re2/re2.h
@@ -40,6 +40,9 @@
 //   R"((?i)hello)"          -- (?i) turns on case-insensitive matching
 //   R"(/\*(.*?)\*/)"        -- .*? matches . minimum no. of times possible
 //
+// When using UTF-8 encoding, case-insensitive matching will perform
+// simple case folding, not full case folding.
+//
 // -----------------------------------------------------------------------
 // MATCHING INTERFACE:
 //