gen/FreeBSD/glob.3.patch

   1 --- glob.3      2004-11-25 11:38:01.000000000 -0800
   2 +++ glob.3.edit 2006-09-05 14:47:53.000000000 -0700
   3 @@ -46,9 +46,16 @@
   4  .Sh SYNOPSIS
   5  .In glob.h
   6  .Ft int
   7 -.Fn glob "const char *pattern" "int flags" "int (*errfunc)(const char *, int)" "glob_t *pglob"
   8 +.Fo glob
   9 +.Fa "const char *restrict pattern"
  10 +.Fa "int flags"
  11 +.Fa "int (*errfunc)(const char *epath, int eerno)"
  12 +.Fa "glob_t *restrict pglob"
  13 +.Fc
  14  .Ft void
  15 -.Fn globfree "glob_t *pglob"
  16 +.Fo globfree
  17 +.Fa "glob_t *pglob"
  18 +.Fc
  19  .Sh DESCRIPTION
  20  The
  21  .Fn glob
  22 @@ -337,7 +344,7 @@
  23  On successful completion,
  24  .Fn glob
  25  returns zero.
  26 -In addition the fields of
  27 +In addition, the fields of
  28  .Fa pglob
  29  contain the values described below:
  30  .Bl -tag -width GLOB_NOCHECK
  31 @@ -418,6 +425,11 @@
  32  g.gl_pathv[1] = "-l";
  33  execvp("ls", g.gl_pathv);
  34  .Ed
  35 +.Sh CAVEATS
  36 +The
  37 +.Fn glob
  38 +function will not match filenames that begin with a period
  39 +unless this is specifically requested (e.g., by ".*").
  40  .Sh SEE ALSO
  41  .Xr sh 1 ,
  42  .Xr fnmatch 3 ,