Possibly misleading description of cflags parameter in regcomp(3)

Possibly misleading description of cflags parameter in regcomp(3)

[Laurence Gonsalves]

Hello.

"man 3 regcomp" says "cflags may be the bitwise-or of one or more of
the following", but I'm fairly certain that 0 is also a legal value
for this parameter.

The page http://pubs.opengroup.org/onlinepubs/009695399/functions/regcomp.html
says "The cflags argument is the bitwise-inclusive OR of zero or more
of the following flags...".

If 0 is, indeed, a legal value then I think it would be more clear if
the manpage said "cflags may be the bitwise-or of zero or more of the
following".

(Sorry for the duplicate email. vger.kernel.org bounced the original
apparently due to Gmail's use of HTML.)
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: Possibly misleading description of cflags parameter in regcomp(3)

[Michael Kerrisk (man-pages)]

Laurence,

On 09/22/2013 08:41 PM, Laurence Gonsalves wrote:
> Hello.
> 
> "man 3 regcomp" says "cflags may be the bitwise-or of one or more of
> the following", but I'm fairly certain that 0 is also a legal value
> for this parameter.
> 
> The page http://pubs.opengroup.org/onlinepubs/009695399/functions/regcomp.html
> says "The cflags argument is the bitwise-inclusive OR of zero or more
> of the following flags...".
> 
> If 0 is, indeed, a legal value then I think it would be more clear if
> the manpage said "cflags may be the bitwise-or of zero or more of the
> following".
> 
> (Sorry for the duplicate email. vger.kernel.org bounced the original
> apparently due to Gmail's use of HTML.)

Quite some time after your report...

I agree, and I've made the change.

Cheers,

Michael






-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html