[src/trunk]: src/share/man/man9 Clarify the meaning of this. These macros do...

[plunky <plunky%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/0273df64f840
branches:  trunk
changeset: 342264:0273df64f840
user:      plunky <plunky%NetBSD.org@localhost>
date:      Sun Dec 13 21:53:02 2015 +0000

description:
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.

diffstat:

 share/man/man9/SET.9 |  14 +++++++-------
 1 files changed, 7 insertions(+), 7 deletions(-)

diffs (50 lines):

diff -r 3a4d3d7edfc2 -r 0273df64f840 share/man/man9/SET.9
--- a/share/man/man9/SET.9      Sun Dec 13 21:24:06 2015 +0000
+++ b/share/man/man9/SET.9      Sun Dec 13 21:53:02 2015 +0000
@@ -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