diff options
author | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-04-12 22:42:49 +0000 |
---|---|---|
committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-04-12 22:42:49 +0000 |
commit | c13182efa3b3d77f2563034c8212c0ca798243ca (patch) | |
tree | e7652b26018b7c22cd6a4e4b41404dfaab911303 /man3/glob.3 | |
parent | 4174ff5658082832c2ed511720f18881b3a80a34 (diff) |
Wrapped long lines, wrapped at sentence boundaries; stripped trailing
white space.
Diffstat (limited to 'man3/glob.3')
-rw-r--r-- | man3/glob.3 | 31 |
1 files changed, 16 insertions, 15 deletions
diff --git a/man3/glob.3 b/man3/glob.3 index 363e49c5..24c03fca 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -8,7 +8,7 @@ .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. -.\" +.\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from @@ -16,7 +16,7 @@ .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. -.\" +.\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" License. @@ -106,8 +106,8 @@ slots will be reserved at the beginning of the list of strings in which means that, if no pattern matches, to return the original pattern, .TP .B GLOB_APPEND -which means to append to the results of a previous call. Do not set -this flag on the first invocation of +which means to append to the results of a previous call. +Do not set this flag on the first invocation of .BR glob (). .TP .B GLOB_NOESCAPE @@ -153,29 +153,30 @@ a pointer to the path which failed, and the value of .I errno as returned from one of the calls to -.BR opendir (), -.BR readdir (), -or +.BR opendir (), +.BR readdir (), +or .BR stat (). -If +If .I errfunc returns non-zero, or if .B GLOB_ERR -is set, +is set, .BR glob () will terminate after the call to .IR errfunc . .PP -Upon successful return, +Upon successful return, .I pglob->gl_pathc contains the number of matched pathnames and .I pglob->gl_pathv -a pointer to the list of matched pathnames. The first pointer after -the last pathname is NULL. +a pointer to the list of matched pathnames. +The first pointer after the last pathname is NULL. .PP It is possible to call .BR glob () -several times. In that case, the +several times. +In that case, the .B GLOB_APPEND flag has to be set in .I flags @@ -187,7 +188,7 @@ is set to the flags specified, \fBor\fRed with .B GLOB_MAGCHAR if any metacharacters were found. .SH "RETURN VALUE" -On successful completion, +On successful completion, .BR glob () returns zero. Other possible returns are: @@ -224,7 +225,7 @@ POSIX.2, POSIX.1-2001. The .BR glob () function may fail due to failure of underlying function calls, such as -.BR malloc () +.BR malloc () or .BR opendir (). These will store their error code in |