[src/trunk]: src Document the weird <iso646.h>.

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

details:   https://anonhg.NetBSD.org/src/rev/be1b7e29a618
branches:  trunk
changeset: 753261:be1b7e29a618
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Sun Mar 21 21:23:51 2010 +0000

description:
Document the weird <iso646.h>.

diffstat:

 distrib/sets/lists/comp/mi |   5 ++-
 share/man/man3/Makefile    |   4 +-
 share/man/man3/iso646.3    |  71 ++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 77 insertions(+), 3 deletions(-)

diffs (123 lines):

diff -r cae558763527 -r be1b7e29a618 distrib/sets/lists/comp/mi
--- a/distrib/sets/lists/comp/mi        Sun Mar 21 21:15:37 2010 +0000
+++ b/distrib/sets/lists/comp/mi        Sun Mar 21 21:23:51 2010 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: mi,v 1.1412 2010/03/21 19:45:58 jruoho Exp $
+#      $NetBSD: mi,v 1.1413 2010/03/21 21:23:51 jruoho Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -6194,6 +6194,7 @@
 ./usr/share/man/cat3/isnanf.0                  comp-c-catman           .cat
 ./usr/share/man/cat3/isnormal.0                        comp-c-catman           .cat
 ./usr/share/man/cat3/iso_addr.0                        comp-c-catman           .cat
+./usr/share/man/cat3/iso646.0                  comp-c-catman           .cat
 ./usr/share/man/cat3/isprint.0                 comp-c-catman           .cat
 ./usr/share/man/cat3/ispunct.0                 comp-c-catman           .cat
 ./usr/share/man/cat3/isspace.0                 comp-c-catman           .cat
@@ -11968,6 +11969,7 @@
 ./usr/share/man/html3/isnanf.html              comp-c-htmlman          html
 ./usr/share/man/html3/isnormal.html            comp-c-htmlman          html
 ./usr/share/man/html3/iso_addr.html            comp-c-htmlman          html
+./usr/share/man/html3/iso646.html              comp-c-htmlman          html
 ./usr/share/man/html3/isprint.html             comp-c-htmlman          html
 ./usr/share/man/html3/ispunct.html             comp-c-htmlman          html
 ./usr/share/man/html3/isspace.html             comp-c-htmlman          html
@@ -17660,6 +17662,7 @@
 ./usr/share/man/man3/isnanf.3                  comp-c-man              .man
 ./usr/share/man/man3/isnormal.3                        comp-c-man              .man
 ./usr/share/man/man3/iso_addr.3                        comp-c-man              .man
+./usr/share/man/man3/iso646.3                  comp-c-man              .man
 ./usr/share/man/man3/isprint.3                 comp-c-man              .man
 ./usr/share/man/man3/ispunct.3                 comp-c-man              .man
 ./usr/share/man/man3/isspace.3                 comp-c-man              .man
diff -r cae558763527 -r be1b7e29a618 share/man/man3/Makefile
--- a/share/man/man3/Makefile   Sun Mar 21 21:15:37 2010 +0000
+++ b/share/man/man3/Makefile   Sun Mar 21 21:23:51 2010 +0000
@@ -1,9 +1,9 @@
-#      $NetBSD: Makefile,v 1.44 2010/03/21 19:42:51 jruoho Exp $
+#      $NetBSD: Makefile,v 1.45 2010/03/21 21:23:51 jruoho Exp $
 #      @(#)Makefile    8.2 (Berkeley) 12/13/93
 
 MAN=   _DIAGASSERT.3 __UNCONST.3 CMSG_DATA.3 \
        __arraycount.3 assert.3 bits.3 bitstring.3 dlfcn.3 end.3 \
-       fast_divide32.3 gcq.3 intro.3 inttypes.3 offsetof.3 queue.3 \
+       fast_divide32.3 gcq.3 intro.3 inttypes.3 iso646.3 offsetof.3 queue.3 \
        stdarg.3 stdbool.3 stddef.3 stdint.3 sysexits.3 \
        tgmath.3 timeradd.3 tree.3 varargs.3
 
diff -r cae558763527 -r be1b7e29a618 share/man/man3/iso646.3
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man3/iso646.3   Sun Mar 21 21:23:51 2010 +0000
@@ -0,0 +1,71 @@
+.\" $NetBSD: iso646.3,v 1.1 2010/03/21 21:23:51 jruoho Exp $
+.\"
+.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Jukka Ruohonen.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd March 21, 2010
+.Os
+.Dt ISO646 3
+.Sh NAME
+.Nm iso646
+.Nd alternative operator spellings
+.Sh SYNOPSIS
+.In iso646.h
+.Sh DESCRIPTION
+The
+.In iso646.h
+header defines eleven alternative spellings for standard operators:
+.Bl -column -offset indent \
+"11." "xor_eq" "xx"
+.It Li 1. Ta Em and Ta \*[Am]\*[Am]
+.It Li 2. Ta Em and_eq Ta \*[Am]\&=
+.It Li 3. Ta Em bitand Ta \*[Am]
+.It Li 4. Ta Em bitor Ta \*[Ba]
+.It Li 5. Ta Em compl Ta \&~
+.It Li 6. Ta Em not Ta \&!
+.It Li 7. Ta Em not_eq Ta \*[Ne]
+.It Li 8. Ta Em or Ta \*[Ba]\*[Ba]
+.It Li 9. Ta Em or_eq Ta \&!\&=
+.It Li 10. Ta Em xor Ta \&^
+.It Li 11. Ta Em xor_eq Ta \&^\&=
+.El
+.Pp
+Each macro expands to the corresponding token.
+.Sh RATIONALE
+None.
+.Sh SEE ALSO
+.Xr operator 7
+.Sh STANDARDS
+The
+.In iso646.h
+header conforms to
+.St -ansiC .
+.Sh HISTORY
+The
+.In iso646.h
+header was first introduced in
+.Nx 1.1 .