--- org/fnmatch.3c	Wed Aug 11 17:48:03 2010
+++ fnmatch.3c	Thu Aug 12 11:11:27 2010
@@ -29,6 +29,9 @@
 
                        If not set, the slash character is treated
                        as an ordinary character.
+                                                                              |
+     FNM_FILE_NAME     An alias of FNM_PATHNAME provided for a better         |
+                       compatibility with other operating systems.            |
 
      FNM_NOESCAPE      If not set, a backslash character  (\)  in
                        pattern  followed  by  any other character
@@ -52,6 +55,18 @@
                            o    If FNM_PATHNAME  is  not  set,  a
                                 period is "leading" only if it is
                                 the first character of string.
+                                                                              |
+     FNM_IGNORECASE    If set, during matching, case is ignored               |
+                       yielding case-insensitive matching on characters.      |
+                                                                              |
+     FNM_CASEFOLD      An alias of FNM_IGNORECASE provided for a better       |
+                       compatibility with other operating systems.            |
+                                                                              |
+     FNM_LEADING_DIR   If set, matching is done with string only until all    |
+                       pattern expressions in pattern argument are consumed.  |
+                       Any remaining characters at string starting with slash |
+                       character (/) are simply ignored and do not affect     |
+                       the matching result.                                   |
 
      If not set, no special restrictions are placed on matching a
      period.
@@ -83,6 +98,41 @@
      The fnmatch() function can be used safely  in  multithreaded
      applications,  as  long as setlocale(3C) is not being called
      to change the locale.
+                                                                              |
+     While the FNM_CASEFOLD, FNM_FILE_NAME, FNM_IGNORECASE, and               |
+     FNM_LEADING_DIR flags are provided and supported for a better            |
+     compatibility with some other operating systems, use of them,            |
+     however, may make your program source code slightly less portable        |
+     and portable only to the operating systems that support                  |
+     the mentioned flags.                                                     |
+                                                                              |
+                                                                              |
+EXAMPLES                                                                      |
+     Example 1: A path name matching.                                         |
+                                                                              |
+     The following example matches all file names under "/opt/MyApp1.0/"      |
+     that end with ".data":                                                   |
+                                                                              |
+       result = fnmatch("/opt/MyApp1.0/*.data", pname, FNM_PATHNAME);         |
+                                                                              |
+     Example 2: A case-insensitive file name matching.                        |
+                                                                              |
+     The following example matches file names pointed to by fname             |
+     that has "myfile" as prefix in any case combination:                     |
+                                                                              |
+       result = fnmatch("myfile*", fname, FNM_IGNORECASE);                    |
+                                                                              |
+     Example 3: Match all path names with a common set of parent names.       |
+                                                                              |
+     The following example matches path names pointed to by pname             |
+     that has a common set of parent path names of "/opt/l*/MyApps" and,      |
+     in doing so, also ensures slash characters are explicitly matched:       |
+                                                                              |
+       result = fnmatch("/opt/l*/MyApps", pname,                              |
+                        (FNM_PATHNAME | FNM_LEADING_DIR));                    |
+                                                                              |
+     For instance, the above will match "/opt/lib/MyApps/test/test.txt"       |
+     and "/opt/local/MyApps/config" but not "/opt/lib/locale/MyApps".         |
 
 
 ATTRIBUTES