Module Name:    src
Committed By:   plunky
Date:           Sun Dec 13 21:53:03 UTC 2015

Modified Files:
        src/share/man/man9: SET.9

Log Message:
Clarify the meaning of this.  These macros do not operate on bit numbers
as is implied.. the macros are defined as

    #define SET(t, f)       ((t) |= (f))
    #define ISSET(t, f)     ((t) & (f))
    #define CLR(t, f)       ((t) &= ~(f))

When the rationale is to provide clarity in the source code, then it
is good to have manual pages that are correct.


To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/share/man/man9/SET.9

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man9/SET.9
diff -u src/share/man/man9/SET.9:1.3 src/share/man/man9/SET.9:1.4
--- src/share/man/man9/SET.9:1.3	Wed Mar 12 16:37:01 2014
+++ src/share/man/man9/SET.9	Sun Dec 13 21:53:02 2015
@@ -1,4 +1,4 @@
-.\" $NetBSD: SET.9,v 1.3 2014/03/12 16:37:01 jruoho Exp $
+.\" $NetBSD: SET.9,v 1.4 2015/12/13 21:53:02 plunky Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd March 12, 2014
+.Dd December 13, 2015
 .Dt SET 9
 .Os
 .Sh NAME
@@ -42,26 +42,26 @@
 .Ft void
 .Fn CLR "val" "x"
 .Sh DESCRIPTION
-These macros define three standard bit-operations:
+These macros define three standard bit operations:
 .Bl -enum -offset indent
 .It
 .Fn SET
-sets the bit
+the set bits from
 .Fa x
 in
 .Fa val ;
 .It
 .Fn CLR
-clears the bit
+clears the set bits from
 .Fa x
 in
 .Fa val ;
 and
 .It
 .Fn ISSET
-returns 1 if the bit
+returns true if any of the set bits from
 .Fa x
-is set in
+are set in
 .Fa val .
 .El
 .Sh SEE ALSO

Reply via email to