regex.3: wfix
PATCH 1/1 regex.3: wfix
The wording was incorrect:
It stated that 'eflags' may be the OR of one or two of those two flags, but then a third flag was documented
(which according to the previous wording could not be used?!). Moreover, the wording also disallowed using 0 (i.e., no flags at all), which POSIX specifically allows;
I tested the function with no flags and it worked fine for me, so I guess it was a problem with the documentation,
and not with the implementation itself.
POSIX ref: https://pubs.opengroup.org/onlinepubs/9699919799/
---
Hi Michael,
I was working with the example, and the documentation was a bit weird, so I want to be sure I'm doing it right before sending you the example. Please review that this patch is correct, which I guess it is.
Cheers,
Alex
man3/regex.3 | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-)
man3/regex.3 +1 -5
@@ -136,11 +136,7 @@ are used to provide information regarding the location of any matches. .I eflags may be the .RB bitwise- or -of one or both of -.B REG_NOTBOL -and -.B REG_NOTEOL -which cause changes in matching behavior described below. +of zero or more of the following flags: .TP .B REG_NOTBOL The match-beginning-of-line operator always fails to match (but see the
Signature · 1 line
2.28.0
Quoted 13 lines · Alejandro Colomar
The wording was incorrect:
It stated that 'eflags' may be the OR of one or two of those two flags, but then a third flag was documented
(which according to the previous wording could not be used?!). Moreover, the wording also disallowed using 0 (i.e., no flags at all), which POSIX specifically allows;
I tested the function with no flags and it worked fine for me, so I guess it was a problem with the documentation,
and not with the implementation itself.POSIX ref: https://pubs.opengroup.org/onlinepubs/9699919799/
Quoted 8 lines
Signed-off-by Alejandro Colomar <[email protected]>---
Hi Michael,
I was working with the example, and the documentation was a bit weird, so I want to be sure I'm doing it right before sending you the example. Please review that this patch is correct, which I guess it is.
Hi Alex,
I'm sure your fix is correct. The wording "It *may* be..." was I think intended to imply that instead of a mask of one or more of those bits, it could be zero. But that's an imprecise way of saying what is better said by your patch.
I've applied the patch.
Thanks,
Michael
Quoted 21 lines
man3/regex.3 | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-)man3/regex.3 +1
-5@@ -136,11 +136,7 @@ are used to provide information regarding the location of any matches. .I eflags may be the .RB bitwise- or -of one or both of -.B REG_NOTBOL -and -.B REG_NOTEOL -which cause changes in matching behavior described below. +of zero or more of the following flags: .TP .B REG_NOTBOL The match-beginning-of-line operator always fails to match (but see the
Signature · 3 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/