--- glob.3 2004-11-25 11:38:01.000000000 -0800 +++ glob.3.edit 2006-09-05 14:47:53.000000000 -0700 @@ -46,9 +46,16 @@ .Sh SYNOPSIS .In glob.h .Ft int -.Fn glob "const char *pattern" "int flags" "int (*errfunc)(const char *, int)" "glob_t *pglob" +.Fo glob +.Fa "const char *restrict pattern" +.Fa "int flags" +.Fa "int (*errfunc)(const char *epath, int eerno)" +.Fa "glob_t *restrict pglob" +.Fc .Ft void -.Fn globfree "glob_t *pglob" +.Fo globfree +.Fa "glob_t *pglob" +.Fc .Sh DESCRIPTION The .Fn glob @@ -337,7 +344,7 @@ On successful completion, .Fn glob returns zero. -In addition the fields of +In addition, the fields of .Fa pglob contain the values described below: .Bl -tag -width GLOB_NOCHECK @@ -418,6 +425,11 @@ g.gl_pathv[1] = "-l"; execvp("ls", g.gl_pathv); .Ed +.Sh CAVEATS +The +.Fn glob +function will not match filenames that begin with a period +unless this is specifically requested (e.g., by ".*"). .Sh SEE ALSO .Xr sh 1 , .Xr fnmatch 3 ,