--- a/jdk/src/share/classes/java/nio/file/FileSystem.java	Mon Apr 18 11:32:41 2011 -0700
+++ b/jdk/src/share/classes/java/nio/file/FileSystem.java	Mon Apr 18 21:44:03 2011 -0700
@@ -391,6 +391,13 @@
      *   character is used to separate the subpatterns. Groups cannot be nested.
      *   </p></li>
      *
+     *   <li><p> Leading period<tt>&#47;</tt>dot characters in file name are
+     *   treated as regular characters in match operations. For example,
+     *   the {@code "*"} glob pattern matches file name {@code ".login"}.
+     *   The {@link Files#isHidden} method may be used to test whether a file
+     *   is considered hidden.
+     *   </p></li>
+     *
      *   <li><p> All other characters match themselves in an implementation
      *   dependent manner. This includes characters representing any {@link
      *   FileSystem#getSeparator name-separators}. </p></li>