CVS commit: src/share/man/man3

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Wed Apr 14 07:56:23 UTC 2021

Modified Files:
src/share/man/man3: intro.3

Log Message:
OpenSSL man pages have moved


To generate a diff of this commit:
cvs rdiff -u -r1.35 -r1.36 src/share/man/man3/intro.3

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/man3/intro.3
diff -u src/share/man/man3/intro.3:1.35 src/share/man/man3/intro.3:1.36
--- src/share/man/man3/intro.3:1.35	Wed Apr 14 07:52:53 2021
+++ src/share/man/man3/intro.3	Wed Apr 14 07:56:23 2021
@@ -1,4 +1,4 @@
-.\"	$NetBSD: intro.3,v 1.35 2021/04/14 07:52:53 nia Exp $
+.\"	$NetBSD: intro.3,v 1.36 2021/04/14 07:56:23 nia Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -123,7 +123,7 @@ See
 .It Em libcrypto Pq Fl l Ns Ar crypto
 The OpenSSL cryptographic library.
 See
-.Xr crypto 3 .
+.Xr crypto 7 .
 .It Em libcurses Pq Fl l Ns Ar curses Fl l Ns Ar terminfo
 Terminal independent screen management routines
 for two dimensional non-bitmap display terminals.
@@ -281,7 +281,7 @@ See
 .It Em libssl Pq Fl l Ns Ar ssl
 The secure sockets layer (SSL) library.
 See
-.Xr ssl 3 .
+.Xr ssl 7 .
 .It Em libtelnet Pq Fl l Ns Ar telnet
 The telnet library.
 .It Em libterminfo Pq Fl l Ns Ar terminfo

CVS commit: src/share/man/man3

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Wed Apr 14 07:52:53 UTC 2021

Modified Files:
src/share/man/man3: intro.3

Log Message:
intro.3: add a few


To generate a diff of this commit:
cvs rdiff -u -r1.34 -r1.35 src/share/man/man3/intro.3

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/man3/intro.3
diff -u src/share/man/man3/intro.3:1.34 src/share/man/man3/intro.3:1.35
--- src/share/man/man3/intro.3:1.34	Fri May 11 12:54:56 2018
+++ src/share/man/man3/intro.3	Wed Apr 14 07:52:53 2021
@@ -1,4 +1,4 @@
-.\"	$NetBSD: intro.3,v 1.34 2018/05/11 12:54:56 sevan Exp $
+.\"	$NetBSD: intro.3,v 1.35 2021/04/14 07:52:53 nia Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)intro.3	8.1 (Berkeley) 6/5/93
 .\"
-.Dd May 11, 2018
+.Dd April 14, 2021
 .Dt INTRO 3
 .Os
 .Sh NAME
@@ -228,6 +228,15 @@ See
 The curses menu library.
 See
 .Xr menus 3 .
+.It Em libnvmm Pq Fl l Ns Ar nvmm
+.Nx
+Virtualization API.
+See
+.Xr libnvmm 3 .
+.It Em libossaudio Pq Fl l Ns Ar ossaudio
+Open Sound System compatibility library.
+See
+.Xr ossaudio 3 .
 .It Em libpanel Pq Fl l Ns Ar panel
 The curses panel library.
 See

CVS commit: src/share/man/man3

[Roland Illig]

Module Name:src
Committed By:   rillig
Date:   Tue Feb 23 16:47:04 UTC 2021

Modified Files:
src/share/man/man3: timeradd.3

Log Message:
timeradd.3: declare timespeccmp parameters as const

Comparison is implemented as a read-only operation.


To generate a diff of this commit:
cvs rdiff -u -r1.9 -r1.10 src/share/man/man3/timeradd.3

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/man3/timeradd.3
diff -u src/share/man/man3/timeradd.3:1.9 src/share/man/man3/timeradd.3:1.10
--- src/share/man/man3/timeradd.3:1.9	Tue Feb 23 09:28:00 2021
+++ src/share/man/man3/timeradd.3	Tue Feb 23 16:47:04 2021
@@ -1,4 +1,4 @@
-.\" $NetBSD: timeradd.3,v 1.9 2021/02/23 09:28:00 wiz Exp $
+.\" $NetBSD: timeradd.3,v 1.10 2021/02/23 16:47:04 rillig Exp $
 .\"
 .\" Copyright (c) 2009 Jukka Ruohonen 
 .\" Copyright (c) 1999 Kelly Yancey 
@@ -59,7 +59,7 @@
 .Ft int
 .Fn timespecisset "struct timespec *ts"
 .Ft int
-.Fn timespeccmp "struct timespec *a" "struct timespec *b" CMP
+.Fn timespeccmp "const struct timespec *a" "const struct timespec *b" CMP
 .Sh DESCRIPTION
 These macros are provided for manipulating the
 .Fa timeval

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Tue Feb 23 09:28:00 UTC 2021

Modified Files:
src/share/man/man3: timeradd.3

Log Message:
Fix timespeccmp declaration.

>From Kouichi Hashikawa in PR 56010.


To generate a diff of this commit:
cvs rdiff -u -r1.8 -r1.9 src/share/man/man3/timeradd.3

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/man3/timeradd.3
diff -u src/share/man/man3/timeradd.3:1.8 src/share/man/man3/timeradd.3:1.9
--- src/share/man/man3/timeradd.3:1.8	Mon Jun  7 18:40:16 2010
+++ src/share/man/man3/timeradd.3	Tue Feb 23 09:28:00 2021
@@ -1,4 +1,4 @@
-.\" $NetBSD: timeradd.3,v 1.8 2010/06/07 18:40:16 jruoho Exp $
+.\" $NetBSD: timeradd.3,v 1.9 2021/02/23 09:28:00 wiz Exp $
 .\"
 .\" Copyright (c) 2009 Jukka Ruohonen 
 .\" Copyright (c) 1999 Kelly Yancey 
@@ -59,7 +59,7 @@
 .Ft int
 .Fn timespecisset "struct timespec *ts"
 .Ft int
-.Fn timespeccmp "struct timespec *a" "struct timespec b" CMP
+.Fn timespeccmp "struct timespec *a" "struct timespec *b" CMP
 .Sh DESCRIPTION
 These macros are provided for manipulating the
 .Fa timeval

CVS commit: src/share/man/man3

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Mon Jun  8 17:28:10 UTC 2020

Modified Files:
src/share/man/man3: bits.3 types.3

Log Message:
Pp before Bl


To generate a diff of this commit:
cvs rdiff -u -r1.18 -r1.19 src/share/man/man3/bits.3
cvs rdiff -u -r1.6 -r1.7 src/share/man/man3/types.3

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/man3/bits.3
diff -u src/share/man/man3/bits.3:1.18 src/share/man/man3/bits.3:1.19
--- src/share/man/man3/bits.3:1.18	Mon Jul  3 21:30:58 2017
+++ src/share/man/man3/bits.3	Mon Jun  8 17:28:10 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: bits.3,v 1.18 2017/07/03 21:30:58 wiz Exp $
+.\"	$NetBSD: bits.3,v 1.19 2020/06/08 17:28:10 sevan Exp $
 .\"
 .\" Copyright (c) 2006, 2010 David Young.  All rights reserved.
 .\"
@@ -58,7 +58,6 @@ Use
 and
 .Fn __BITS
 to define bitmasks:
-.Pp
 .Bl -tag -width __BITS -offset indent
 .It Fn __BIT "n"
 Return a bitmask with bit
@@ -82,7 +81,6 @@ The least significant bit is bit 0.
 and
 .Fn __SHIFTOUT_MASK
 help read and write bitfields from words:
-.Pp
 .Bl -tag -width __SHIFTOUT_MASK -offset indent
 .It Fn __SHIFTIN "v" "mask"
 Left-shift bits

Index: src/share/man/man3/types.3
diff -u src/share/man/man3/types.3:1.6 src/share/man/man3/types.3:1.7
--- src/share/man/man3/types.3:1.6	Sun Apr 10 10:02:34 2011
+++ src/share/man/man3/types.3	Mon Jun  8 17:28:10 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: types.3,v 1.6 2011/04/10 10:02:34 jruoho Exp $
+.\"	$NetBSD: types.3,v 1.7 2020/06/08 17:28:10 sevan Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -79,7 +79,6 @@ and provides additional types as well as
 .Xr param 3 ) .
 .Ss Standard Types
 The following standards-compliant system data types are defined:
-.Pp
 .Bl -column -offset indent \
 "suseconds_t " "process and process group IDs " "clock_settime(3) "
 .It Sy Type Ta Sy Typical use Ta Sy Example

CVS commit: src/share/man/man3

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Mon Jan 13 16:11:54 UTC 2020

Modified Files:
src/share/man/man3: bitops.3

Log Message:
Sort the list.  Minor markup and wording tweaks.


To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/share/man/man3/bitops.3

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/man3/bitops.3
diff -u src/share/man/man3/bitops.3:1.5 src/share/man/man3/bitops.3:1.6
--- src/share/man/man3/bitops.3:1.5	Fri Dec 16 17:20:52 2016
+++ src/share/man/man3/bitops.3	Mon Jan 13 16:11:53 2020
@@ -1,4 +1,4 @@
-.\" $NetBSD: bitops.3,v 1.5 2016/12/16 17:20:52 abhinav Exp $
+.\" $NetBSD: bitops.3,v 1.6 2020/01/13 16:11:53 uwe Exp $
 .\"
 .\" Copyright (c) 2011 Jukka Ruohonen 
 .\" All rights reserved.
@@ -35,22 +35,22 @@
 .Sh DESCRIPTION
 The
 .In sys/bitops.h
-header includes macros and
-.Em static inline
+header provides macros and
+.Vt static inline
 functions related to bits and integers.
 Among these are:
-.Bl -tag -width "fast_divide32(3) " -offset indent
+.Bl -tag -width ".Xr fast_divide32 3" -offset indent
 .It Xr bitmap 3
 bitmap manipulation macros
+.It Xr fast_divide32 3
+a function for fast 32-bit division
 .It Xr ffs32 3
-functions to find the first and last bit in integers of type
+functions to find the first and last set bit in integers of type
 .Vt uint32_t
 and
 .Vt uint64_t
 .It Xr ilog2 3
 a macro for binary logarithm
-.It Xr fast_divide32 3
-a function for fast 32-bit division
 .El
 .Sh SEE ALSO
 .Xr bits 3 ,

CVS commit: src/share/man/man3

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Mon Jan 13 16:01:37 UTC 2020

Modified Files:
src/share/man/man3: dlfcn.3

Log Message:
Oops.  Restore the dot lost in -width ".Dv ..."


To generate a diff of this commit:
cvs rdiff -u -r1.38 -r1.39 src/share/man/man3/dlfcn.3

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/man3/dlfcn.3
diff -u src/share/man/man3/dlfcn.3:1.38 src/share/man/man3/dlfcn.3:1.39
--- src/share/man/man3/dlfcn.3:1.38	Mon Jan 13 15:59:11 2020
+++ src/share/man/man3/dlfcn.3	Mon Jan 13 16:01:37 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlfcn.3,v 1.38 2020/01/13 15:59:11 uwe Exp $
+.\"	$NetBSD: dlfcn.3,v 1.39 2020/01/13 16:01:37 uwe Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -104,7 +104,7 @@ The
 .Fa mode
 parameter specifies symbol resolution time and symbol visibility.
 One of the following values may be used to specify symbol resolution time:
-.Bl -tag -width "Dv RTLD_NODELETE" -offset indent
+.Bl -tag -width ".Dv RTLD_NODELETE" -offset indent
 .It Dv RTLD_NOW
 Symbols are resolved immediately.
 .It Dv RTLD_LAZY
@@ -113,7 +113,7 @@ This is the default value if resolution 
 .El
 .Pp
 One of the following values may be used to specify symbol visibility:
-.Bl -tag -width "Dv RTLD_NODELETE" -offset indent
+.Bl -tag -width ".Dv RTLD_NODELETE" -offset indent
 .It Dv RTLD_GLOBAL
 The object's symbols and the symbols of its dependencies will be visible to
 other objects.
@@ -135,7 +135,7 @@ then it is promoted to
 Additionally, one of the following flags may be ORed into the
 .Fa mode
 argument:
-.Bl -tag -width "Dv RTLD_NODELETE" -offset indent
+.Bl -tag -width ".Dv RTLD_NODELETE" -offset indent
 .It Dv RTLD_NODELETE
 Prevents unload of the loaded object on
 .Fn dlclose .

CVS commit: src/share/man/man3

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Mon Jan 13 15:59:12 UTC 2020

Modified Files:
src/share/man/man3: dlfcn.3

Log Message:
Fix -width in the tagged list of special "handle" values.


To generate a diff of this commit:
cvs rdiff -u -r1.37 -r1.38 src/share/man/man3/dlfcn.3

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/man3/dlfcn.3
diff -u src/share/man/man3/dlfcn.3:1.37 src/share/man/man3/dlfcn.3:1.38
--- src/share/man/man3/dlfcn.3:1.37	Mon Jan 13 15:54:48 2020
+++ src/share/man/man3/dlfcn.3	Mon Jan 13 15:59:11 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlfcn.3,v 1.37 2020/01/13 15:54:48 uwe Exp $
+.\"	$NetBSD: dlfcn.3,v 1.38 2020/01/13 15:59:11 uwe Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -209,7 +209,7 @@ The following special
 .Fa handle
 values may be used with
 .Fn dlsym :
-.Bl -tag -width "RTLD_DEFAULTXX" -offset indent
+.Bl -tag -width ".Dv RTLD_DEFAULT" -offset indent
 .It Dv NULL
 Interpreted as a reference to the executable or shared object
 from which the call is being made.

CVS commit: src/share/man/man3

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Mon Jan 13 15:54:48 UTC 2020

Modified Files:
src/share/man/man3: dlfcn.3

Log Message:
Minor tweaks.

Use same -indent for lists of values that are OR'ed as one argument.
Use consistent markup for dli_* member names.
Untabify Dl_info definition so that it lines up in PS output.


To generate a diff of this commit:
cvs rdiff -u -r1.36 -r1.37 src/share/man/man3/dlfcn.3

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/man3/dlfcn.3
diff -u src/share/man/man3/dlfcn.3:1.36 src/share/man/man3/dlfcn.3:1.37
--- src/share/man/man3/dlfcn.3:1.36	Mon Jan 13 11:44:02 2020
+++ src/share/man/man3/dlfcn.3	Mon Jan 13 15:54:48 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlfcn.3,v 1.36 2020/01/13 11:44:02 wiz Exp $
+.\"	$NetBSD: dlfcn.3,v 1.37 2020/01/13 15:54:48 uwe Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -104,7 +104,7 @@ The
 .Fa mode
 parameter specifies symbol resolution time and symbol visibility.
 One of the following values may be used to specify symbol resolution time:
-.Bl -tag -width "RTLD_GLOBALXX" -offset indent
+.Bl -tag -width "Dv RTLD_NODELETE" -offset indent
 .It Dv RTLD_NOW
 Symbols are resolved immediately.
 .It Dv RTLD_LAZY
@@ -113,7 +113,7 @@ This is the default value if resolution 
 .El
 .Pp
 One of the following values may be used to specify symbol visibility:
-.Bl -tag -width "RTLD_GLOBALXX" -offset indent
+.Bl -tag -width "Dv RTLD_NODELETE" -offset indent
 .It Dv RTLD_GLOBAL
 The object's symbols and the symbols of its dependencies will be visible to
 other objects.
@@ -135,12 +135,12 @@ then it is promoted to
 Additionally, one of the following flags may be ORed into the
 .Fa mode
 argument:
-.Bl -tag -width "RTLD_NODELETEXX" -offset indent
+.Bl -tag -width "Dv RTLD_NODELETE" -offset indent
 .It Dv RTLD_NODELETE
 Prevents unload of the loaded object on
 .Fn dlclose .
 The same behaviour may be requested by
-.Fl "z nodelete"
+.Fl z Cm nodelete
 option of the static linker
 .Xr ld 1 .
 .It Dv RTLD_NOLOAD
@@ -256,10 +256,10 @@ as mapped in the process address space \
 the value passed in the first argument
 .Fa addr .
 The symbols of a shared object are only eligible if
-.Va addr
+.Fa addr
 is between the base address of the shared object and the value of the
 symbol
-.Dq _end
+.Va _end
 in the same shared object.
 If no object for which this condition holds
 true can be found,
@@ -272,23 +272,23 @@ and the shared object it is contained in
 The
 .Fa dli
 argument points at a caller-provided
-.Va Dl_info
+.Vt Dl_info
 structure defined as follows:
 .Bd -literal -offset indent
 typedef struct {
-	const char  *dli_fname; /* File defining the symbol */
-	void	*dli_fbase; /* Base address */
-	const char  *dli_sname; /* Symbol name */
-	const void  *dli_saddr; /* Symbol address */
+const char  *dli_fname; /* File defining the symbol */
+void*dli_fbase; /* Base address */
+const char  *dli_sname; /* Symbol name */
+const void  *dli_saddr; /* Symbol address */
 } Dl_info;
 .Ed
 .Pp
 The structure members are further described as follows:
-.Bl -tag -width "dli_fnameXX"
-.It Li "dli_fname"
+.Bl -tag -width "Va"
+.It Va dli_fname
 The pathname of the shared object containing the address
 .Fa addr .
-.It Li "dli_fbase"
+.It Va dli_fbase
 The base address at which this shared object is loaded in the process
 address space.
 This may be zero if the symbol was found in the internally generated
@@ -299,9 +299,9 @@ see
 .Xr link 5
 .Pc
 which is not associated with a file.
-.It Li "dli_sname"
+.It Va dli_sname
 points at the nul-terminated name of the selected symbol
-.It Li "dli_saddr"
+.It Va dli_saddr
 is the actual address
 .Pq as it appears in the process address space
 of the symbol.

CVS commit: src/share/man/man3

[Kamil Rytarowski]

Module Name:src
Committed By:   kamil
Date:   Mon Jan 13 14:25:06 UTC 2020

Modified Files:
src/share/man/man3: dlinfo.3

Log Message:
Fix a typo


To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/share/man/man3/dlinfo.3

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/man3/dlinfo.3
diff -u src/share/man/man3/dlinfo.3:1.5 src/share/man/man3/dlinfo.3:1.6
--- src/share/man/man3/dlinfo.3:1.5	Mon Jan 13 14:24:16 2020
+++ src/share/man/man3/dlinfo.3	Mon Jan 13 14:25:06 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlinfo.3,v 1.5 2020/01/13 14:24:16 kamil Exp $
+.\"	$NetBSD: dlinfo.3,v 1.6 2020/01/13 14:25:06 kamil Exp $
 .\"
 .\" Copyright (c) 2003 Alexey Zelkin 
 .\" All rights reserved.
@@ -271,7 +271,7 @@ it first appeared in
 .Sh AUTHORS
 .An -nosplit
 The
-.Bx
+.Nx
 implementation of the
 .Fn dlinfo
 function was written by

CVS commit: src/share/man/man3

[Kamil Rytarowski]

Module Name:src
Committed By:   kamil
Date:   Mon Jan 13 14:24:16 UTC 2020

Modified Files:
src/share/man/man3: dlinfo.3

Log Message:
Correct the authorship note of dlinfo(3)


To generate a diff of this commit:
cvs rdiff -u -r1.4 -r1.5 src/share/man/man3/dlinfo.3

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/man3/dlinfo.3
diff -u src/share/man/man3/dlinfo.3:1.4 src/share/man/man3/dlinfo.3:1.5
--- src/share/man/man3/dlinfo.3:1.4	Mon Jan 13 14:10:52 2020
+++ src/share/man/man3/dlinfo.3	Mon Jan 13 14:24:16 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlinfo.3,v 1.4 2020/01/13 14:10:52 uwe Exp $
+.\"	$NetBSD: dlinfo.3,v 1.5 2020/01/13 14:24:16 kamil Exp $
 .\"
 .\" Copyright (c) 2003 Alexey Zelkin 
 .\" All rights reserved.
@@ -271,10 +271,10 @@ it first appeared in
 .Sh AUTHORS
 .An -nosplit
 The
-.Fx
+.Bx
 implementation of the
 .Fn dlinfo
-function was originally written by
+function was written by
 .An Antti Kantee Aq Mt po...@netbsd.org .
 .Pp
 The manual page for this function was written by

CVS commit: src/share/man/man3

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Mon Jan 13 14:10:52 UTC 2020

Modified Files:
src/share/man/man3: dlinfo.3

Log Message:
Miscellaneous fixes.

No space after asterisk in "type *arg".
There's no "-width indent", use something relevant instead.
Do not document the structure tag of the Link_map typedef.
Give the Link_map members a paragraph of their own for readability.
Give them a bit more breathing space in the tagged list.
Spell pooka's name correctly.

TODO: The text is pleonastic in several places ("Do foo.  On success
does foo." etc) and could use some copy editing.


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

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/man3/dlinfo.3
diff -u src/share/man/man3/dlinfo.3:1.3 src/share/man/man3/dlinfo.3:1.4
--- src/share/man/man3/dlinfo.3:1.3	Mon Jan 13 11:47:06 2020
+++ src/share/man/man3/dlinfo.3	Mon Jan 13 14:10:52 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlinfo.3,v 1.3 2020/01/13 11:47:06 wiz Exp $
+.\"	$NetBSD: dlinfo.3,v 1.4 2020/01/13 14:10:52 uwe Exp $
 .\"
 .\" Copyright (c) 2003 Alexey Zelkin 
 .\" All rights reserved.
@@ -40,7 +40,7 @@ dynamically linked program automatically
 .In link.h
 .In dlfcn.h
 .Ft int
-.Fn dlinfo "void * handle" "int request" "void * p"
+.Fn dlinfo "void *handle" "int request" "void *p"
 .Sh DESCRIPTION
 The
 .Fn dlinfo
@@ -66,19 +66,20 @@ is the value returned from
 the information returned by the
 .Fn dlinfo
 function pertains to the specified object.
-If handle is the special handle
+If
+.Fa handle
+is the special handle
 .Dv RTLD_SELF ,
 the information returned pertains to the caller itself.
 .Pp
 Possible values for the
 .Fa request
 argument are:
-.Bl -tag -width indent
+.Bl -tag -width "Dv RTLD_"
 .It Dv RTLD_DI_LINKMAP
-Retrieve the
+Retrieve the pointer to the
 .Vt Link_map
-.Pq Vt "struct link_map"
-structure pointer for the specified
+for the specified
 .Fa handle .
 On successful return, the
 .Fa p
@@ -98,6 +99,7 @@ in the same order as
 and
 .Xr dlclose 3
 are called.
+.Pp
 The
 .Vt Link_map
 structure is defined in
@@ -113,11 +115,11 @@ void*l_ld; /* Pointer to
 struct link_map *l_next,   /* linked list of mapped libs */
 *l_prev;
 .Ed
-.Bl -tag -width ".Va l_addr"
+.Bl -tag -width Va
 .It Va l_addr
 The base address of the object loaded into memory.
 .It Va l_name
-The full name of the loaded shared object.
+The absolute pathname of the loaded shared object.
 .It Va l_ld
 The address of the dynamic linking information segment
 .Pq Dv PT_DYNAMIC
@@ -273,7 +275,7 @@ The
 implementation of the
 .Fn dlinfo
 function was originally written by
-.An Antii Kantee Aq Mt po...@netbsd.org .
+.An Antti Kantee Aq Mt po...@netbsd.org .
 .Pp
 The manual page for this function was written by
 .An Alexey Zelkin Aq Mt phan...@freebsd.org

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Mon Jan 13 11:47:06 UTC 2020

Modified Files:
src/share/man/man3: dlinfo.3

Log Message:
Add missing El. Fix grammar.


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/dlinfo.3

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/man3/dlinfo.3
diff -u src/share/man/man3/dlinfo.3:1.2 src/share/man/man3/dlinfo.3:1.3
--- src/share/man/man3/dlinfo.3:1.2	Mon Jan 13 09:00:20 2020
+++ src/share/man/man3/dlinfo.3	Mon Jan 13 11:47:06 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlinfo.3,v 1.2 2020/01/13 09:00:20 kamil Exp $
+.\"	$NetBSD: dlinfo.3,v 1.3 2020/01/13 11:47:06 wiz Exp $
 .\"
 .\" Copyright (c) 2003 Alexey Zelkin 
 .\" All rights reserved.
@@ -31,7 +31,7 @@
 .Os
 .Sh NAME
 .Nm dlinfo
-.Nd information about dynamically loaded object
+.Nd information about a dynamically loaded object
 .Sh LIBRARY
 (These functions are not in a library.
 They are included in every
@@ -44,7 +44,7 @@ dynamically linked program automatically
 .Sh DESCRIPTION
 The
 .Fn dlinfo
-function provides information about dynamically loaded object.
+function provides information about a dynamically loaded object.
 The action taken by
 .Fn dlinfo
 and exact meaning and type of
@@ -194,7 +194,7 @@ structure on the link-map list.
 .\" .Vt char
 .\" pointer
 .\" .Pq Fa "char *p" .
-.\" .El
+.El
 .Sh RETURN VALUES
 The
 .Fn dlinfo
@@ -235,20 +235,20 @@ while (map != NULL) {
 .\" Dl_serinfo	 _info, *info = &_info;
 .\" Dl_serpath	*path;
 .\" unsigned int	 cnt;
-.\" 
+.\"
 .\" /* determine search path count and required buffer size */
 .\" dlinfo(RTLD_SELF, RTLD_DI_SERINFOSIZE, (void *)info);
-.\" 
+.\"
 .\" /* allocate new buffer and initialize */
 .\" info = malloc(_info.dls_size);
 .\" info->dls_size = _info.dls_size;
 .\" info->dls_cnt = _info.dls_cnt;
-.\" 
+.\"
 .\" /* obtain sarch path information */
 .\" dlinfo(RTLD_SELF, RTLD_DI_SERINFO, (void *)info);
-.\" 
+.\"
 .\" path = >dls_serpath[0];
-.\" 
+.\"
 .\" for (cnt = 1; cnt <= info->dls_cnt; cnt++, path++) {
 .\" 	(void) printf("%2d: %s\\n", cnt, path->dls_name);
 .\" }

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Mon Jan 13 11:44:02 UTC 2020

Modified Files:
src/share/man/man3: dlfcn.3

Log Message:
Clean up dash use. Remove superfluous Pp.


To generate a diff of this commit:
cvs rdiff -u -r1.35 -r1.36 src/share/man/man3/dlfcn.3

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/man3/dlfcn.3
diff -u src/share/man/man3/dlfcn.3:1.35 src/share/man/man3/dlfcn.3:1.36
--- src/share/man/man3/dlfcn.3:1.35	Mon Jan 13 09:00:59 2020
+++ src/share/man/man3/dlfcn.3	Mon Jan 13 11:44:02 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlfcn.3,v 1.35 2020/01/13 09:00:59 kamil Exp $
+.\"	$NetBSD: dlfcn.3,v 1.36 2020/01/13 11:44:02 wiz Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -113,7 +113,6 @@ This is the default value if resolution 
 .El
 .Pp
 One of the following values may be used to specify symbol visibility:
-.Pp
 .Bl -tag -width "RTLD_GLOBALXX" -offset indent
 .It Dv RTLD_GLOBAL
 The object's symbols and the symbols of its dependencies will be visible to
@@ -203,8 +202,9 @@ However, the symbols of an object's depe
 All shared objects loaded at program startup are globally visible.
 Only the symbols in the main executable that are referenced by a
 shared object at link time will be visible unless it has been linked
-with the --export-dynamic option where all of its symbols will be
-visible.
+with the
+.Fl Fl export-dynamic
+option where all of its symbols will be visible.
 The following special
 .Fa handle
 values may be used with
@@ -251,8 +251,8 @@ and the
 must match in order for the symbol to be resolved.
 .Pp
 .Fn dladdr
-examines all currently mapped shared objects for a symbol whose address --
-as mapped in the process address space -- is closest to but not exceeding
+examines all currently mapped shared objects for a symbol whose address \(em
+as mapped in the process address space \(em is closest to but not exceeding
 the value passed in the first argument
 .Fa addr .
 The symbols of a shared object are only eligible if

CVS commit: src/share/man/man3

[Kamil Rytarowski]

Module Name:src
Committed By:   kamil
Date:   Mon Jan 13 09:00:59 UTC 2020

Modified Files:
src/share/man/man3: dlfcn.3

Log Message:
Bump date in dlfcn(3)


To generate a diff of this commit:
cvs rdiff -u -r1.34 -r1.35 src/share/man/man3/dlfcn.3

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/man3/dlfcn.3
diff -u src/share/man/man3/dlfcn.3:1.34 src/share/man/man3/dlfcn.3:1.35
--- src/share/man/man3/dlfcn.3:1.34	Mon Jan 13 08:29:05 2020
+++ src/share/man/man3/dlfcn.3	Mon Jan 13 09:00:59 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlfcn.3,v 1.34 2020/01/13 08:29:05 kamil Exp $
+.\"	$NetBSD: dlfcn.3,v 1.35 2020/01/13 09:00:59 kamil Exp $
 .\"
 .\" Copyright (c) 1998 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 June 25, 2011
+.Dd January 13, 2020
 .Dt DLFCN 3
 .Os
 .Sh NAME

CVS commit: src/share/man/man3

[Kamil Rytarowski]

Module Name:src
Committed By:   kamil
Date:   Mon Jan 13 09:00:20 UTC 2020

Modified Files:
src/share/man/man3: dlinfo.3

Log Message:
Bump date in dlinfo(3)


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/share/man/man3/dlinfo.3

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/man3/dlinfo.3
diff -u src/share/man/man3/dlinfo.3:1.1 src/share/man/man3/dlinfo.3:1.2
--- src/share/man/man3/dlinfo.3:1.1	Mon Jan 13 08:25:02 2020
+++ src/share/man/man3/dlinfo.3	Mon Jan 13 09:00:20 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlinfo.3,v 1.1 2020/01/13 08:25:02 kamil Exp $
+.\"	$NetBSD: dlinfo.3,v 1.2 2020/01/13 09:00:20 kamil Exp $
 .\"
 .\" Copyright (c) 2003 Alexey Zelkin 
 .\" All rights reserved.
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD: head/lib/libc/gen/dlinfo.3 267774 2014-06-23 08:25:03Z bapt $
 .\"
-.Dd February 14, 2003
+.Dd January 13, 2020
 .Dt DLINFO 3
 .Os
 .Sh NAME

CVS commit: src/share/man/man3

[Kamil Rytarowski]

Module Name:src
Committed By:   kamil
Date:   Mon Jan 13 08:29:05 UTC 2020

Modified Files:
src/share/man/man3: dlfcn.3

Log Message:
Cross-Link from dlfcn(3) to dlinfo(3)


To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 src/share/man/man3/dlfcn.3

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/man3/dlfcn.3
diff -u src/share/man/man3/dlfcn.3:1.33 src/share/man/man3/dlfcn.3:1.34
--- src/share/man/man3/dlfcn.3:1.33	Sat Jun 25 12:44:37 2011
+++ src/share/man/man3/dlfcn.3	Mon Jan 13 08:29:05 2020
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dlfcn.3,v 1.33 2011/06/25 12:44:37 wiz Exp $
+.\"	$NetBSD: dlfcn.3,v 1.34 2020/01/13 08:29:05 kamil Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -350,6 +350,7 @@ a module that needs libpthread but isn't
 .Sh SEE ALSO
 .Xr ld 1 ,
 .Xr rtld 1 ,
+.Xr dlinfo 3 ,
 .Xr link 5
 .Sh HISTORY
 Some of the

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Fri Sep 14 20:53:49 UTC 2018

Modified Files:
src/share/man/man3: attribute.3

Log Message:
PR/53608: Ian Bruene: document __{printf,syslog}like.


To generate a diff of this commit:
cvs rdiff -u -r1.17 -r1.18 src/share/man/man3/attribute.3

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/man3/attribute.3
diff -u src/share/man/man3/attribute.3:1.17 src/share/man/man3/attribute.3:1.18
--- src/share/man/man3/attribute.3:1.17	Fri Sep 14 16:38:38 2018
+++ src/share/man/man3/attribute.3	Fri Sep 14 16:53:49 2018
@@ -1,4 +1,4 @@
-.\" $NetBSD: attribute.3,v 1.17 2018/09/14 20:38:38 joerg Exp $
+.\" $NetBSD: attribute.3,v 1.18 2018/09/14 20:53:49 christos 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 October 25, 2013
+.Dd September 14, 2018
 .Dt ATTRIBUTE 3
 .Os
 .Sh NAME
@@ -64,6 +64,10 @@
 .Fn __predict_true "exp"
 .Pp
 .Fn __predict_false "exp"
+.Pp
+.Fn __printflike "fmtarg" "firstvararg"
+.Pp
+.Fn __sysloglike "fmtarg" "firstvararg"
 .Sh DESCRIPTION
 As an extension to the C standard, some compilers allow non-standard
 attributes to be associated with functions, variables, or types, to
@@ -357,6 +361,22 @@ empirical evidence should precede the us
 .Ic __predict_false
 and
 .Ic __predict_true .
+.It Fn __printflike "fmtarg" "firstvararg"
+Marks a function as taking printf-like arguments.
+.Fa fmtarg
+is the index of the format string in the argument list, and
+.Fa firstvararg
+is the index of the first item of the vararg list.
+.It Fn __sysloglike "fmtarg" "firstvararg"
+Marks a function as taking syslog-like arguments.
+Allows use of the %m formatting code.
+.Fa fmtarg
+is the index of the format string in the argument list, and
+.Fa firstvararg
+is the index of the first item of the vararg list, or
+.Dv 0
+if the argument is a
+.Ft va_list .
 .El
 .Sh SEE ALSO
 .Xr clang 1 ,

CVS commit: src/share/man/man3

[Joerg Sonnenberger]

Module Name:src
Committed By:   joerg
Date:   Fri Sep 14 20:38:38 UTC 2018

Modified Files:
src/share/man/man3: attribute.3

Log Message:
__dead functions can not return, which is different from not returning a
value.


To generate a diff of this commit:
cvs rdiff -u -r1.16 -r1.17 src/share/man/man3/attribute.3

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/man3/attribute.3
diff -u src/share/man/man3/attribute.3:1.16 src/share/man/man3/attribute.3:1.17
--- src/share/man/man3/attribute.3:1.16	Mon Apr 21 15:52:27 2014
+++ src/share/man/man3/attribute.3	Fri Sep 14 20:38:38 2018
@@ -1,4 +1,4 @@
-.\" $NetBSD: attribute.3,v 1.16 2014/04/21 15:52:27 riastradh Exp $
+.\" $NetBSD: attribute.3,v 1.17 2018/09/14 20:38:38 joerg Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -99,10 +99,11 @@ Certain functions, such as
 .Xr abort 3
 and
 .Xr exit 3 ,
-can never return any value.
+can never return.
 When such a function is declared with
 .Ic __dead ,
-certain optimizations are possible.
+certain optimizations are possible and warnings sensitive to the code flow graph
+may be pruned.
 Obviously a
 .Ic __dead
 function can never have return type other than

CVS commit: src/share/man/man3

[Eitan Adler]

Module Name:src
Committed By:   eadler
Date:   Mon Jun 18 02:48:56 UTC 2018

Modified Files:
src/share/man/man3: queue.3

Log Message:
queue.3: deduplicate deduplicate a a word word


To generate a diff of this commit:
cvs rdiff -u -r1.59 -r1.60 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.59 src/share/man/man3/queue.3:1.60
--- src/share/man/man3/queue.3:1.59	Mon Oct  2 05:16:41 2017
+++ src/share/man/man3/queue.3	Mon Jun 18 02:48:56 2018
@@ -1,4 +1,4 @@
-.\"	$NetBSD: queue.3,v 1.59 2017/10/02 05:16:41 pgoyette Exp $
+.\"	$NetBSD: queue.3,v 1.60 2018/06/18 02:48:56 eadler Exp $
 .\"
 .\" Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -951,7 +951,7 @@ and
 .Fn TAILQ_FOREACH_REVERSE_SAFE
 traverse the tail queue referenced by
 .Fa head
-in the forward or reverse direction direction, assigning each element in turn to
+in the forward or reverse direction, assigning each element in turn to
 .Fa var .
 .Pp
 The SAFE versions use

CVS commit: src/share/man/man3

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Fri May 11 12:54:56 UTC 2018

Modified Files:
src/share/man/man3: intro.3

Log Message:
Pass through mandoc -Tlint, drop Pp before Bl.
Remove reference to libkadm, it is no longer present in NetBSD.
Direct reader to kadm5_pwcheck(3) for libkadm5srv.


To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 src/share/man/man3/intro.3

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/man3/intro.3
diff -u src/share/man/man3/intro.3:1.33 src/share/man/man3/intro.3:1.34
--- src/share/man/man3/intro.3:1.33	Sun May 21 14:24:05 2017
+++ src/share/man/man3/intro.3	Fri May 11 12:54:56 2018
@@ -1,4 +1,4 @@
-.\"	$NetBSD: intro.3,v 1.33 2017/05/21 14:24:05 riastradh Exp $
+.\"	$NetBSD: intro.3,v 1.34 2018/05/11 12:54:56 sevan Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)intro.3	8.1 (Berkeley) 6/5/93
 .\"
-.Dd November 22, 2015
+.Dd May 11, 2018
 .Dt INTRO 3
 .Os
 .Sh NAME
@@ -71,7 +71,6 @@ it is not necessary to supply the linker
 for these functions.
 There are several subsystems included inside
 .Em libc :
-.Pp
 .Bl -tag -width "XX"
 .It standard I/O routines
 see
@@ -177,12 +176,12 @@ See
 .Xr ipsec_set_policy 3
 and
 .Xr ipsec_strerror 3 .
-.It Em libkadm Pq Fl l Ns Ar kadm
-The Kerberos IV administration server and client library.
 .It Em libkadm5clnt Pq Fl l Ns Ar kadm5clnt
 The Kerberos 5 administration client library.
 .It Em libkadm5srv Pq Fl l Ns Ar kadm5srv
 The Kerberos 5 administration server library.
+See
+.Xr kadm5_pwcheck 3 .
 .It Em libkafs Pq Fl l Ns Ar kafs
 The Kerberos IV AFS library.
 See

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Thu Mar  8 06:47:30 UTC 2018

Modified Files:
src/share/man/man3: bitmap.3

Log Message:
Bump date for previous.


To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/share/man/man3/bitmap.3

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/man3/bitmap.3
diff -u src/share/man/man3/bitmap.3:1.11 src/share/man/man3/bitmap.3:1.12
--- src/share/man/man3/bitmap.3:1.11	Thu Mar  8 05:50:13 2018
+++ src/share/man/man3/bitmap.3	Thu Mar  8 06:47:30 2018
@@ -1,4 +1,4 @@
-.\"	$NetBSD: bitmap.3,v 1.11 2018/03/08 05:50:13 martin Exp $
+.\"	$NetBSD: bitmap.3,v 1.12 2018/03/08 06:47:30 wiz Exp $
 .\"
 .\" Copyright (c) 2012 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 December 6, 2012
+.Dd March 8, 2018
 .Dt BITMAP 3
 .Os
 .Sh NAME

CVS commit: src/share/man/man3

[Martin Husemann]

Module Name:src
Committed By:   martin
Date:   Thu Mar  8 05:50:14 UTC 2018

Modified Files:
src/share/man/man3: bitmap.3

Log Message:
__BITMAP_ZERO() only takes the pointer to the bitmap as an argument


To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/share/man/man3/bitmap.3

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/man3/bitmap.3
diff -u src/share/man/man3/bitmap.3:1.10 src/share/man/man3/bitmap.3:1.11
--- src/share/man/man3/bitmap.3:1.10	Mon Jul  3 21:30:58 2017
+++ src/share/man/man3/bitmap.3	Thu Mar  8 05:50:13 2018
@@ -1,4 +1,4 @@
-.\"	$NetBSD: bitmap.3,v 1.10 2017/07/03 21:30:58 wiz Exp $
+.\"	$NetBSD: bitmap.3,v 1.11 2018/03/08 05:50:13 martin Exp $
 .\"
 .\" Copyright (c) 2012 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -106,7 +106,7 @@ that holds
 and is named
 .Fa name .
 .Pp
-.Fn __BITMAP_ZERO bit bitmap
+.Fn __BITMAP_ZERO bitmap
 initializes a descriptor set pointed to by
 .Fa bitmap
 to the null set.

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Mon Nov 13 09:11:16 UTC 2017

Modified Files:
src/share/man/man3: __insn_barrier.3

Log Message:
Remove Tn.


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

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/man3/__insn_barrier.3
diff -u src/share/man/man3/__insn_barrier.3:1.3 src/share/man/man3/__insn_barrier.3:1.4
--- src/share/man/man3/__insn_barrier.3:1.3	Sun Nov 12 21:15:22 2017
+++ src/share/man/man3/__insn_barrier.3	Mon Nov 13 09:11:16 2017
@@ -1,4 +1,4 @@
-.\" $NetBSD: __insn_barrier.3,v 1.3 2017/11/12 21:15:22 riastradh Exp $
+.\" $NetBSD: __insn_barrier.3,v 1.4 2017/11/13 09:11:16 wiz Exp $
 .\"
 .\" Copyright (c) 2010 Jukka Ruohonen 
 .\" All rights reserved.
@@ -37,9 +37,7 @@
 .Sh DESCRIPTION
 The
 .Fn __insn_barrier
-macro prevents
-.Tn GCC
-from moving code across the barrier.
+macro prevents GCC from moving code across the barrier.
 In other words, the compiler is not allowed to reorder read and write
 commands below the barrier with the code preceding the barrier.
 Like with the

CVS commit: src/share/man/man3

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Sun Nov 12 21:15:22 UTC 2017

Modified Files:
src/share/man/man3: __insn_barrier.3

Log Message:
Replace xref mb(9) by xref membar_ops(3).


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/__insn_barrier.3

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/man3/__insn_barrier.3
diff -u src/share/man/man3/__insn_barrier.3:1.2 src/share/man/man3/__insn_barrier.3:1.3
--- src/share/man/man3/__insn_barrier.3:1.2	Sun Jan  2 07:14:02 2011
+++ src/share/man/man3/__insn_barrier.3	Sun Nov 12 21:15:22 2017
@@ -1,4 +1,4 @@
-.\" $NetBSD: __insn_barrier.3,v 1.2 2011/01/02 07:14:02 jruoho Exp $
+.\" $NetBSD: __insn_barrier.3,v 1.3 2017/11/12 21:15:22 riastradh Exp $
 .\"
 .\" Copyright (c) 2010 Jukka Ruohonen 
 .\" All rights reserved.
@@ -51,7 +51,7 @@ from misoptimizing.
 .Sh SEE ALSO
 .Xr gcc 1 ,
 .Xr cdefs 3 ,
-.Xr mb 9
+.Xr membar_ops 3
 .Rs
 .%A Paul E. McKenney
 .%T Memory Barriers: a Hardware View for Software Hackers

CVS commit: src/share/man/man3

[Paul Goyette]

Module Name:src
Committed By:   pgoyette
Date:   Mon Oct  2 05:16:41 UTC 2017

Modified Files:
src/share/man/man3: queue.3

Log Message:
Update for new signature for LIST_MOVE()


To generate a diff of this commit:
cvs rdiff -u -r1.58 -r1.59 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.58 src/share/man/man3/queue.3:1.59
--- src/share/man/man3/queue.3:1.58	Tue Aug  8 03:58:43 2017
+++ src/share/man/man3/queue.3	Mon Oct  2 05:16:41 2017
@@ -1,4 +1,4 @@
-.\"	$NetBSD: queue.3,v 1.58 2017/08/08 03:58:43 isaki Exp $
+.\"	$NetBSD: queue.3,v 1.59 2017/10/02 05:16:41 pgoyette Exp $
 .\"
 .\" Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -53,7 +53,7 @@
 .\"
 .\"	@(#)queue.3	8.1 (Berkeley) 12/13/93
 .\"
-.Dd October 15, 2016
+.Dd October 1, 2017
 .Dt QUEUE 3
 .Os
 .Sh NAME
@@ -177,7 +177,7 @@
 .Fn LIST_INSERT_HEAD "LIST_HEAD *head" "TYPE *elm" "LIST_ENTRY NAME"
 .Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME"
 .Fn LIST_REPLACE "TYPE *elm" "TYPE *new" "LIST_ENTRY NAME"
-.Fn LIST_MOVE "LIST_HEAD *head1" "LIST_HEAD *head2"
+.Fn LIST_MOVE "LIST_HEAD *head1" "LIST_HEAD *head2" "LIST_ENTRY NAME"
 .Pp
 .Fn SIMPLEQ_HEAD "HEADNAME" "TYPE"
 .Fn SIMPLEQ_HEAD_INITIALIZER "head"

CVS commit: src/share/man/man3

[Tetsuya Isaki]

Module Name:src
Committed By:   isaki
Date:   Tue Aug  8 03:58:43 UTC 2017

Modified Files:
src/share/man/man3: queue.3

Log Message:
s/tail queue/simple queue/ in SIMPLE QUEUES section.


To generate a diff of this commit:
cvs rdiff -u -r1.57 -r1.58 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.57 src/share/man/man3/queue.3:1.58
--- src/share/man/man3/queue.3:1.57	Mon Jul  3 21:30:58 2017
+++ src/share/man/man3/queue.3	Tue Aug  8 03:58:43 2017
@@ -1,4 +1,4 @@
-.\"	$NetBSD: queue.3,v 1.57 2017/07/03 21:30:58 wiz Exp $
+.\"	$NetBSD: queue.3,v 1.58 2017/08/08 03:58:43 isaki Exp $
 .\"
 .\" Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -764,13 +764,13 @@ returns the element after the element
 .Pp
 The macro
 .Fn SIMPLEQ_LAST
-returns the last item on the tail queue.
-If the tail queue is empty the return value is
+returns the last item on the simple queue.
+If the simple queue is empty the return value is
 .Dv NULL .
 .Pp
 The macro
 .Fn SIMPLEQ_FOREACH
-traverses the tail queue referenced by
+traverses the simple queue referenced by
 .Fa head
 in the forward direction, assigning each element
 in turn to
@@ -832,7 +832,7 @@ from the simple queue.
 .Pp
 The macro
 .Fn SIMPLEQ_CONCAT
-concatenates the tail queue headed by
+concatenates the simple queue headed by
 .Fa head2
 onto the end of the one headed by
 .Fa head1 ,

CVS commit: src/share/man/man3

[Abhinav Upadhyay]

Module Name:src
Committed By:   abhinav
Date:   Tue Apr 25 06:08:24 UTC 2017

Modified Files:
src/share/man/man3: queue.3

Log Message:
Use Fn instead of Nm to refer the macros in the body of the man page.

Thanks to wiz@ for reviewing.


To generate a diff of this commit:
cvs rdiff -u -r1.55 -r1.56 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.55 src/share/man/man3/queue.3:1.56
--- src/share/man/man3/queue.3:1.55	Sat Apr 22 22:36:00 2017
+++ src/share/man/man3/queue.3	Tue Apr 25 06:08:24 2017
@@ -1,4 +1,4 @@
-.\"	$NetBSD: queue.3,v 1.55 2017/04/22 22:36:00 abhinav Exp $
+.\"	$NetBSD: queue.3,v 1.56 2017/04/25 06:08:24 abhinav Exp $
 .\"
 .\" Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -406,7 +406,7 @@ _CONCAT:-:-:+:+:+
 .TE
 .Sh SINGLY-LINKED LISTS
 A singly-linked list is headed by a structure defined by the
-.Nm SLIST_HEAD
+.Fn SLIST_HEAD
 macro.
 This structure contains a single pointer to the first element
 on the list.
@@ -438,28 +438,28 @@ and
 are user selectable.)
 .Pp
 The macro
-.Nm SLIST_HEAD_INITIALIZER
+.Fn SLIST_HEAD_INITIALIZER
 evaluates to an initializer for the list
 .Fa head .
 .Pp
 The macro
-.Nm SLIST_ENTRY
+.Fn SLIST_ENTRY
 declares a structure that connects the elements in
 the list.
 .Pp
 The macro
-.Nm SLIST_FIRST
+.Fn SLIST_FIRST
 returns the first element in the list or NULL if the list is empty.
 .Pp
 The macro
-.Nm SLIST_EMPTY
+.Fn SLIST_EMPTY
 evaluates to true if there are no elements in the list.
 .Pp
 The macro
-.Nm SLIST_NEXT
+.Fn SLIST_NEXT
 returns the next element in the list.
 .Pp
-.Nm SLIST_FOREACH
+.Fn SLIST_FOREACH
 traverses the list referenced by
 .Fa head
 in the forward direction, assigning each element in
@@ -473,45 +473,45 @@ to hold the next element, so
 may be freed or removed from the list.
 .Pp
 The macro
-.Nm SLIST_INIT
+.Fn SLIST_INIT
 initializes the list referenced by
 .Fa head .
 .Pp
 The macro
-.Nm SLIST_INSERT_HEAD
+.Fn SLIST_INSERT_HEAD
 inserts the new element
 .Fa elm
 at the head of the list.
 .Pp
 The macro
-.Nm SLIST_INSERT_AFTER
+.Fn SLIST_INSERT_AFTER
 inserts the new element
 .Fa elm
 after the element
 .Fa listelm .
 .Pp
 The macro
-.Nm SLIST_REMOVE
+.Fn SLIST_REMOVE
 removes the element
 .Fa elm
 from the list.
 .Pp
 The macro
-.Nm SLIST_REMOVE_HEAD
+.Fn SLIST_REMOVE_HEAD
 removes the first element from the head of the list.
 For optimum efficiency,
 elements being removed from the head of the list should explicitly use
 this macro instead of the generic
-.Nm SLIST_REMOVE
+.Fn SLIST_REMOVE
 macro.
 .Pp
 The macro
-.Nm SLIST_REMOVE_AFTER
+.Fn SLIST_REMOVE_AFTER
 removes the element after the one specified.
 For optimum efficiency,
 elements being removed after a specified one should explicitly use
 this macro instead of the generic
-.Nm SLIST_REMOVE
+.Fn SLIST_REMOVE
 .Sh SINGLY-LINKED LIST EXAMPLE
 .Bd -literal
 SLIST_HEAD(slisthead, entry) head =
@@ -549,7 +549,7 @@ while (!SLIST_EMPTY(\*[Am]head)) {  
 .Ed
 .Sh LISTS
 A list is headed by a structure defined by the
-.Nm LIST_HEAD
+.Fn LIST_HEAD
 macro.
 This structure contains a single pointer to the first element
 on the list.
@@ -581,12 +581,12 @@ and
 are user selectable.)
 .Pp
 The macro
-.Nm LIST_ENTRY
+.Fn LIST_ENTRY
 declares a structure that connects the elements in
 the list.
 .Pp
 The macro
-.Nm LIST_HEAD_INITIALIZER
+.Fn LIST_HEAD_INITIALIZER
 provides a value which can be used to initialize a list head at
 compile time, and is used at the point that the list head
 variable is declared, like:
@@ -595,23 +595,23 @@ struct HEADNAME head = LIST_HEAD_INITIAL
 .Ed
 .Pp
 The macro
-.Nm LIST_FIRST
+.Fn LIST_FIRST
 returns the first element of the list
 .Fa head .
 .Pp
 The macro
-.Nm LIST_EMPTY
+.Fn LIST_EMPTY
 returns true if the list
 .Fa head
 has no elements.
 .Pp
 The macro
-.Nm LIST_NEXT
+.Fn LIST_NEXT
 returns the element after the element
 .Fa elm .
 .Pp
 The macro
-.Nm LIST_FOREACH
+.Fn LIST_FOREACH
 traverses the list referenced by
 .Fa head
 in the forward direction, assigning each element in turn to
@@ -624,38 +624,38 @@ to hold the next element, so
 may be freed or removed from the list.
 .Pp
 The macro
-.Nm LIST_INIT
+.Fn LIST_INIT
 initializes the list referenced by
 .Fa head .
 .Pp
 The macro
-.Nm LIST_INSERT_AFTER
+.Fn LIST_INSERT_AFTER
 inserts the new element
 .Fa elm
 after the element
 .Fa listelm .
 .Pp
 The macro
-.Nm LIST_INSERT_BEFORE
+.Fn LIST_INSERT_BEFORE
 inserts the new element
 .Fa elm
 before the element
 .Fa listelm .
 .Pp
 The macro
-.Nm LIST_INSERT_HEAD
+.Fn LIST_INSERT_HEAD
 inserts the new element
 .Fa elm
 at the head of the list.
 .Pp
 The macro
-.Nm LIST_REMOVE
+.Fn LIST_REMOVE
 removes the element
 .Fa elm
 from the list.
 .Pp
 The macro
-.Nm LIST_REPLACE
+.Fn LIST_REPLACE
 replaces the element
 .Fa 

CVS commit: src/share/man/man3

[Abhinav Upadhyay]

Module Name:src
Committed By:   abhinav
Date:   Sat Apr 22 22:36:00 UTC 2017

Modified Files:
src/share/man/man3: queue.3

Log Message:
Remove comma after the last Nm entry.


To generate a diff of this commit:
cvs rdiff -u -r1.54 -r1.55 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.54 src/share/man/man3/queue.3:1.55
--- src/share/man/man3/queue.3:1.54	Sat Oct 15 16:31:16 2016
+++ src/share/man/man3/queue.3	Sat Apr 22 22:36:00 2017
@@ -1,4 +1,4 @@
-.\"	$NetBSD: queue.3,v 1.54 2016/10/15 16:31:16 jdolecek Exp $
+.\"	$NetBSD: queue.3,v 1.55 2017/04/22 22:36:00 abhinav Exp $
 .\"
 .\" Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -138,7 +138,7 @@
 .Nm STAILQ_INSERT_TAIL ,
 .Nm STAILQ_REMOVE_HEAD ,
 .Nm STAILQ_REMOVE ,
-.Nm STAILQ_CONCAT ,
+.Nm STAILQ_CONCAT
 .Nd implementations of singly-linked lists, lists, simple queues, tail queues, and singly-linked tail queues
 .Sh SYNOPSIS
 .In sys/queue.h

CVS commit: src/share/man/man3

[Abhinav Upadhyay]

Module Name:src
Committed By:   abhinav
Date:   Fri Dec 16 17:20:52 UTC 2016

Modified Files:
src/share/man/man3: bitops.3

Log Message:
Fix sentence.


To generate a diff of this commit:
cvs rdiff -u -r1.4 -r1.5 src/share/man/man3/bitops.3

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/man3/bitops.3
diff -u src/share/man/man3/bitops.3:1.4 src/share/man/man3/bitops.3:1.5
--- src/share/man/man3/bitops.3:1.4	Tue Dec  4 06:57:45 2012
+++ src/share/man/man3/bitops.3	Fri Dec 16 17:20:52 2016
@@ -1,4 +1,4 @@
-.\" $NetBSD: bitops.3,v 1.4 2012/12/04 06:57:45 jruoho Exp $
+.\" $NetBSD: bitops.3,v 1.5 2016/12/16 17:20:52 abhinav Exp $
 .\"
 .\" Copyright (c) 2011 Jukka Ruohonen 
 .\" All rights reserved.
@@ -37,7 +37,7 @@ The
 .In sys/bitops.h
 header includes macros and
 .Em static inline
-functions related bits and integers.
+functions related to bits and integers.
 Among these are:
 .Bl -tag -width "fast_divide32(3) " -offset indent
 .It Xr bitmap 3

CVS commit: src/share/man/man3

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Mon Nov  7 03:12:54 UTC 2016

Modified Files:
src/share/man/man3: bits.3

Log Message:
These have been able to handle uintmax-width masks since creation.

XXX pullup-6
XXX pullup-7


To generate a diff of this commit:
cvs rdiff -u -r1.16 -r1.17 src/share/man/man3/bits.3

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/man3/bits.3
diff -u src/share/man/man3/bits.3:1.16 src/share/man/man3/bits.3:1.17
--- src/share/man/man3/bits.3:1.16	Tue Mar 18 18:20:39 2014
+++ src/share/man/man3/bits.3	Mon Nov  7 03:12:54 2016
@@ -1,4 +1,4 @@
-.\"	$NetBSD: bits.3,v 1.16 2014/03/18 18:20:39 riastradh Exp $
+.\"	$NetBSD: bits.3,v 1.17 2016/11/07 03:12:54 riastradh Exp $
 .\"
 .\" Copyright (c) 2006, 2010 David Young.  All rights reserved.
 .\"
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd October 17, 2012
+.Dd November 6, 2016
 .Dt BITS 3
 .Os
 .Sh NAME
@@ -146,8 +146,3 @@ contributed the macro names
 .Fn SHIFTIN
 and
 .Fn SHIFTOUT .
-.Sh BUGS
-.Fn __BIT
-and
-.Fn __BITS
-can only express 32-bit bitmasks.

CVS commit: src/share/man/man3

[Jaromir Dolecek]

Module Name:src
Committed By:   jdolecek
Date:   Sat Oct 15 16:31:16 UTC 2016

Modified Files:
src/share/man/man3: queue.3

Log Message:
fix tyop


To generate a diff of this commit:
cvs rdiff -u -r1.53 -r1.54 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.53 src/share/man/man3/queue.3:1.54
--- src/share/man/man3/queue.3:1.53	Tue May 31 08:24:43 2016
+++ src/share/man/man3/queue.3	Sat Oct 15 16:31:16 2016
@@ -1,4 +1,4 @@
-.\"	$NetBSD: queue.3,v 1.53 2016/05/31 08:24:43 wiz Exp $
+.\"	$NetBSD: queue.3,v 1.54 2016/10/15 16:31:16 jdolecek Exp $
 .\"
 .\" Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -53,7 +53,7 @@
 .\"
 .\"	@(#)queue.3	8.1 (Berkeley) 12/13/93
 .\"
-.Dd May 31, 2016
+.Dd October 15, 2016
 .Dt QUEUE 3
 .Os
 .Sh NAME
@@ -812,7 +812,7 @@ removes the first element from the head 
 For optimum efficiency,
 elements being removed from the head of the queue should explicitly use
 this macro instead of the generic
-.Nm SIMPLQ_REMOVE
+.Nm SIMPLEQ_REMOVE
 macro.
 .Pp
 The macro
@@ -821,7 +821,7 @@ removes the element after the one specif
 For optimum efficiency,
 elements being removed after specified elements should explicitly use
 this macro instead of the generic
-.Nm SIMPLQ_REMOVE
+.Nm SIMPLEQ_REMOVE
 macro.
 .Pp
 The macro

CVS commit: src/share/man/man3

[David A. Holland]

Module Name:src
Committed By:   dholland
Date:   Tue Aug 30 05:12:00 UTC 2016

Modified Files:
src/share/man/man3: rbtree.3

Log Message:
Use only "function" for the comparison functions, not both that and
"operator". Noted by riastradh.


To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/share/man/man3/rbtree.3

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/man3/rbtree.3
diff -u src/share/man/man3/rbtree.3:1.11 src/share/man/man3/rbtree.3:1.12
--- src/share/man/man3/rbtree.3:1.11	Mon Aug 29 03:50:05 2016
+++ src/share/man/man3/rbtree.3	Tue Aug 30 05:12:00 2016
@@ -1,4 +1,4 @@
-.\" $NetBSD: rbtree.3,v 1.11 2016/08/29 03:50:05 dholland Exp $
+.\" $NetBSD: rbtree.3,v 1.12 2016/08/30 05:12:00 dholland Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -81,7 +81,7 @@ The maximum height of a red-black tree i
 A red-black tree.
 .It Vt typedef signed int \
 (* rbto_compare_nodes_fn)(void *context, const void *node1, const void *node2);
-The node-comparison operator.
+The node-comparison function.
 Defines an ordering on nodes.
 Returns a negative value if the first node
 .Ar node1
@@ -98,7 +98,7 @@ and the second node
 are identical according to the ordering.
 .It Vt typedef signed int \
 (* rbto_compare_key_fn)(void *context, const void *node, const void *key);
-The node-key comparison operator.
+The node-key comparison function.
 Defines the order of nodes and keys.
 Returns a negative value if the node
 .Ar node
@@ -114,8 +114,8 @@ is identical to the key
 .Ar key
 according to the ordering.
 .It Vt rb_tree_ops_t
-Defines the operator for comparing two nodes in the same tree,
-the operator for comparing a node in the tree with a key,
+Defines the function for comparing two nodes in the same tree,
+the function for comparing a node in the tree with a key,
 the offset of member
 .Vt rb_node_t
 within the node type,
@@ -146,7 +146,7 @@ member.)
 .It Fn rb_tree_init "rbt" "ops"
 Initialize the red-black tree
 .Fa rbt .
-Let the comparison operators given by
+Let the comparison functions given by
 .Fa ops
 define the order of nodes in the tree for
 the purposes of insertion, search, and iteration.

CVS commit: src/share/man/man3

[David A. Holland]

Module Name:src
Committed By:   dholland
Date:   Mon Aug 29 03:50:05 UTC 2016

Modified Files:
src/share/man/man3: rbtree.3

Log Message:
Clarify the usage, so hopefully nobody else makes the set of wrong
assumptions I just did.


To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/share/man/man3/rbtree.3

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/man3/rbtree.3
diff -u src/share/man/man3/rbtree.3:1.10 src/share/man/man3/rbtree.3:1.11
--- src/share/man/man3/rbtree.3:1.10	Tue Mar 18 18:20:39 2014
+++ src/share/man/man3/rbtree.3	Mon Aug 29 03:50:05 2016
@@ -1,4 +1,4 @@
-.\" $NetBSD: rbtree.3,v 1.10 2014/03/18 18:20:39 riastradh Exp $
+.\" $NetBSD: rbtree.3,v 1.11 2016/08/29 03:50:05 dholland 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 13, 2013
+.Dd August 29, 2016
 .Dt RBTREE 3
 .Os
 .Sh NAME
@@ -118,8 +118,8 @@ Defines the operator for comparing two n
 the operator for comparing a node in the tree with a key,
 the offset of member
 .Vt rb_node_t
-within a node,
-and the opaque context passed to the operators.
+within the node type,
+and the opaque context pointer passed to the comparison functions.
 Members of
 .Vt rb_tree_ops_t
 are
@@ -131,6 +131,15 @@ are
 .Ed
 .It Vt rb_node_t
 A node in a red-black tree has this structure as a member.
+The offset of the
+.Vt rb_node_t
+member in the caller's node structure should be provided as
+.Va rbto_node_offset .
+(None of the functions in the
+.Nm
+interface are meant to take pointers directly to the
+.Vt rb_node_t
+member.)
 .El
 .Sh FUNCTIONS
 .Bl -tag -width compact

CVS commit: src/share/man/man3

[Paul Goyette]

Module Name:src
Committed By:   pgoyette
Date:   Wed Jun  1 01:31:11 UTC 2016

Modified Files:
src/share/man/man3: assert.3

Log Message:
Fix AT version reference.  From PR misc/49519


To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 src/share/man/man3/assert.3

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/man3/assert.3
diff -u src/share/man/man3/assert.3:1.13 src/share/man/man3/assert.3:1.14
--- src/share/man/man3/assert.3:1.13	Tue Jan 23 20:32:05 2007
+++ src/share/man/man3/assert.3	Wed Jun  1 01:31:11 2016
@@ -1,4 +1,4 @@
-.\"	$NetBSD: assert.3,v 1.13 2007/01/23 20:32:05 wiz Exp $
+.\"	$NetBSD: assert.3,v 1.14 2016/06/01 01:31:11 pgoyette Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)assert.3	8.1 (Berkeley) 6/9/93
 .\"
-.Dd January 22, 2007
+.Dd June 1, 2016
 .Dt ASSERT 3
 .Os
 .Sh NAME
@@ -92,7 +92,7 @@ macro conforms to
 A
 .Nm
 macro appeared in
-.At v6 .
+.At v7 .
 .Pp
 Information on the name of the enclosing function appeared in
 .St -isoC-99 .

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Tue May 31 08:24:43 UTC 2016

Modified Files:
src/share/man/man3: queue.3

Log Message:
Remove trailing whitespace.


To generate a diff of this commit:
cvs rdiff -u -r1.52 -r1.53 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.52 src/share/man/man3/queue.3:1.53
--- src/share/man/man3/queue.3:1.52	Tue May 31 06:00:38 2016
+++ src/share/man/man3/queue.3	Tue May 31 08:24:43 2016
@@ -1,4 +1,4 @@
-.\"	$NetBSD: queue.3,v 1.52 2016/05/31 06:00:38 pgoyette Exp $
+.\"	$NetBSD: queue.3,v 1.53 2016/05/31 08:24:43 wiz Exp $
 .\"
 .\" Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -1041,7 +1041,7 @@ TAILQ_FOREACH(np, \*[Am]head, entries)	/
 	/* Reverse traversal. */
 TAILQ_FOREACH_REVERSE(np, \*[Am]head, tailhead, entries)
 	np-\*[Gt] ...
-	
+
 while (TAILQ_FIRST(\*[Am]head) != NULL)	/* Delete. */
 	TAILQ_REMOVE(\*[Am]head, TAILQ_FIRST(\*[Am]head), entries);
 if (TAILQ_EMPTY(\*[Am]head))			/* Test for emptiness. */

CVS commit: src/share/man/man3

[Paul Goyette]

Module Name:src
Committed By:   pgoyette
Date:   Tue May 31 06:00:39 UTC 2016

Modified Files:
src/share/man/man3: queue.3

Log Message:
Correct list of operations to note that SLISTs and SIMPLEQs cannot insert
entries before existing entries.  This can only be done for LISTs and
TAILQs.

Fixes PR kern/50845


To generate a diff of this commit:
cvs rdiff -u -r1.51 -r1.52 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.51 src/share/man/man3/queue.3:1.52
--- src/share/man/man3/queue.3:1.51	Tue Feb  2 12:25:24 2016
+++ src/share/man/man3/queue.3	Tue May 31 06:00:38 2016
@@ -1,4 +1,4 @@
-.\"	$NetBSD: queue.3,v 1.51 2016/02/02 12:25:24 ryoon Exp $
+.\"	$NetBSD: queue.3,v 1.52 2016/05/31 06:00:38 pgoyette Exp $
 .\"
 .\" Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -53,7 +53,7 @@
 .\"
 .\"	@(#)queue.3	8.1 (Berkeley) 12/13/93
 .\"
-.Dd February 2, 2016
+.Dd May 31, 2016
 .Dt QUEUE 3
 .Os
 .Sh NAME
@@ -256,7 +256,7 @@ All five structures support the followin
 .It
 Insertion of a new entry at the head of the list.
 .It
-Insertion of a new entry before or after any element in the list.
+Insertion of a new entry after any element in the list.
 .It
 Removal of any entry in the list.
 .It

CVS commit: src/share/man/man3

[Ryo ONODERA]

Module Name:src
Committed By:   ryoon
Date:   Tue Feb  2 12:25:24 UTC 2016

Modified Files:
src/share/man/man3: queue.3

Log Message:
Fix layout for comments. Bump date.


To generate a diff of this commit:
cvs rdiff -u -r1.50 -r1.51 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.50 src/share/man/man3/queue.3:1.51
--- src/share/man/man3/queue.3:1.50	Wed Dec  3 20:36:33 2014
+++ src/share/man/man3/queue.3	Tue Feb  2 12:25:24 2016
@@ -1,4 +1,4 @@
-.\"	$NetBSD: queue.3,v 1.50 2014/12/03 20:36:33 snj Exp $
+.\"	$NetBSD: queue.3,v 1.51 2016/02/02 12:25:24 ryoon Exp $
 .\"
 .\" Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -53,7 +53,7 @@
 .\"
 .\"	@(#)queue.3	8.1 (Berkeley) 12/13/93
 .\"
-.Dd May 17, 2014
+.Dd February 2, 2016
 .Dt QUEUE 3
 .Os
 .Sh NAME
@@ -537,8 +537,8 @@ free(n2);
 n3 = SLIST_FIRST(\*[Am]head);
 SLIST_REMOVE_HEAD(\*[Am]head, entries);  /* Deletion from the head. */
 free(n3);
-/* Forward traversal. */
-SLIST_FOREACH(np, \*[Am]head, entries)
+
+SLIST_FOREACH(np, \*[Am]head, entries)   /* Forward traversal. */
 np-\*[Gt] ...
 
 while (!SLIST_EMPTY(\*[Am]head)) {   /* List Deletion. */
@@ -672,7 +672,7 @@ always making the former empty.
 .Sh LIST EXAMPLE
 .Bd -literal
 LIST_HEAD(listhead, entry) head;
-struct listhead *headp;		/* List head. */
+struct listhead *headp;			/* List head. */
 struct entry {
 	...
 	LIST_ENTRY(entry) entries;	/* List. */
@@ -689,11 +689,11 @@ LIST_INSERT_AFTER(n1, n2, entries);
 
 n2 = malloc(sizeof(struct entry));	/* Insert before. */
 LIST_INSERT_BEFORE(n1, n2, entries);
-	/* Forward traversal. */
-LIST_FOREACH(np, \*[Am]head, entries)
+
+LIST_FOREACH(np, \*[Am]head, entries)	/* Forward traversal. */
 	np-\*[Gt] ...
-	/* Delete. */
-while (LIST_FIRST(\*[Am]head) != NULL)
+
+while (LIST_FIRST(\*[Am]head) != NULL)	/* Delete. */
 	LIST_REMOVE(LIST_FIRST(\*[Am]head), entries);
 if (LIST_EMPTY(\*[Am]head))			/* Test for emptiness. */
 	printf("nothing to do\\n");
@@ -857,11 +857,11 @@ SIMPLEQ_INSERT_TAIL(\*[Am]head, n1, entr
 
 n2 = malloc(sizeof(struct entry));	/* Insert after. */
 SIMPLEQ_INSERT_AFTER(\*[Am]head, n1, n2, entries);
-	/* Forward traversal. */
-SIMPLEQ_FOREACH(np, \*[Am]head, entries)
+
+SIMPLEQ_FOREACH(np, \*[Am]head, entries)	/* Forward traversal. */
 	np-\*[Gt] ...
-	/* Delete. */
-while (SIMPLEQ_FIRST(\*[Am]head) != NULL)
+
+while (SIMPLEQ_FIRST(\*[Am]head) != NULL)	/* Delete. */
 	SIMPLEQ_REMOVE_HEAD(\*[Am]head, entries);
 if (SIMPLEQ_EMPTY(\*[Am]head))		/* Test for emptiness. */
 	printf("nothing to do\\n");
@@ -1015,7 +1015,7 @@ removing all entries from the former.
 .Sh TAIL QUEUE EXAMPLE
 .Bd -literal
 TAILQ_HEAD(tailhead, entry) head;
-struct tailhead *headp;		/* Tail queue head. */
+struct tailhead *headp;			/* Tail queue head. */
 struct entry {
 	...
 	TAILQ_ENTRY(entry) entries;	/* Tail queue. */
@@ -1035,14 +1035,14 @@ TAILQ_INSERT_AFTER(\*[Am]head, n1, n2, e
 
 n2 = malloc(sizeof(struct entry));	/* Insert before. */
 TAILQ_INSERT_BEFORE(n1, n2, entries);
-	/* Forward traversal. */
-TAILQ_FOREACH(np, \*[Am]head, entries)
+
+TAILQ_FOREACH(np, \*[Am]head, entries)	/* Forward traversal. */
 	np-\*[Gt] ...
 	/* Reverse traversal. */
 TAILQ_FOREACH_REVERSE(np, \*[Am]head, tailhead, entries)
 	np-\*[Gt] ...
-	/* Delete. */
-while (TAILQ_FIRST(\*[Am]head) != NULL)
+	
+while (TAILQ_FIRST(\*[Am]head) != NULL)	/* Delete. */
 	TAILQ_REMOVE(\*[Am]head, TAILQ_FIRST(\*[Am]head), entries);
 if (TAILQ_EMPTY(\*[Am]head))			/* Test for emptiness. */
 	printf("nothing to do\\n");

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Sun Nov 22 09:37:33 UTC 2015

Modified Files:
src/share/man/man3: intro.3

Log Message:
Bump date for previous.


To generate a diff of this commit:
cvs rdiff -u -r1.30 -r1.31 src/share/man/man3/intro.3

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/man3/intro.3
diff -u src/share/man/man3/intro.3:1.30 src/share/man/man3/intro.3:1.31
--- src/share/man/man3/intro.3:1.30	Sun Nov 22 05:12:22 2015
+++ src/share/man/man3/intro.3	Sun Nov 22 09:37:33 2015
@@ -1,4 +1,4 @@
-.\"	$NetBSD: intro.3,v 1.30 2015/11/22 05:12:22 kamil Exp $
+.\"	$NetBSD: intro.3,v 1.31 2015/11/22 09:37:33 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)intro.3	8.1 (Berkeley) 6/5/93
 .\"
-.Dd July 3, 2012
+.Dd November 22, 2015
 .Dt INTRO 3
 .Os
 .Sh NAME

CVS commit: src/share/man/man3

[Kamil Rytarowski]

Module Name:src
Committed By:   kamil
Date:   Sun Nov 22 05:12:22 UTC 2015

Modified Files:
src/share/man/man3: intro.3

Log Message:
+libpanel: Z-order for curses windows


To generate a diff of this commit:
cvs rdiff -u -r1.29 -r1.30 src/share/man/man3/intro.3

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/man3/intro.3
diff -u src/share/man/man3/intro.3:1.29 src/share/man/man3/intro.3:1.30
--- src/share/man/man3/intro.3:1.29	Tue Jul  3 09:28:08 2012
+++ src/share/man/man3/intro.3	Sun Nov 22 05:12:22 2015
@@ -1,4 +1,4 @@
-.\"	$NetBSD: intro.3,v 1.29 2012/07/03 09:28:08 wiz Exp $
+.\"	$NetBSD: intro.3,v 1.30 2015/11/22 05:12:22 kamil Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -237,6 +237,10 @@ See
 The curses menu library.
 See
 .Xr menus 3 .
+.It Em libpanel Pq Fl l Ns Ar panel
+The curses panel library.
+See
+.Xr panel 3 .
 .It Em libpcap Pq Fl l Ns Ar pcap
 The packet capture library.
 See

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Fri Nov 20 20:41:58 UTC 2015

Modified Files:
src/share/man/man3: bitstring.3

Log Message:
reflect reality.


To generate a diff of this commit:
cvs rdiff -u -r1.15 -r1.16 src/share/man/man3/bitstring.3

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/man3/bitstring.3
diff -u src/share/man/man3/bitstring.3:1.15 src/share/man/man3/bitstring.3:1.16
--- src/share/man/man3/bitstring.3:1.15	Tue Dec  4 13:02:48 2012
+++ src/share/man/man3/bitstring.3	Fri Nov 20 15:41:58 2015
@@ -1,4 +1,4 @@
-.\"	$NetBSD: bitstring.3,v 1.15 2012/12/04 18:02:48 christos Exp $
+.\"	$NetBSD: bitstring.3,v 1.16 2015/11/20 20:41:58 christos Exp $
 .\"
 .\" Copyright (c) 1989, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -31,7 +31,7 @@
 .\"
 .\" @(#)bitstring.3	8.1 (Berkeley) 7/19/93
 .\"
-.Dd December 4, 2012
+.Dd November 20, 2015
 .Dt BITSTRING 3
 .Os
 .Sh NAME
@@ -49,23 +49,24 @@
 .Sh SYNOPSIS
 .In bitstring.h
 .Ft bitstr_t *
-.Fn bit_alloc "int nbits"
-.Fn bit_clear "bit_str name" "int bit"
-.Fn bit_decl "bit_str name" "int nbits"
-.Fn bit_ffc "bit_str name" "int nbits" "int *value"
-.Fn bit_ffs "bit_str name" "int nbits" "int *value"
-.Fn bit_nclear "bit_str name" "int start" "int stop"
-.Fn bit_nset "bit_str name" "int start" "int stop"
-.Fn bit_set "bit_str name" "int bit"
-.Fn bitstr_size "int nbits"
-.Fn bit_test "bit_str name" "int bit"
+.Fn bit_decl "bitstr_t *name" "size_t nbits"
+.Ft bitstr_t *
+.Fn bit_alloc "size_t nbits"
+.Fn bit_clear "bitstr_t *name" "size_t bit"
+.Fn bit_ffc "const bitstr_t *name" "size_t nbits" "int *value"
+.Fn bit_ffs "const bitstr_t *name" "size_t nbits" "int *value"
+.Fn bit_nclear "bitstr_t *name" "size_t start" "size_t stop"
+.Fn bit_nset "bitstr_t *name" "size_t start" "size_t stop"
+.Fn bit_set "bitstr_t *name" "size_t bit"
+.Fn bitstr_size "size_t nbits"
+.Fn bit_test "const bitstr_t *name" "size_t bit"
 .Sh DESCRIPTION
 These macros operate on strings of bits.
 .Pp
 The macro
 .Fn bit_alloc
 returns a pointer of type
-.Dq Fa "bitstr_t *"
+.Dq Fa "bitstr_t"
 to sufficient space to store
 .Fa nbits
 bits, or
@@ -157,7 +158,8 @@ have side effects.
 #define	LPR_AVAILABLE_BIT	9
 #define	LPR_MAX_BITS		10
 
-make_lpr_available()
+void
+make_lpr_available(void)
 {
 	bitstr_t bit_decl(bitlist, LPR_MAX_BITS);
 	...
@@ -172,7 +174,7 @@ make_lpr_available()
 .Ed
 .Sh SEE ALSO
 .Xr bitmap 3 ,
-.Xr malloc 3 ,
+.Xr calloc 3 ,
 .Xr setbit 9
 .Sh HISTORY
 The

CVS commit: src/share/man/man3

[David A. Holland]

Module Name:src
Committed By:   dholland
Date:   Mon Jun 15 02:06:18 UTC 2015

Modified Files:
src/share/man/man3: stdarg.3

Log Message:
Catch up with varargs.h removal.


To generate a diff of this commit:
cvs rdiff -u -r1.20 -r1.21 src/share/man/man3/stdarg.3

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/man3/stdarg.3
diff -u src/share/man/man3/stdarg.3:1.20 src/share/man/man3/stdarg.3:1.21
--- src/share/man/man3/stdarg.3:1.20	Fri Apr  8 08:47:54 2011
+++ src/share/man/man3/stdarg.3	Mon Jun 15 02:06:18 2015
@@ -1,4 +1,4 @@
-.\	$NetBSD: stdarg.3,v 1.20 2011/04/08 08:47:54 wiz Exp $
+.\	$NetBSD: stdarg.3,v 1.21 2015/06/15 02:06:18 dholland Exp $
 .\
 .\ Copyright (c) 1990, 1991, 1993
 .\	The Regents of the University of California.  All rights reserved.
@@ -33,7 +33,7 @@
 .\
 .\	@(#)stdarg.3	8.1 (Berkeley) 6/5/93
 .\
-.Dd August 18, 2002
+.Dd June 14, 2015
 .Dt STDARG 3
 .Os
 .Sh NAME
@@ -222,10 +222,12 @@ foo(char *fmt, ...)
 .Sh COMPATIBILITY
 These macros are
 .Em not
-compatible with the historic macros they replace.
-A backward compatible version can be found in the include
-file
-.In varargs.h .
+compatible with the historic
+.In varargs.h
+macros they replaced.
+Any remaining code using the pre-C89
+.In varargs.h
+interface should be updated.
 .Sh STANDARDS
 The
 .Fn va_start ,

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sat Jan 24 17:17:02 UTC 2015

Modified Files:
src/share/man/man3: CMSG_DATA.3

Log Message:
correct CMSG_DATA documentation


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/CMSG_DATA.3

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/man3/CMSG_DATA.3
diff -u src/share/man/man3/CMSG_DATA.3:1.2 src/share/man/man3/CMSG_DATA.3:1.3
--- src/share/man/man3/CMSG_DATA.3:1.2	Fri Jun 20 10:35:10 2008
+++ src/share/man/man3/CMSG_DATA.3	Sat Jan 24 12:17:01 2015
@@ -1,8 +1,8 @@
-.\	$NetBSD: CMSG_DATA.3,v 1.2 2008/06/20 14:35:10 christos Exp $
+.\	$NetBSD: CMSG_DATA.3,v 1.3 2015/01/24 17:17:01 christos Exp $
 .\	$OpenBSD: CMSG_DATA.3,v 1.5 2008/03/24 16:11:07 deraadt Exp $
 .\ Written by Jared Yanovich jar...@openbsd.org
 .\ Public domain, July 3, 2005
-.Dd June 20, 2008
+.Dd January 24, 2015
 .Dt CMSG_DATA 3
 .Os
 .Sh NAME
@@ -14,8 +14,10 @@
 .Nd socket control message routines
 .Sh SYNOPSIS
 .In sys/socket.h
-.Ft void *
+.Ft unsigned char *
 .Fn CMSG_DATA struct cmsghdr *
+.Ft const unsigned char *
+.Fn CCMSG_DATA struct cmsghdr *
 .Ft struct cmsghdr *
 .Fn CMSG_FIRSTHDR struct msghdr *
 .Ft size_t

CVS commit: src/share/man/man3

[Soren Jacobsen]

Module Name:src
Committed By:   snj
Date:   Wed Dec  3 20:36:33 UTC 2014

Modified Files:
src/share/man/man3: queue.3

Log Message:
Fix some grammar and punctuation issues.  Remove a pasto.


To generate a diff of this commit:
cvs rdiff -u -r1.49 -r1.50 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.49 src/share/man/man3/queue.3:1.50
--- src/share/man/man3/queue.3:1.49	Sun May 18 15:45:08 2014
+++ src/share/man/man3/queue.3	Wed Dec  3 20:36:33 2014
@@ -1,4 +1,4 @@
-.\	$NetBSD: queue.3,v 1.49 2014/05/18 15:45:08 wiz Exp $
+.\	$NetBSD: queue.3,v 1.50 2014/12/03 20:36:33 snj Exp $
 .\
 .\ Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -368,7 +368,7 @@ using the macros
 .Li SIMPLEQ_HEAD ,
 .Li SLIST_HEAD ,
 or
-.Li TAILQ_HEAD ,
+.Li TAILQ_HEAD .
 See the examples below for further explanation of how these
 macros are used.
 .Ss Summary of Operations
@@ -452,8 +452,6 @@ The macro
 returns the first element in the list or NULL if the list is empty.
 .Pp
 The macro
-.Pp
-The macro
 .Nm SLIST_EMPTY
 evaluates to true if there are no elements in the list.
 .Pp
@@ -507,7 +505,7 @@ this macro instead of the generic
 .Nm SLIST_REMOVE
 macro.
 .Pp
-The macros
+The macro
 .Nm SLIST_REMOVE_AFTER
 removes the element after the one specified.
 For optimum efficiency,
@@ -603,7 +601,7 @@ returns the first element of the list
 .Pp
 The macro
 .Nm LIST_EMPTY
-return true if the list
+returns true if the list
 .Fa head
 has no elements.
 .Pp
@@ -755,7 +753,7 @@ returns the first element of the simple 
 .Pp
 The macro
 .Nm SIMPLEQ_EMPTY
-return true if the simple queue
+returns true if the simple queue
 .Fa head
 has no elements.
 .Pp
@@ -837,7 +835,7 @@ The macro
 concatenates the tail queue headed by
 .Fa head2
 onto the end of the one headed by
-.Fa head1
+.Fa head1 ,
 removing all entries from the former.
 .Sh SIMPLE QUEUE EXAMPLE
 .Bd -literal
@@ -941,7 +939,7 @@ If the tail queue is empty the return va
 .Pp
 The macro
 .Nm TAILQ_EMPTY
-return true if the tail queue
+returns true if the tail queue
 .Fa head
 has no elements.
 .Pp
@@ -1001,7 +999,7 @@ from the tail queue.
 .Pp
 The macro
 .Nm TAILQ_REPLACE
-replace the element
+replaces the element
 .Fa elm
 with the
 .Fa new
@@ -1012,7 +1010,7 @@ The macro
 concatenates the tail queue headed by
 .Fa head2
 onto the end of the one headed by
-.Fa head1
+.Fa head1 ,
 removing all entries from the former.
 .Sh TAIL QUEUE EXAMPLE
 .Bd -literal

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Sun May 18 15:45:08 UTC 2014

Modified Files:
src/share/man/man3: queue.3

Log Message:
Whitespace and punctuation.


To generate a diff of this commit:
cvs rdiff -u -r1.48 -r1.49 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.48 src/share/man/man3/queue.3:1.49
--- src/share/man/man3/queue.3:1.48	Sat May 17 21:22:56 2014
+++ src/share/man/man3/queue.3	Sun May 18 15:45:08 2014
@@ -1,4 +1,4 @@
-.\	$NetBSD: queue.3,v 1.48 2014/05/17 21:22:56 rmind Exp $
+.\	$NetBSD: queue.3,v 1.49 2014/05/18 15:45:08 wiz Exp $
 .\
 .\ Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -139,7 +139,7 @@
 .Nm STAILQ_REMOVE_HEAD ,
 .Nm STAILQ_REMOVE ,
 .Nm STAILQ_CONCAT ,
-.Nd implementations of singly-linked lists, lists, simple queues, tail queues, and singly-linked tail queues.
+.Nd implementations of singly-linked lists, lists, simple queues, tail queues, and singly-linked tail queues
 .Sh SYNOPSIS
 .In sys/queue.h
 .Pp
@@ -377,8 +377,8 @@ of data structure.
 .Pp
 .TS
 box tab(:);
-l | c | c | c | c | c 
-l | c | c | c | c | c 
+l | c | c | c | c | c
+l | c | c | c | c | c
 l | c | c | c | c | c
 l | c | c | c | c | c
 l | c | c | c | c | c

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Thu Nov 28 16:45:36 UTC 2013

Modified Files:
src/share/man/man3: queue.3

Log Message:
Very slightly more consistency in ordering in SYNOPSIS.
Fix a few typos. Remove superfluous Pp.


To generate a diff of this commit:
cvs rdiff -u -r1.46 -r1.47 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.46 src/share/man/man3/queue.3:1.47
--- src/share/man/man3/queue.3:1.46	Wed Nov 27 16:23:00 2013
+++ src/share/man/man3/queue.3	Thu Nov 28 16:45:36 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: queue.3,v 1.46 2013/11/27 16:23:00 christos Exp $
+.\	$NetBSD: queue.3,v 1.47 2013/11/28 16:45:36 wiz Exp $
 .\
 .\ Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -66,8 +66,8 @@
 .Nm SLIST_FOREACH ,
 .Nm SLIST_FOREACH_SAFE ,
 .Nm SLIST_INIT ,
-.Nm SLIST_INSERT_HEAD ,
 .Nm SLIST_INSERT_AFTER ,
+.Nm SLIST_INSERT_HEAD ,
 .Nm SLIST_REMOVE_AFTER ,
 .Nm SLIST_REMOVE_HEAD ,
 .Nm SLIST_REMOVE ,
@@ -95,11 +95,11 @@
 .Nm SIMPLEQ_FOREACH ,
 .Nm SIMPLEQ_FOREACH_SAFE ,
 .Nm SIMPLEQ_INIT ,
+.Nm SIMPLEQ_INSERT_AFTER ,
 .Nm SIMPLEQ_INSERT_HEAD ,
 .Nm SIMPLEQ_INSERT_TAIL ,
-.Nm SIMPLEQ_INSERT_AFTER ,
-.Nm SIMPLEQ_REMOVE_HEAD ,
 .Nm SIMPLEQ_REMOVE_AFTER ,
+.Nm SIMPLEQ_REMOVE_HEAD ,
 .Nm SIMPLEQ_REMOVE ,
 .Nm SIMPLEQ_CONCAT ,
 .Nm TAILQ_HEAD ,
@@ -115,10 +115,10 @@
 .Nm TAILQ_FOREACH_REVERSE ,
 .Nm TAILQ_FOREACH_REVERSE_SAFE ,
 .Nm TAILQ_INIT ,
-.Nm TAILQ_INSERT_HEAD ,
-.Nm TAILQ_INSERT_TAIL ,
 .Nm TAILQ_INSERT_AFTER ,
 .Nm TAILQ_INSERT_BEFORE ,
+.Nm TAILQ_INSERT_HEAD ,
+.Nm TAILQ_INSERT_TAIL ,
 .Nm TAILQ_REMOVE ,
 .Nm TAILQ_REPLACE ,
 .Nm TAILQ_CONCAT ,
@@ -132,13 +132,13 @@
 .Nm STAILQ_FOREACH ,
 .Nm STAILQ_FOREACH_SAFE ,
 .Nm STAILQ_INIT ,
+.Nm STAILQ_INSERT_AFTER ,
 .Nm STAILQ_INSERT_HEAD ,
 .Nm STAILQ_INSERT_TAIL ,
-.Nm STAILQ_INSERT_AFTER ,
 .Nm STAILQ_REMOVE_HEAD ,
 .Nm STAILQ_REMOVE ,
 .Nm STAILQ_CONCAT ,
-.Nd implementations of singly-linked lists, lists, simple queues, tail queues, and singly-linked tail queues.
+.Nd implementations of singly-linked lists, lists, simple queues, tail queues, and singly-linked tail queues.
 .Sh SYNOPSIS
 .In sys/queue.h
 .Pp
@@ -247,7 +247,7 @@
 .Fn STAILQ_CONCAT STAILQ_HEAD *head1 STAILQ_HEAD *head2
 .Sh DESCRIPTION
 These macros define and operate on five types of data structures:
-singly-linked lists, simple queues, lists, tail queues, and signly-linked
+singly-linked lists, simple queues, lists, tail queues, and singly-linked
 tail queues.
 All five structures support the following functionality:
 .Bl -enum -compact -offset indent
@@ -829,7 +829,6 @@ concatenates the tail queue headed by
 onto the end of the one headed by
 .Fa head1
 removing all entries from the former.
-.Pp
 .Sh SIMPLE QUEUE EXAMPLE
 .Bd -literal
 SIMPLEQ_HEAD(simplehead, entry) head;

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Wed Nov 27 16:23:00 UTC 2013

Modified Files:
src/share/man/man3: Makefile queue.3

Log Message:
Sync queue man pages with queue.h.


To generate a diff of this commit:
cvs rdiff -u -r1.84 -r1.85 src/share/man/man3/Makefile
cvs rdiff -u -r1.45 -r1.46 src/share/man/man3/queue.3

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/man3/Makefile
diff -u src/share/man/man3/Makefile:1.84 src/share/man/man3/Makefile:1.85
--- src/share/man/man3/Makefile:1.84	Mon Nov 25 20:33:02 2013
+++ src/share/man/man3/Makefile	Wed Nov 27 11:23:00 2013
@@ -1,4 +1,4 @@
-#	$NetBSD: Makefile,v 1.84 2013/11/26 01:33:02 christos Exp $
+#	$NetBSD: Makefile,v 1.85 2013/11/27 16:23:00 christos Exp $
 #	@(#)Makefile	8.2 (Berkeley) 12/13/93
 
 MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.3 __USE.3 CMSG_DATA.3 \
@@ -136,72 +136,92 @@ MLINKS+=gcq.3 GCQ_INIT.3 \
 	gcq.3 GCQ_FIND_REV.3 \
 	gcq.3 GCQ_FIND_TYPED.3 \
 	gcq.3 GCQ_FIND_REV_TYPED.3
-MLINKS+=queue.3 LIST_HEAD.3 \
-	queue.3 LIST_HEAD_INITIALIZER.3 \
+
+MLINKS+=queue.3 LIST.3 \
 	queue.3 LIST_ENTRY.3 \
+	queue.3 LIST_FIRST.3 \
+	queue.3 LIST_FOREACH.3 \
+	queue.3 LIST_HEAD.3 \
+	queue.3 LIST_HEAD_INITIALIZER.3 \
 	queue.3 LIST_INIT.3 \
 	queue.3 LIST_INSERT_AFTER.3 \
 	queue.3 LIST_INSERT_BEFORE.3 \
 	queue.3 LIST_INSERT_HEAD.3 \
+	queue.3 LIST_NEXT.3 \
 	queue.3 LIST_REMOVE.3 \
-	queue.3 LIST_FOREACH.3 \
-	queue.3 LIST_EMPTY.3 \
-	queue.3 LIST_FIRST.3 \
-	queue.3 LIST_NEXT.3
-MLINKS+=queue.3 SLIST_HEAD.3 \
-	queue.3 SLIST_HEAD_INITIALIZER.3 \
+	queue.3 LIST_REPLACE.3
+
+MLINKS+=queue.3 SIMPLEQ.3 \
+	queue.3 SIMPLEQ_CONCAT.3 \
+	queue.3 SIMPLEQ_EMPTY.3 \
+	queue.3 SIMPLEQ_ENTRY.3 \
+	queue.3 SIMPLEQ_FIRST.3 \
+	queue.3 SIMPLEQ_FOREACH.3 \
+	queue.3 SIMPLEQ_HEAD.3 \
+	queue.3 SIMPLEQ_HEAD_INITIALIZER.3 \
+	queue.3 SIMPLEQ_INIT.3 \
+	queue.3 SIMPLEQ_INSERT_AFTER.3 \
+	queue.3 SIMPLEQ_INSERT_HEAD.3 \
+	queue.3 SIMPLEQ_INSERT_TAIL.3 \
+	queue.3 SIMPLEQ_LAST.3 \
+	queue.3 SIMPLEQ_NEXT.3 \
+	queue.3 SIMPLEQ_REMOVE.3 \
+	queue.3 SIMPLEQ_REMOVE_AFTER.3 \
+	queue.3 SIMPLEQ_REMOVE_HEAD.3 \
+	queue.3 SIMPLQ_REMOVE.3
+
+MLINKS+=queue.3 SLIST.3 \
+	queue.3 SLIST_EMPTY.3 \
 	queue.3 SLIST_ENTRY.3 \
+	queue.3 SLIST_FIRST.3 \
+	queue.3 SLIST_FOREACH.3 \
+	queue.3 SLIST_HEAD.3 \
+	queue.3 SLIST_HEAD_INITIALIZER.3 \
 	queue.3 SLIST_INIT.3 \
 	queue.3 SLIST_INSERT_AFTER.3 \
 	queue.3 SLIST_INSERT_HEAD.3 \
-	queue.3 SLIST_REMOVE_HEAD.3 \
+	queue.3 SLIST_NEXT.3 \
 	queue.3 SLIST_REMOVE.3 \
-	queue.3 SLIST_FOREACH.3 \
-	queue.3 SLIST_EMPTY.3 \
-	queue.3 SLIST_FIRST.3 \
-	queue.3 SLIST_NEXT.3
-MLINKS+=queue.3 STAILQ_HEAD.3 \
-	queue.3 STAILQ_HEAD_INITIALIZER.3 \
+	queue.3 SLIST_REMOVE_AFTER.3 \
+	queue.3 SLIST_REMOVE_HEAD.3
+
+MLINKS+=queue.3 STAILQ.3 \
+	queue.3 STAILQ_CONCAT.3 \
+	queue.3 STAILQ_EMPTY.3 \
 	queue.3 STAILQ_ENTRY.3 \
+	queue.3 STAILQ_FIRST.3 \
+	queue.3 STAILQ_FOREACH.3 \
+	queue.3 STAILQ_FOREACH_SAFE.3 \
+	queue.3 STAILQ_HEAD.3 \
+	queue.3 STAILQ_HEAD_INITIALIZER.3 \
 	queue.3 STAILQ_INIT.3 \
+	queue.3 STAILQ_INSERT_AFTER.3 \
 	queue.3 STAILQ_INSERT_HEAD.3 \
 	queue.3 STAILQ_INSERT_TAIL.3 \
-	queue.3 STAILQ_INSERT_AFTER.3 \
-	queue.3 STAILQ_REMOVE_HEAD.3 \
+	queue.3 STAILQ_LAST.3 \
+	queue.3 STAILQ_NEXT.3 \
 	queue.3 STAILQ_REMOVE.3 \
-	queue.3 STAILQ_FOREACH.3 \
-	queue.3 STAILQ_EMPTY.3 \
-	queue.3 STAILQ_FIRST.3 \
-	queue.3 STAILQ_NEXT.3
-MLINKS+=queue.3 SIMPLEQ_HEAD.3 \
-	queue.3 SIMPLEQ_HEAD_INITIALIZER.3 \
-	queue.3 SIMPLEQ_ENTRY.3 \
-	queue.3 SIMPLEQ_INIT.3 \
-	queue.3 SIMPLEQ_INSERT_HEAD.3 \
-	queue.3 SIMPLEQ_INSERT_TAIL.3 \
-	queue.3 SIMPLEQ_INSERT_AFTER.3 \
-	queue.3 SIMPLEQ_REMOVE_HEAD.3 \
-	queue.3 SIMPLEQ_REMOVE.3 \
-	queue.3 SIMPLEQ_FOREACH.3 \
-	queue.3 SIMPLEQ_EMPTY.3 \
-	queue.3 SIMPLEQ_FIRST.3 \
-	queue.3 SIMPLEQ_NEXT.3
-MLINKS+=queue.3 TAILQ_HEAD.3 \
-	queue.3 TAILQ_HEAD_INITIALIZER.3 \
+	queue.3 STAILQ_REMOVE_HEAD.3
+
+MLINKS+=queue.3 TAILQ.3 \
+	queue.3 TAILQ_CONCAT.3 \
+	queue.3 TAILQ_EMPTY.3 \
 	queue.3 TAILQ_ENTRY.3 \
+	queue.3 TAILQ_FIRST.3 \
+	queue.3 TAILQ_FOREACH_REVERSE_SAFE.3 \
+	queue.3 TAILQ_HEAD.3 \
+	queue.3 TAILQ_HEAD_INITIALIZER.3 \
 	queue.3 TAILQ_INIT.3 \
-	queue.3 TAILQ_INSERT_HEAD.3 \
-	queue.3 TAILQ_INSERT_TAIL.3 \
 	queue.3 TAILQ_INSERT_AFTER.3 \
 	queue.3 TAILQ_INSERT_BEFORE.3 \
-	queue.3 TAILQ_REMOVE.3 \
-	queue.3 TAILQ_FOREACH.3 \
-	queue.3 TAILQ_FOREACH_REVERSE.3 \
-	queue.3 TAILQ_EMPTY.3 \
-	queue.3 TAILQ_FIRST.3 \
-	queue.3 TAILQ_NEXT.3 \
+	queue.3 TAILQ_INSERT_HEAD.3 \
+	queue.3 TAILQ_INSERT_TAIL.3 \
 	queue.3 TAILQ_LAST.3 \
-	queue.3 TAILQ_PREV.3
+	queue.3 TAILQ_NEXT.3 \
+	queue.3 TAILQ_PREV.3 \
+	queue.3 TAILQ_REMOVE.3 \
+	queue.3 TAILQ_REPLACE.3
+
 MLINKS+=rbtree.3 rb_tree_init.3 \
 	rbtree.3 rb_tree_insert_node.3 \
 	rbtree.3 rb_tree_find_node.3 \

Index: src/share/man/man3/queue.3
diff -u src/share/man/man3/queue.3:1.45 src/share/man/man3/queue.3:1.46
--- 

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Wed Nov 27 16:24:31 UTC 2013

Modified Files:
src/share/man/man3: Makefile

Log Message:
forgot one


To generate a diff of this commit:
cvs rdiff -u -r1.85 -r1.86 src/share/man/man3/Makefile

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/man3/Makefile
diff -u src/share/man/man3/Makefile:1.85 src/share/man/man3/Makefile:1.86
--- src/share/man/man3/Makefile:1.85	Wed Nov 27 11:23:00 2013
+++ src/share/man/man3/Makefile	Wed Nov 27 11:24:31 2013
@@ -1,4 +1,4 @@
-#	$NetBSD: Makefile,v 1.85 2013/11/27 16:23:00 christos Exp $
+#	$NetBSD: Makefile,v 1.86 2013/11/27 16:24:31 christos Exp $
 #	@(#)Makefile	8.2 (Berkeley) 12/13/93
 
 MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.3 __USE.3 CMSG_DATA.3 \
@@ -138,6 +138,7 @@ MLINKS+=gcq.3 GCQ_INIT.3 \
 	gcq.3 GCQ_FIND_REV_TYPED.3
 
 MLINKS+=queue.3 LIST.3 \
+	queue.3 LIST_EMPTY.3 \
 	queue.3 LIST_ENTRY.3 \
 	queue.3 LIST_FIRST.3 \
 	queue.3 LIST_FOREACH.3 \

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Wed Nov 27 16:27:48 UTC 2013

Modified Files:
src/share/man/man3: Makefile

Log Message:
and a few more.


To generate a diff of this commit:
cvs rdiff -u -r1.86 -r1.87 src/share/man/man3/Makefile

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/man3/Makefile
diff -u src/share/man/man3/Makefile:1.86 src/share/man/man3/Makefile:1.87
--- src/share/man/man3/Makefile:1.86	Wed Nov 27 11:24:31 2013
+++ src/share/man/man3/Makefile	Wed Nov 27 11:27:48 2013
@@ -1,4 +1,4 @@
-#	$NetBSD: Makefile,v 1.86 2013/11/27 16:24:31 christos Exp $
+#	$NetBSD: Makefile,v 1.87 2013/11/27 16:27:48 christos Exp $
 #	@(#)Makefile	8.2 (Berkeley) 12/13/93
 
 MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.3 __USE.3 CMSG_DATA.3 \
@@ -142,6 +142,7 @@ MLINKS+=queue.3 LIST.3 \
 	queue.3 LIST_ENTRY.3 \
 	queue.3 LIST_FIRST.3 \
 	queue.3 LIST_FOREACH.3 \
+	queue.3 LIST_FOREACH_SAFE.3 \
 	queue.3 LIST_HEAD.3 \
 	queue.3 LIST_HEAD_INITIALIZER.3 \
 	queue.3 LIST_INIT.3 \
@@ -158,6 +159,7 @@ MLINKS+=queue.3 SIMPLEQ.3 \
 	queue.3 SIMPLEQ_ENTRY.3 \
 	queue.3 SIMPLEQ_FIRST.3 \
 	queue.3 SIMPLEQ_FOREACH.3 \
+	queue.3 SIMPLEQ_FOREACH_SAFE.3 \
 	queue.3 SIMPLEQ_HEAD.3 \
 	queue.3 SIMPLEQ_HEAD_INITIALIZER.3 \
 	queue.3 SIMPLEQ_INIT.3 \
@@ -176,6 +178,7 @@ MLINKS+=queue.3 SLIST.3 \
 	queue.3 SLIST_ENTRY.3 \
 	queue.3 SLIST_FIRST.3 \
 	queue.3 SLIST_FOREACH.3 \
+	queue.3 SLIST_FOREACH_SAFE.3 \
 	queue.3 SLIST_HEAD.3 \
 	queue.3 SLIST_HEAD_INITIALIZER.3 \
 	queue.3 SLIST_INIT.3 \
@@ -209,6 +212,9 @@ MLINKS+=queue.3 TAILQ.3 \
 	queue.3 TAILQ_EMPTY.3 \
 	queue.3 TAILQ_ENTRY.3 \
 	queue.3 TAILQ_FIRST.3 \
+	queue.3 TAILQ_FOREACH.3 \
+	queue.3 TAILQ_FOREACH_SAFE.3 \
+	queue.3 TAILQ_FOREACH_REVERSE.3 \
 	queue.3 TAILQ_FOREACH_REVERSE_SAFE.3 \
 	queue.3 TAILQ_HEAD.3 \
 	queue.3 TAILQ_HEAD_INITIALIZER.3 \

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Wed Nov 27 16:30:12 UTC 2013

Modified Files:
src/share/man/man3: Makefile

Log Message:
fix typo


To generate a diff of this commit:
cvs rdiff -u -r1.87 -r1.88 src/share/man/man3/Makefile

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/man3/Makefile
diff -u src/share/man/man3/Makefile:1.87 src/share/man/man3/Makefile:1.88
--- src/share/man/man3/Makefile:1.87	Wed Nov 27 11:27:48 2013
+++ src/share/man/man3/Makefile	Wed Nov 27 11:30:12 2013
@@ -1,4 +1,4 @@
-#	$NetBSD: Makefile,v 1.87 2013/11/27 16:27:48 christos Exp $
+#	$NetBSD: Makefile,v 1.88 2013/11/27 16:30:12 christos Exp $
 #	@(#)Makefile	8.2 (Berkeley) 12/13/93
 
 MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.3 __USE.3 CMSG_DATA.3 \
@@ -171,7 +171,7 @@ MLINKS+=queue.3 SIMPLEQ.3 \
 	queue.3 SIMPLEQ_REMOVE.3 \
 	queue.3 SIMPLEQ_REMOVE_AFTER.3 \
 	queue.3 SIMPLEQ_REMOVE_HEAD.3 \
-	queue.3 SIMPLQ_REMOVE.3
+	queue.3 SIMPLEQ_REMOVE.3
 
 MLINKS+=queue.3 SLIST.3 \
 	queue.3 SLIST_EMPTY.3 \

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Tue Nov 26 01:33:02 UTC 2013

Modified Files:
src/share/man/man3: Makefile

Log Message:
remove CIRCLEQ pages.


To generate a diff of this commit:
cvs rdiff -u -r1.83 -r1.84 src/share/man/man3/Makefile

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/man3/Makefile
diff -u src/share/man/man3/Makefile:1.83 src/share/man/man3/Makefile:1.84
--- src/share/man/man3/Makefile:1.83	Sun Oct 27 07:56:18 2013
+++ src/share/man/man3/Makefile	Mon Nov 25 20:33:02 2013
@@ -1,4 +1,4 @@
-#	$NetBSD: Makefile,v 1.83 2013/10/27 11:56:18 apb Exp $
+#	$NetBSD: Makefile,v 1.84 2013/11/26 01:33:02 christos Exp $
 #	@(#)Makefile	8.2 (Berkeley) 12/13/93
 
 MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.3 __USE.3 CMSG_DATA.3 \
@@ -202,24 +202,6 @@ MLINKS+=queue.3 TAILQ_HEAD.3 \
 	queue.3 TAILQ_NEXT.3 \
 	queue.3 TAILQ_LAST.3 \
 	queue.3 TAILQ_PREV.3
-MLINKS+=queue.3 CIRCLEQ_HEAD.3 \
-	queue.3 CIRCLEQ_HEAD_INITIALIZER.3 \
-	queue.3 CIRCLEQ_ENTRY.3 \
-	queue.3 CIRCLEQ_INIT.3 \
-	queue.3 CIRCLEQ_INSERT_AFTER.3 \
-	queue.3 CIRCLEQ_INSERT_BEFORE.3 \
-	queue.3 CIRCLEQ_INSERT_HEAD.3 \
-	queue.3 CIRCLEQ_INSERT_TAIL.3 \
-	queue.3 CIRCLEQ_REMOVE.3 \
-	queue.3 CIRCLEQ_FOREACH.3 \
-	queue.3 CIRCLEQ_FOREACH_REVERSE.3 \
-	queue.3 CIRCLEQ_EMPTY.3 \
-	queue.3 CIRCLEQ_FIRST.3 \
-	queue.3 CIRCLEQ_LAST.3 \
-	queue.3 CIRCLEQ_NEXT.3 \
-	queue.3 CIRCLEQ_PREV.3 \
-	queue.3 CIRCLEQ_LOOP_NEXT.3 \
-	queue.3 CIRCLEQ_LOOP_PREV.3
 MLINKS+=rbtree.3 rb_tree_init.3 \
 	rbtree.3 rb_tree_insert_node.3 \
 	rbtree.3 rb_tree_find_node.3 \

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sat Nov 23 14:54:02 UTC 2013

Modified Files:
src/share/man/man3: queue.3

Log Message:
remove documentation for CIRCLEQ to discourage its use.


To generate a diff of this commit:
cvs rdiff -u -r1.43 -r1.44 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.43 src/share/man/man3/queue.3:1.44
--- src/share/man/man3/queue.3:1.43	Mon Oct  8 14:20:34 2012
+++ src/share/man/man3/queue.3	Sat Nov 23 09:54:02 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: queue.3,v 1.43 2012/10/08 18:20:34 njoly Exp $
+.\	$NetBSD: queue.3,v 1.44 2013/11/23 14:54:02 christos Exp $
 .\
 .\ Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -53,7 +53,7 @@
 .\
 .\	@(#)queue.3	8.1 (Berkeley) 12/13/93
 .\
-.Dd March 11, 2009
+.Dd November 23, 2013
 .Dt QUEUE 3
 .Os
 .Sh NAME
@@ -133,25 +133,7 @@
 .Nm TAILQ_LAST ,
 .Nm TAILQ_PREV ,
 .Nm TAILQ_CONCAT ,
-.Nm CIRCLEQ_HEAD ,
-.Nm CIRCLEQ_HEAD_INITIALIZER ,
-.Nm CIRCLEQ_ENTRY ,
-.Nm CIRCLEQ_INIT ,
-.Nm CIRCLEQ_INSERT_AFTER ,
-.Nm CIRCLEQ_INSERT_BEFORE ,
-.Nm CIRCLEQ_INSERT_HEAD ,
-.Nm CIRCLEQ_INSERT_TAIL ,
-.Nm CIRCLEQ_REMOVE ,
-.Nm CIRCLEQ_FOREACH ,
-.Nm CIRCLEQ_FOREACH_REVERSE ,
-.Nm CIRCLEQ_EMPTY ,
-.Nm CIRCLEQ_FIRST ,
-.Nm CIRCLEQ_LAST ,
-.Nm CIRCLEQ_NEXT ,
-.Nm CIRCLEQ_PREV ,
-.Nm CIRCLEQ_LOOP_NEXT ,
-.Nm CIRCLEQ_LOOP_PREV
-.Nd implementations of singly-linked lists, simple queues, lists, tail queues, and circular queues
+.Nd implementations of singly-linked lists, simple queues, lists, and tail queues
 .Sh SYNOPSIS
 .In sys/queue.h
 .Pp
@@ -254,36 +236,11 @@
 .Ft TYPE *
 .Fn TAILQ_PREV TYPE *elm HEADNAME TAILQ_ENTRY NAME
 .Fn TAILQ_CONCAT TAILQ_HEAD *head1 TAILQ_HEAD *head2 TAILQ_ENTRY NAME
-.Pp
-.Fn CIRCLEQ_HEAD HEADNAME TYPE
-.Fn CIRCLEQ_HEAD_INITIALIZER head
-.Fn CIRCLEQ_ENTRY TYPE
-.Fn CIRCLEQ_INIT CIRCLEQ_HEAD *head
-.Fn CIRCLEQ_INSERT_AFTER CIRCLEQ_HEAD *head TYPE *listelm TYPE *elm CIRCLEQ_ENTRY NAME
-.Fn CIRCLEQ_INSERT_BEFORE CIRCLEQ_HEAD *head TYPE *listelm TYPE *elm CIRCLEQ_ENTRY NAME
-.Fn CIRCLEQ_INSERT_HEAD CIRCLEQ_HEAD *head TYPE *elm CIRCLEQ_ENTRY NAME
-.Fn CIRCLEQ_INSERT_TAIL CIRCLEQ_HEAD *head TYPE *elm CIRCLEQ_ENTRY NAME
-.Fn CIRCLEQ_REMOVE CIRCLEQ_HEAD *head TYPE *elm CIRCLEQ_ENTRY NAME
-.Fn CIRCLEQ_FOREACH TYPE *var CIRCLEQ_HEAD *head CIRCLEQ_ENTRY NAME
-.Fn CIRCLEQ_FOREACH_REVERSE TYPE *var CIRCLEQ_HEAD *head CIRCLEQ_ENTRY NAME
-.Ft int
-.Fn CIRCLEQ_EMPTY CIRCLEQ_HEAD *head
-.Ft TYPE *
-.Fn CIRCLEQ_FIRST CIRCLEQ_HEAD *head
-.Ft TYPE *
-.Fn CIRCLEQ_LAST CIRCLEQ_HEAD *head
-.Ft TYPE *
-.Fn CIRCLEQ_NEXT TYPE *elm CIRCLEQ_ENTRY NAME
-.Ft TYPE *
-.Fn CIRCLEQ_PREV TYPE *elm CIRCLEQ_ENTRY NAME
-.Ft TYPE *
-.Fn CIRCLEQ_LOOP_NEXT CIRCLEQ_HEAD *head TYPE *elm CIRCLEQ_ENTRY NAME
-.Ft TYPE *
-.Fn CIRCLEQ_LOOP_PREV CIRCLEQ_HEAD *head TYPE *elm CIRCLEQ_ENTRY NAME
 .Sh DESCRIPTION
-These macros define and operate on five types of data structures:
-singly-linked lists, simple queues, lists, tail queues, and circular queues.
-All five structures support the following functionality:
+These macros define and operate on four types of data structures:
+singly-linked lists, simple queues, lists, and tail queues
+.\ and circular queues.
+All four structures support the following functionality:
 .Bl -enum -compact -offset indent
 .It
 Insertion of a new entry at the head of the list.
@@ -295,7 +252,7 @@ Removal of any entry in the list.
 Forward traversal through the list.
 .El
 .Pp
-Singly-linked lists are the simplest of the five data structures and
+Singly-linked lists are the simplest of the four data structures and
 support only the above functionality.
 Singly-linked lists are ideal for applications with large datasets and
 few or no removals,
@@ -321,8 +278,8 @@ Each head entry requires two pointers ra
 Simple queues are ideal for applications with large datasets and few or
 no removals, or for implementing a FIFO queue.
 .Pp
-All doubly linked types of data structures (lists, tail queues, and circle
-queues) additionally allow:
+All doubly linked types of data structures (lists, and tail queues)
+additionally allow:
 .Bl -enum -compact -offset indent
 .It
 Insertion of a new entry before any element in the list.
@@ -387,9 +344,8 @@ that must contain a field of type
 .Li LIST_ENTRY ,
 .Li SIMPLEQ_ENTRY ,
 .Li SLIST_ENTRY ,
-.Li TAILQ_ENTRY ,
 or
-.Li CIRCLEQ_ENTRY ,
+.Li TAILQ_ENTRY ,
 named
 .Fa NAME .
 The argument
@@ -399,9 +355,8 @@ using the macros
 .Li LIST_HEAD ,
 .Li SIMPLEQ_HEAD ,
 .Li SLIST_HEAD ,
-.Li TAILQ_HEAD ,
 or
-.Li CIRCLEQ_HEAD .
+.Li TAILQ_HEAD ,
 See the examples below for further explanation of how these
 macros are used.
 .Ss Summary of Operations
@@ -410,30 +365,30 @@ of data structure.
 .Pp
 .TS
 box tab(:);
-l | c | c | c | c | c | c
-l | c | c | c | c | c | c
-l | c | c | c | c | c | c
-l | c | c 

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Sat Nov 23 17:40:43 UTC 2013

Modified Files:
src/share/man/man3: queue.3

Log Message:
Remove extra comma.


To generate a diff of this commit:
cvs rdiff -u -r1.44 -r1.45 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.44 src/share/man/man3/queue.3:1.45
--- src/share/man/man3/queue.3:1.44	Sat Nov 23 14:54:02 2013
+++ src/share/man/man3/queue.3	Sat Nov 23 17:40:43 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: queue.3,v 1.44 2013/11/23 14:54:02 christos Exp $
+.\	$NetBSD: queue.3,v 1.45 2013/11/23 17:40:43 wiz Exp $
 .\
 .\ Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -278,7 +278,7 @@ Each head entry requires two pointers ra
 Simple queues are ideal for applications with large datasets and few or
 no removals, or for implementing a FIFO queue.
 .Pp
-All doubly linked types of data structures (lists, and tail queues)
+All doubly linked types of data structures (lists and tail queues)
 additionally allow:
 .Bl -enum -compact -offset indent
 .It

CVS commit: src/share/man/man3

[Alan Barrett]

Module Name:src
Committed By:   apb
Date:   Sun Oct 27 10:05:15 UTC 2013

Modified Files:
src/share/man/man3: cdefs.3

Log Message:
refer to __USE(3)


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

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/man3/cdefs.3
diff -u src/share/man/man3/cdefs.3:1.3 src/share/man/man3/cdefs.3:1.4
--- src/share/man/man3/cdefs.3:1.3	Fri Apr  8 07:55:04 2011
+++ src/share/man/man3/cdefs.3	Sun Oct 27 10:05:15 2013
@@ -1,4 +1,4 @@
-.\ $NetBSD: cdefs.3,v 1.3 2011/04/08 07:55:04 jruoho Exp $
+.\ $NetBSD: cdefs.3,v 1.4 2013/10/27 10:05:15 apb Exp $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -56,6 +56,7 @@ type qualifier from
 Macros and definitions specific to compilers, preprocessors, and linkers; see
 .Xr __CONCAT 3 ,
 .Xr __UNCONST 3 ,
+.Xr __USE 3 ,
 .Xr __insn_barrier 3 ,
 and
 .Xr attribute 3 .
@@ -88,7 +89,7 @@ included as the first thing right after 
  */
 
 #include sys/cdefs.h
-__RCSID($NetBSD: cdefs.3,v 1.3 2011/04/08 07:55:04 jruoho Exp $);
+__RCSID($NetBSD: cdefs.3,v 1.4 2013/10/27 10:05:15 apb Exp $);
 .Ed
 .Pp
 It is possible to identify the

CVS commit: src/share/man/man3

[Alan Barrett]

Module Name:src
Committed By:   apb
Date:   Fri Oct 25 14:41:08 UTC 2013

Modified Files:
src/share/man/man3: attribute.3

Log Message:
Try to make this more compiler-neutral, and give both GCC and LLVM/Clang
as examples.


To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/share/man/man3/attribute.3

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/man3/attribute.3
diff -u src/share/man/man3/attribute.3:1.11 src/share/man/man3/attribute.3:1.12
--- src/share/man/man3/attribute.3:1.11	Sun Sep 18 17:43:20 2011
+++ src/share/man/man3/attribute.3	Fri Oct 25 14:41:08 2013
@@ -1,4 +1,4 @@
-.\ $NetBSD: attribute.3,v 1.11 2011/09/18 17:43:20 jym Exp $
+.\ $NetBSD: attribute.3,v 1.12 2013/10/25 14:41:08 apb Exp $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -27,12 +27,12 @@
 .\ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\ POSSIBILITY OF SUCH DAMAGE.
 .\
-.Dd December 19, 2010
+.Dd October 25, 2013
 .Dt ATTRIBUTE 3
 .Os
 .Sh NAME
 .Nm attribute
-.Nd non-standard GCC attribute extensions
+.Nd non-standard compiler attribute extensions
 .Sh SYNOPSIS
 .In sys/cdefs.h
 .Pp
@@ -61,30 +61,42 @@
 .Pp
 .Fn __predict_false exp
 .Sh DESCRIPTION
+As an extension to the C standard, some compilers allow non-standard
+attributes to be associated with functions, variables, or types, to
+modify some aspect of the way the compiler treats the associated item.
 The
 .Tn GNU
 Compiler Collection
-.Pq Tn GCC
-provides many extensions to the standard C language.
-Among these are the so-called attributes.
-In
+.Pq Tn GCC ,
+and
+.Tn LLVM/Clang ,
+use the
+.Em __attribute__
+syntax for such attributes,
+but different versions of the compilers support different attributes,
+and other compilers may use entirely different syntax.
+.Pp
 .Nx
-all attributes are provided in a restricted namespace.
-The described macros should be preferred instead of using the
-.Tn GCC's
+code should usually avoid direct use of the
 .Em __attribute__
-extension directly.
+or similar syntax provided by specific compilers.
+Instead,
+.Nx Ns 's
+.In sys/cdefs.h
+header file
+provides several attribute macros in a namespace
+reserved for the implementation (beginning with
+.Ql __ ) ,
+that expand to the appropriate syntax for the compiler that is in use.
 .Sh ATTRIBUTES
 .Bl -tag -width abc
 .It Ic __dead
-The
-.Xr gcc 1
-compiler knows that certain functions such as
+Certain functions, such as
 .Xr abort 3
 and
-.Xr exit 3
+.Xr exit 3 ,
 can never return any value.
-When such a function is equipped with
+When such a function is declared with
 .Ic __dead ,
 certain optimizations are possible.
 Obviously a
@@ -129,34 +141,29 @@ As with pure functions,
 certain micro-optimizations are possible for functions declared with
 .Ic __constfunc .
 .It Ic __noinline
-.Tn GCC
-is known for aggressive function inlining.
 Sometimes it is known that inlining is undesirable or that
 a function will perform incorrectly when inlined.
 The
 .Ic __noinline
 macro expands to a function attribute that prevents
-.Tn GCC
-for inlining the function, irrespective
-whether the function was declared with the
+the compiler from inlining the function, irrespective
+of whether the function was declared with the
 .Em inline
 keyword.
 The attribute takes precedence over all
 other compiler options related to inlining.
 .It Ic __unused
-In most
-.Tn GCC
-versions the common
-.Fl Wall
-flag enables warnings produced by functions that are defined but unused.
 Marking an unused function with the
 .Ic __unused
-macro inhibits these warnings.
+macro inhibits warnings that a function is defined but not used.
+Marking a variable with the
+.Ic __unused
+macro inhibits warnings that the variable is unused,
+or that it is set but never read.
 .It Ic __used
 The
 .Ic __used
-macro expands to an attribute that informs
-.Tn GCC
+macro expands to an attribute that informs the compiler
 that a static variable or function is to be always retained
 in the object file even if it is unreferenced.
 .It Ic __packed
@@ -300,6 +307,7 @@ and
 .Ic __predict_true .
 .El
 .Sh SEE ALSO
+.Xr clang 1 ,
 .Xr gcc 1 ,
 .Xr __builtin_object_size 3 ,
 .Xr cdefs 3 ,

CVS commit: src/share/man/man3

[Alan Barrett]

Module Name:src
Committed By:   apb
Date:   Fri Oct 25 14:46:59 UTC 2013

Modified Files:
src/share/man/man3: attribute.3

Log Message:
Document __diagused and __debugused


To generate a diff of this commit:
cvs rdiff -u -r1.12 -r1.13 src/share/man/man3/attribute.3

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/man3/attribute.3
diff -u src/share/man/man3/attribute.3:1.12 src/share/man/man3/attribute.3:1.13
--- src/share/man/man3/attribute.3:1.12	Fri Oct 25 14:41:08 2013
+++ src/share/man/man3/attribute.3	Fri Oct 25 14:46:59 2013
@@ -1,4 +1,4 @@
-.\ $NetBSD: attribute.3,v 1.12 2013/10/25 14:41:08 apb Exp $
+.\ $NetBSD: attribute.3,v 1.13 2013/10/25 14:46:59 apb Exp $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -48,6 +48,10 @@
 .Pp
 .Ic __used
 .Pp
+.Ic __diagused
+.Pp
+.Ic __debugused
+.Pp
 .Ic __packed
 .Pp
 .Fn __aligned x
@@ -166,6 +170,35 @@ The
 macro expands to an attribute that informs the compiler
 that a static variable or function is to be always retained
 in the object file even if it is unreferenced.
+.It Ic __diagused
+The
+.Ic __diagused
+macro expands to an attribute that informs the compiler
+that a variable or function is used only in diagnostic code,
+and may be unused in non-diagnostic code.
+.Pp
+In the kernel, variables that are used when DIAGNOSTIC is defined,
+but unused when DIAGNOSTIC is not defined, may be declared with
+__diagused.  In userland, variables that are used when NDEBUG is not
+defined, but unused when NDEBUG is defined, may be declared with
+__diagused.
+.Pp
+Variables used only in assert(3) or KASSERT(9) macros are likely
+candidates for being declared with __diagused.
+.It Ic __debugused
+The
+.Ic __debugused
+macro expands to an attribute that informs the compiler
+that a variable or function is used only in debug code,
+and may be unused in non-debug code.
+.Pp
+In either the kernel or userland, variables that are used when DEBUG
+is defined, but unused when DEBUG is not defined, may be declared with
+__debugused.
+.Pp
+In the kernel, variables used only in KDASSERT(9) macros are likely
+candidates for being declared with __debugused.  There is no
+established convention for the use of DEBUG in userland code.
 .It Ic __packed
 The
 .Ic __packed

CVS commit: src/share/man/man3

[Alan Barrett]

Module Name:src
Committed By:   apb
Date:   Fri Oct 25 15:11:21 UTC 2013

Modified Files:
src/share/man/man3: attribute.3

Log Message:
Use markup in the descriptions of __diagused and __debugused.


To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 src/share/man/man3/attribute.3

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/man3/attribute.3
diff -u src/share/man/man3/attribute.3:1.13 src/share/man/man3/attribute.3:1.14
--- src/share/man/man3/attribute.3:1.13	Fri Oct 25 14:46:59 2013
+++ src/share/man/man3/attribute.3	Fri Oct 25 15:11:21 2013
@@ -1,4 +1,4 @@
-.\ $NetBSD: attribute.3,v 1.13 2013/10/25 14:46:59 apb Exp $
+.\ $NetBSD: attribute.3,v 1.14 2013/10/25 15:11:21 apb Exp $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -177,14 +177,25 @@ macro expands to an attribute that infor
 that a variable or function is used only in diagnostic code,
 and may be unused in non-diagnostic code.
 .Pp
-In the kernel, variables that are used when DIAGNOSTIC is defined,
-but unused when DIAGNOSTIC is not defined, may be declared with
-__diagused.  In userland, variables that are used when NDEBUG is not
-defined, but unused when NDEBUG is defined, may be declared with
-__diagused.
+In the kernel, variables that are used when
+.Dv DIAGNOSTIC
+is defined, but unused when
+.Dv DIAGNOSTIC
+is not defined, may be declared with
+.Ic __diagused .
+In userland, variables that are used when
+.Dv NDEBUG
+is not defined, but unused when
+.Dv NDEBUG
+is defined, may be declared with
+.Ic __diagused .
 .Pp
-Variables used only in assert(3) or KASSERT(9) macros are likely
-candidates for being declared with __diagused.
+Variables used only in
+.Xr assert 3
+or
+.Xr KASSERT 9
+macros are likely candidates for being declared with
+.Ic __diagused .
 .It Ic __debugused
 The
 .Ic __debugused
@@ -192,13 +203,20 @@ macro expands to an attribute that infor
 that a variable or function is used only in debug code,
 and may be unused in non-debug code.
 .Pp
-In either the kernel or userland, variables that are used when DEBUG
-is defined, but unused when DEBUG is not defined, may be declared with
-__debugused.
-.Pp
-In the kernel, variables used only in KDASSERT(9) macros are likely
-candidates for being declared with __debugused.  There is no
-established convention for the use of DEBUG in userland code.
+In either the kernel or userland, variables that are used when
+.Dv DEBUG
+is defined, but unused when
+.Dv DEBUG
+is not defined, may be declared with
+.Ic __debugused. 
+.Pp
+In the kernel, variables used only in
+.Xr KDASSERT 9
+macros are likely candidates for being declared with
+.Ic __debugused .
+There is no established convention for the use of
+.Dv DEBUG
+in userland code.
 .It Ic __packed
 The
 .Ic __packed

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Oct 25 22:19:41 UTC 2013

Modified Files:
src/share/man/man3: attribute.3

Log Message:
Whitespace; better macro.


To generate a diff of this commit:
cvs rdiff -u -r1.14 -r1.15 src/share/man/man3/attribute.3

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/man3/attribute.3
diff -u src/share/man/man3/attribute.3:1.14 src/share/man/man3/attribute.3:1.15
--- src/share/man/man3/attribute.3:1.14	Fri Oct 25 15:11:21 2013
+++ src/share/man/man3/attribute.3	Fri Oct 25 22:19:41 2013
@@ -1,4 +1,4 @@
-.\ $NetBSD: attribute.3,v 1.14 2013/10/25 15:11:21 apb Exp $
+.\ $NetBSD: attribute.3,v 1.15 2013/10/25 22:19:41 wiz Exp $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -85,7 +85,7 @@ code should usually avoid direct use of 
 .Em __attribute__
 or similar syntax provided by specific compilers.
 Instead,
-.Nx Ns 's
+.Nx Ap s
 .In sys/cdefs.h
 header file
 provides several attribute macros in a namespace
@@ -208,7 +208,7 @@ In either the kernel or userland, variab
 is defined, but unused when
 .Dv DEBUG
 is not defined, may be declared with
-.Ic __debugused. 
+.Ic __debugused .
 .Pp
 In the kernel, variables used only in
 .Xr KDASSERT 9

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Thu Oct 17 16:50:48 UTC 2013

Modified Files:
src/share/man/man3: __CONCAT.3 __UNCONST.3

Log Message:
add non-portability caveat.


To generate a diff of this commit:
cvs rdiff -u -r1.6 -r1.7 src/share/man/man3/__CONCAT.3
cvs rdiff -u -r1.5 -r1.6 src/share/man/man3/__UNCONST.3

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/man3/__CONCAT.3
diff -u src/share/man/man3/__CONCAT.3:1.6 src/share/man/man3/__CONCAT.3:1.7
--- src/share/man/man3/__CONCAT.3:1.6	Thu Dec 16 05:40:04 2010
+++ src/share/man/man3/__CONCAT.3	Thu Oct 17 12:50:48 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: __CONCAT.3,v 1.6 2010/12/16 10:40:04 jruoho Exp $ $
+.\	$NetBSD: __CONCAT.3,v 1.7 2013/10/17 16:50:48 christos 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 December 16, 2010
+.Dd October 17, 2013
 .Dt __CONCAT 3
 .Os
 .Sh NAME
@@ -101,3 +101,8 @@ is used.
 It can be also noted that the C preprocessor converts all
 comments to whitespace before any macros are even considered.
 The use of either macro is discouraged in complex constructs.
+.Pp
+Use of this macro is non-portable; this is part of the implementation
+namespace and should only be used in 
+.Nx
+code.

Index: src/share/man/man3/__UNCONST.3
diff -u src/share/man/man3/__UNCONST.3:1.5 src/share/man/man3/__UNCONST.3:1.6
--- src/share/man/man3/__UNCONST.3:1.5	Thu Dec 16 05:40:04 2010
+++ src/share/man/man3/__UNCONST.3	Thu Oct 17 12:50:48 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: __UNCONST.3,v 1.5 2010/12/16 10:40:04 jruoho Exp $
+.\	$NetBSD: __UNCONST.3,v 1.6 2013/10/17 16:50:48 christos 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 December 16, 2010
+.Dd October 17, 2013
 .Dt __UNCONST 3
 .Os
 .Sh NAME
@@ -81,3 +81,8 @@ include passing a
 .Em volatile
 pointer to
 .Xr memset 3 .
+.Pp
+Use of this macro is non-portable; this is part of the implementation
+namespace and should only be used in 
+.Nx
+code.

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Thu Oct 17 16:50:36 UTC 2013

Modified Files:
src/share/man/man3: Makefile
Added Files:
src/share/man/man3: __USE.3

Log Message:
describe the __USE macro


To generate a diff of this commit:
cvs rdiff -u -r1.81 -r1.82 src/share/man/man3/Makefile
cvs rdiff -u -r0 -r1.1 src/share/man/man3/__USE.3

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/man3/Makefile
diff -u src/share/man/man3/Makefile:1.81 src/share/man/man3/Makefile:1.82
--- src/share/man/man3/Makefile:1.81	Thu Dec  6 20:54:41 2012
+++ src/share/man/man3/Makefile	Thu Oct 17 12:50:36 2013
@@ -1,7 +1,7 @@
-#	$NetBSD: Makefile,v 1.81 2012/12/07 01:54:41 christos Exp $
+#	$NetBSD: Makefile,v 1.82 2013/10/17 16:50:36 christos Exp $
 #	@(#)Makefile	8.2 (Berkeley) 12/13/93
 
-MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.3 CMSG_DATA.3 \
+MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.3 __USE.3 CMSG_DATA.3 \
 	__alignof__.3 __arraycount.3 \
 	__builtin_constant_p.3 __builtin_prefetch.3 \
 	__builtin_return_address.3 \

Added files:

Index: src/share/man/man3/__USE.3
diff -u /dev/null src/share/man/man3/__USE.3:1.1
--- /dev/null	Thu Oct 17 12:50:36 2013
+++ src/share/man/man3/__USE.3	Thu Oct 17 12:50:36 2013
@@ -0,0 +1,122 @@
+.\	$NetBSD: __USE.3,v 1.1 2013/10/17 16:50:36 christos Exp $
+.\
+.\ Copyright (c) 2013 The NetBSD Foundation, Inc.
+.\ All rights reserved.
+.\
+.\ 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 October 17, 2013
+.Dt __USE 3
+.Os
+.Sh NAME
+.Nm __USE
+.Nd compile time macro that marks a variable as being used.
+.Sh SYNOPSIS
+.In sys/cdefs.h
+.Ft void
+.Fn __USE x
+.Sh DESCRIPTION
+The
+.Nm __USE
+macro can be used to omit warnings produced by certain compilers when
+variables are being set, but not used in a function.
+.Pp
+There are cases where it is simpler to mark a variable as used, as opposed
+to ifdef out its use:
+.Bd -literal -offset indent
+#ifdef DEBUG_FOO
+#define DPRINTF(a) printf a
+#else
+#define DPRINTF(a)
+
+void
+foo(void) {
+	int var;
+
+	var = getval();
+
+	DPRINTF((val is %d\n, val));
+}
+.Ed
+.Pp
+In this case, ifdefing the code would make it:
+.Bd -literal -offset indent
+void
+foo(void) {
+#ifdef DEBUG_FOO
+	int var;
+
+	var = getval();
+
+	DPRINTF((val is %d\n, val));
+#else
+	(void)getval();
+#endif
+}
+.Ed
+.Pp
+This is not desirable because it duplicates code.
+With the
+.Nm __USE
+macro this can be written as:
+.Bd -literal -offset indent
+void
+foo(void) {
+	int var;
+
+	var = getval();
+
+#ifdef DEBUG_FOO
+	DPRINTF((val is %d\n, val));
+#else
+	__USE(var);
+#endif
+}
+.Ed
+.Pp
+without producing compiler warnings.
+.Pp
+Although it is simple to write:
+.Bd -literal -offset indent
+	(void)var;
+.Ed
+.Pp
+abstracting this into the macro allows for alternate implementations,
+as well as changing it to an empty implementation so that the liveness
+of the variable can be re-evaluated.
+.Sh IMPLEMENTATION NOTES
+.Nm
+is implemented as:
+.Bd -literal -offset indent
+#define __USE(a)	((void)(a))
+.Ed
+.Sh SEE ALSO
+.Xr cc 1 ,
+.Xr cdefs 3
+.Sh CAVEATS
+.Nm
+should be used sparingly as it can cause valid warnings to be hidden.
+.Pp
+Use of this macro is non-portable; this is part of the implementation
+namespace and should only be used in 
+.Nx
+code.

CVS commit: src/share/man/man3

[John Nemeth]

Module Name:src
Committed By:   jnemeth
Date:   Thu Oct 17 19:37:56 UTC 2013

Modified Files:
src/share/man/man3: __USE.3

Log Message:
- DPRINTF((val is %d\n, val)); - DPRINTF((val is %d\n, var));
- mdoclint:
  - .Nd should not end with period
  - remove trailing spaces


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/share/man/man3/__USE.3

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/man3/__USE.3
diff -u src/share/man/man3/__USE.3:1.1 src/share/man/man3/__USE.3:1.2
--- src/share/man/man3/__USE.3:1.1	Thu Oct 17 16:50:36 2013
+++ src/share/man/man3/__USE.3	Thu Oct 17 19:37:56 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: __USE.3,v 1.1 2013/10/17 16:50:36 christos Exp $
+.\	$NetBSD: __USE.3,v 1.2 2013/10/17 19:37:56 jnemeth Exp $
 .\
 .\ Copyright (c) 2013 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -29,7 +29,7 @@
 .Os
 .Sh NAME
 .Nm __USE
-.Nd compile time macro that marks a variable as being used.
+.Nd compile time macro that marks a variable as being used
 .Sh SYNOPSIS
 .In sys/cdefs.h
 .Ft void
@@ -54,7 +54,7 @@ foo(void) {
 
 	var = getval();
 
-	DPRINTF((val is %d\n, val));
+	DPRINTF((val is %d\n, var));
 }
 .Ed
 .Pp
@@ -67,7 +67,7 @@ foo(void) {
 
 	var = getval();
 
-	DPRINTF((val is %d\n, val));
+	DPRINTF((val is %d\n, var));
 #else
 	(void)getval();
 #endif
@@ -86,7 +86,7 @@ foo(void) {
 	var = getval();
 
 #ifdef DEBUG_FOO
-	DPRINTF((val is %d\n, val));
+	DPRINTF((val is %d\n, var));
 #else
 	__USE(var);
 #endif
@@ -117,6 +117,6 @@ is implemented as:
 should be used sparingly as it can cause valid warnings to be hidden.
 .Pp
 Use of this macro is non-portable; this is part of the implementation
-namespace and should only be used in 
+namespace and should only be used in
 .Nx
 code.

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Thu Oct 17 20:43:49 UTC 2013

Modified Files:
src/share/man/man3: __CONCAT.3 __UNCONST.3

Log Message:
Remove trailing whitespace.


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 src/share/man/man3/__CONCAT.3
cvs rdiff -u -r1.6 -r1.7 src/share/man/man3/__UNCONST.3

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/man3/__CONCAT.3
diff -u src/share/man/man3/__CONCAT.3:1.7 src/share/man/man3/__CONCAT.3:1.8
--- src/share/man/man3/__CONCAT.3:1.7	Thu Oct 17 16:50:48 2013
+++ src/share/man/man3/__CONCAT.3	Thu Oct 17 20:43:49 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: __CONCAT.3,v 1.7 2013/10/17 16:50:48 christos Exp $ $
+.\	$NetBSD: __CONCAT.3,v 1.8 2013/10/17 20:43:49 wiz Exp $ $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -103,6 +103,6 @@ comments to whitespace before any macros
 The use of either macro is discouraged in complex constructs.
 .Pp
 Use of this macro is non-portable; this is part of the implementation
-namespace and should only be used in 
+namespace and should only be used in
 .Nx
 code.

Index: src/share/man/man3/__UNCONST.3
diff -u src/share/man/man3/__UNCONST.3:1.6 src/share/man/man3/__UNCONST.3:1.7
--- src/share/man/man3/__UNCONST.3:1.6	Thu Oct 17 16:50:48 2013
+++ src/share/man/man3/__UNCONST.3	Thu Oct 17 20:43:49 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: __UNCONST.3,v 1.6 2013/10/17 16:50:48 christos Exp $
+.\	$NetBSD: __UNCONST.3,v 1.7 2013/10/17 20:43:49 wiz Exp $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -83,6 +83,6 @@ pointer to
 .Xr memset 3 .
 .Pp
 Use of this macro is non-portable; this is part of the implementation
-namespace and should only be used in 
+namespace and should only be used in
 .Nx
 code.

CVS commit: src/share/man/man3

[Paul Goyette]

Module Name:src
Committed By:   pgoyette
Date:   Fri Mar 29 20:58:58 UTC 2013

Modified Files:
src/share/man/man3: tree.3

Log Message:
Minor typo


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 src/share/man/man3/tree.3

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/man3/tree.3
diff -u src/share/man/man3/tree.3:1.7 src/share/man/man3/tree.3:1.8
--- src/share/man/man3/tree.3:1.7	Tue Dec 21 18:05:05 2010
+++ src/share/man/man3/tree.3	Fri Mar 29 20:58:58 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: tree.3,v 1.7 2010/12/21 18:05:05 njoly Exp $
+.\	$NetBSD: tree.3,v 1.8 2013/03/29 20:58:58 pgoyette Exp $
 .\	$OpenBSD: tree.3,v 1.9 2003/05/20 09:13:38 jmc Exp $
 .\/*
 .\ * Copyright 2002 Niels Provos pro...@citi.umich.edu
@@ -228,7 +228,7 @@ macro, but should be used only once.
 Finally,
 the
 .Fa CMP
-argument is the name of a function used to compare trees noded
+argument is the name of a function used to compare tree nodes
 with each other.
 The function takes two arguments of type
 .Fa struct TYPE * .

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Fri Mar 29 21:16:31 UTC 2013

Modified Files:
src/share/man/man3: tree.3

Log Message:
sync with OpenBSD.


To generate a diff of this commit:
cvs rdiff -u -r1.8 -r1.9 src/share/man/man3/tree.3

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/man3/tree.3
diff -u src/share/man/man3/tree.3:1.8 src/share/man/man3/tree.3:1.9
--- src/share/man/man3/tree.3:1.8	Fri Mar 29 16:58:58 2013
+++ src/share/man/man3/tree.3	Fri Mar 29 17:16:31 2013
@@ -1,5 +1,5 @@
-.\	$NetBSD: tree.3,v 1.8 2013/03/29 20:58:58 pgoyette Exp $
-.\	$OpenBSD: tree.3,v 1.9 2003/05/20 09:13:38 jmc Exp $
+.\	$NetBSD: tree.3,v 1.9 2013/03/29 21:16:31 christos Exp $
+.\	$OpenBSD: tree.3,v 1.23 2011/07/09 08:43:01 jmc Exp $
 .\/*
 .\ * Copyright 2002 Niels Provos pro...@citi.umich.edu
 .\ * All rights reserved.
@@ -12,11 +12,6 @@
 .\ * 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.
-.\ * 3. All advertising materials mentioning features or use of this software
-.\ *must display the following acknowledgement:
-.\ *  This product includes software developed by Niels Provos.
-.\ * 4. The name of the author may not be used to endorse or promote products
-.\ *derived from this software without specific prior written permission.
 .\ *
 .\ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 .\ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
@@ -29,7 +24,7 @@
 .\ * (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 May 5, 2010
+.Dd July 9 2011
 .Dt TREE 3
 .Os
 .Sh NAME
@@ -51,20 +46,27 @@
 .Nm SPLAY_INSERT ,
 .Nm SPLAY_REMOVE ,
 .Nm RB_PROTOTYPE ,
+.Nm RB_PROTOTYPE_STATIC ,
 .Nm RB_GENERATE ,
+.Nm RB_GENERATE_STATIC ,
 .Nm RB_ENTRY ,
 .Nm RB_HEAD ,
 .Nm RB_INITIALIZER ,
 .Nm RB_ROOT ,
 .Nm RB_EMPTY ,
 .Nm RB_NEXT ,
+.Nm RB_PREV ,
 .Nm RB_MIN ,
 .Nm RB_MAX ,
 .Nm RB_FIND ,
+.Nm RB_NFIND ,
 .Nm RB_LEFT ,
 .Nm RB_RIGHT ,
 .Nm RB_PARENT ,
 .Nm RB_FOREACH ,
+.Nm RB_FOREACH_SAFE ,
+.Nm RB_FOREACH_REVERSE ,
+.Nm RB_FOREACH_REVERSE_SAFE ,
 .Nm RB_INIT ,
 .Nm RB_INSERT ,
 .Nm RB_REMOVE
@@ -78,7 +80,7 @@
 .Ft struct TYPE *
 .Fn SPLAY_INITIALIZER SPLAY_HEAD *head
 .Fn SPLAY_ROOT SPLAY_HEAD *head
-.Ft bool
+.Ft int
 .Fn SPLAY_EMPTY SPLAY_HEAD *head
 .Ft struct TYPE *
 .Fn SPLAY_NEXT NAME SPLAY_HEAD *head struct TYPE *elm
@@ -101,29 +103,38 @@
 .Fn SPLAY_REMOVE NAME SPLAY_HEAD *head struct TYPE *elm
 .Pp
 .Fn RB_PROTOTYPE NAME TYPE FIELD CMP
+.Fn RB_PROTOTYPE_STATIC NAME TYPE FIELD CMP
 .Fn RB_GENERATE NAME TYPE FIELD CMP
+.Fn RB_GENERATE_STATIC NAME TYPE FIELD CMP
 .Fn RB_ENTRY TYPE
 .Fn RB_HEAD HEADNAME TYPE
 .Fn RB_INITIALIZER RB_HEAD *head
 .Ft struct TYPE *
 .Fn RB_ROOT RB_HEAD *head
-.Ft bool
+.Ft int
 .Fn RB_EMPTY RB_HEAD *head
 .Ft struct TYPE *
 .Fn RB_NEXT NAME RB_HEAD *head struct TYPE *elm
 .Ft struct TYPE *
+.Fn RB_PREV NAME RB_HEAD *head struct TYPE *elm
+.Ft struct TYPE *
 .Fn RB_MIN NAME RB_HEAD *head
 .Ft struct TYPE *
 .Fn RB_MAX NAME RB_HEAD *head
 .Ft struct TYPE *
 .Fn RB_FIND NAME RB_HEAD *head struct TYPE *elm
 .Ft struct TYPE *
+.Fn RB_NFIND NAME RB_HEAD *head struct TYPE *elm
+.Ft struct TYPE *
 .Fn RB_LEFT struct TYPE *elm RB_ENTRY NAME
 .Ft struct TYPE *
 .Fn RB_RIGHT struct TYPE *elm RB_ENTRY NAME
 .Ft struct TYPE *
 .Fn RB_PARENT struct TYPE *elm RB_ENTRY NAME
 .Fn RB_FOREACH VARNAME NAME RB_HEAD *head
+.Fn RB_FOREACH_SAFE VARNAME NAME RB_HEAD *head TEMP_VARNAME
+.Fn RB_FOREACH_REVERSE VARNAME NAME RB_HEAD *head
+.Fn RB_FOREACH_REVERSE_SAFE VARNAME NAME RB_HEAD *head TEMP_VARNAME
 .Ft void
 .Fn RB_INIT RB_HEAD *head
 .Ft struct TYPE *
@@ -142,12 +153,12 @@ splay trees and red-black trees.
 .Pp
 In the macro definitions,
 .Fa TYPE
-is the name tag of a user defined structure that must contain a field of type
-.Li SPLAY_ENTRY ,
+is the name tag of a user defined structure that must contain a field named
+.Fa FIELD ,
+of type
+.Li SPLAY_ENTRY
 or
-.Li RB_ENTRY ,
-named
-.Fa ENTRYNAME .
+.Li RB_ENTRY .
 The argument
 .Fa HEADNAME
 is the name tag of a user defined structure that must be declared
@@ -159,14 +170,16 @@ The argument
 .Fa NAME
 has to be a unique name prefix for every tree that is defined.
 .Pp
-The function prototypes are declared with either
-.Li SPLAY_PROTOTYPE
+The function prototypes are declared with
+.Li SPLAY_PROTOTYPE ,
+.Li RB_PROTOTYPE ,
 or
-.Li RB_PROTOTYPE .
-The function bodies are generated with either
-.Li SPLAY_GENERATE
+.Li RB_PROTOTYPE_STATIC .
+The function bodies are generated with
+.Li SPLAY_GENERATE ,
+.Li RB_GENERATE ,
 or
-.Li RB_GENERATE .
+.Li RB_GENERATE_STATIC .
 See the examples below for further 

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Mar 29 21:45:27 UTC 2013

Modified Files:
src/share/man/man3: tree.3

Log Message:
Fix date and conflict; use Dv for NULL.


To generate a diff of this commit:
cvs rdiff -u -r1.9 -r1.10 src/share/man/man3/tree.3

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/man3/tree.3
diff -u src/share/man/man3/tree.3:1.9 src/share/man/man3/tree.3:1.10
--- src/share/man/man3/tree.3:1.9	Fri Mar 29 21:16:31 2013
+++ src/share/man/man3/tree.3	Fri Mar 29 21:45:27 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: tree.3,v 1.9 2013/03/29 21:16:31 christos Exp $
+.\	$NetBSD: tree.3,v 1.10 2013/03/29 21:45:27 wiz Exp $
 .\	$OpenBSD: tree.3,v 1.23 2011/07/09 08:43:01 jmc Exp $
 .\/*
 .\ * Copyright 2002 Niels Provos pro...@citi.umich.edu
@@ -24,7 +24,7 @@
 .\ * (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 July 9 2011
+.Dd July 9, 2011
 .Dt TREE 3
 .Os
 .Sh NAME
@@ -241,11 +241,7 @@ macro, but should be used only once.
 Finally,
 the
 .Fa CMP
- tree.3
 argument is the name of a function used to compare trees' nodes
-===
-argument is the name of a function used to compare tree nodes
- 1.8
 with each other.
 The function takes two arguments of type
 .Fa struct TYPE * .
@@ -273,7 +269,7 @@ macro inserts the new element
 .Fa elm
 into the tree.
 Upon success,
-.Va NULL
+.Dv NULL
 is returned.
 If a matching element already exists in the tree, the insertion is
 aborted, and a pointer to the existing element is returned.
@@ -285,7 +281,7 @@ macro removes the element
 from the tree pointed by
 .Fa head .
 Upon success, a pointer to the removed element is returned.
-.Va NULL
+.Dv NULL
 is returned if
 .Fa elm
 is not present in the tree.
@@ -418,7 +414,7 @@ macro inserts the new element
 .Fa elm
 into the tree.
 Upon success,
-.Va NULL
+.Dv NULL
 is returned.
 If a matching element already exists in the tree, the insertion is
 aborted, and a pointer to the existing element is returned.
@@ -455,7 +451,7 @@ The
 .Fn RB_ROOT ,
 .Fn RB_MIN ,
 .Fn RB_MAX ,
-.Fn RB_NEXT,
+.Fn RB_NEXT ,
 and
 .Fn RB_PREV
 macros can be used to traverse the tree:

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Fri Mar 29 22:51:05 UTC 2013

Modified Files:
src/share/man/man3: tree.3

Log Message:
fix merge conflicts


To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/share/man/man3/tree.3

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/man3/tree.3
diff -u src/share/man/man3/tree.3:1.10 src/share/man/man3/tree.3:1.11
--- src/share/man/man3/tree.3:1.10	Fri Mar 29 17:45:27 2013
+++ src/share/man/man3/tree.3	Fri Mar 29 18:51:04 2013
@@ -1,4 +1,4 @@
-.\	$NetBSD: tree.3,v 1.10 2013/03/29 21:45:27 wiz Exp $
+.\	$NetBSD: tree.3,v 1.11 2013/03/29 22:51:04 christos Exp $
 .\	$OpenBSD: tree.3,v 1.23 2011/07/09 08:43:01 jmc Exp $
 .\/*
 .\ * Copyright 2002 Niels Provos pro...@citi.umich.edu
@@ -241,7 +241,7 @@ macro, but should be used only once.
 Finally,
 the
 .Fa CMP
-argument is the name of a function used to compare trees' nodes
+argument is the name of a function used to compare tree nodes
 with each other.
 The function takes two arguments of type
 .Fa struct TYPE * .

CVS commit: src/share/man/man3

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Wed Mar 13 13:38:05 UTC 2013

Modified Files:
src/share/man/man3: rbtree.3

Log Message:
Fix documentation of rbtree(3) iteration.

. Fix sense of rb_tree_iterate(rbt, NULL, ...).
. Document RB_TREE_MIN/RB_TREE_MAX to avoid relying on that sense.
. Document RB_TREE_FOREACH and RB_TREE_FOREACH_REVERSE to simplify
iteration.

Addresses PR lib/46034 and PR lib/47144.  It would have been nice to
make `x = NULL; while ((x = rb_tree_iterate(t, NULL, ...)) != NULL)'
DTRT to traverse t, but it's too much late for that now.

We probably ought to have an RB_TREE_FOREACH{,_REVERSE}_SAFE too.

ok christos


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 src/share/man/man3/rbtree.3

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/man3/rbtree.3
diff -u src/share/man/man3/rbtree.3:1.7 src/share/man/man3/rbtree.3:1.8
--- src/share/man/man3/rbtree.3:1.7	Sun Aug 19 19:31:13 2012
+++ src/share/man/man3/rbtree.3	Wed Mar 13 13:38:05 2013
@@ -1,4 +1,4 @@
-.\ $NetBSD: rbtree.3,v 1.7 2012/08/19 19:31:13 wiz Exp $
+.\ $NetBSD: rbtree.3,v 1.8 2013/03/13 13:38:05 riastradh 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 August 19, 2012
+.Dd March 13, 2013
 .Dt RBTREE 3
 .Os
 .Sh NAME
@@ -50,7 +50,13 @@
 .Ft void *
 .Fn rb_tree_find_node_leq rb_tree_t *rbt const void *key
 .Ft void *
-.Fn rb_tree_iterate rb_tree_t *rbt void *rb const unsigned int direction
+.Fn rb_tree_iterate rb_tree_t *rbt void *rb unsigned int direction
+.Ft void *
+.Fn RB_TREE_MIN rb_tree_t *rbt
+.Ft void *
+.Fn RB_TREE_MAX rb_tree_t *rbt
+.Fn RB_TREE_FOREACH void *rb rb_tree_t *rbt
+.Fn RB_TREE_FOREACH_REVERSE void *rb rb_tree_t *rbt
 .Sh DESCRIPTION
 .Nm
 provides red-black trees.
@@ -190,7 +196,7 @@ or, if
 .Fa rb
 is
 .Dv NULL ,
-return the last node in
+return the first node in
 .Fa rbt
 or, if the tree is empty, return
 .Dv NULL .
@@ -207,10 +213,44 @@ or, if
 .Fa rb
 is
 .Dv NULL ,
-return the first node in
+return the last node in
 .Fa rbt
 or, if the tree is empty, return
 .Dv NULL .
+.It Fn RB_TREE_MIN rbt
+Return the first node in
+.Fa rbt ,
+i.e. the node with the least key, or
+.Dv NULL
+if
+.Fa rbt
+is empty.
+.It Fn RB_TREE_MAX rbt
+Return the last node in
+.Fa rbt ,
+i.e. the node with the greatest key, or
+.Dv NULL
+if
+.Fa rbt
+is empty.
+.It Fn RB_TREE_FOREACH rb rbt
+.Nm RB_TREE_FOREACH
+is a macro to be used in the place of a
+.Dv for
+header preceding a statement to traverse the nodes in
+.Fa rbt
+from least to greatest, assigning
+.Fa rb
+to each node in turn and executing the statement.
+.It Fn RB_TREE_FOREACH_REVERSE rb rbt
+.Nm RB_TREE_FOREACH_REVERSE
+is a macro to be used in the place of a
+.Dv for
+header preceding a statement to traverse the nodes in
+.Fa rbt
+from greatest to least, assigning
+.Fa rb
+to each node in turn and executing the statement.
 .El
 .Sh CODE REFERENCES
 The

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Fri Dec  7 01:54:42 UTC 2012

Modified Files:
src/share/man/man3: Makefile bitmap.3

Log Message:
add __BITMAP_TYPE


To generate a diff of this commit:
cvs rdiff -u -r1.80 -r1.81 src/share/man/man3/Makefile
cvs rdiff -u -r1.6 -r1.7 src/share/man/man3/bitmap.3

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/man3/Makefile
diff -u src/share/man/man3/Makefile:1.80 src/share/man/man3/Makefile:1.81
--- src/share/man/man3/Makefile:1.80	Sat Dec  1 15:33:02 2012
+++ src/share/man/man3/Makefile	Thu Dec  6 20:54:41 2012
@@ -1,4 +1,4 @@
-#	$NetBSD: Makefile,v 1.80 2012/12/01 20:33:02 christos Exp $
+#	$NetBSD: Makefile,v 1.81 2012/12/07 01:54:41 christos Exp $
 #	@(#)Makefile	8.2 (Berkeley) 12/13/93
 
 MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.3 CMSG_DATA.3 \
@@ -272,6 +272,7 @@ MLINKS+=bitmap.3 __BITMAP_CLR.3 \
 	bitmap.3 __BITMAP_ISSET.3 \
 	bitmap.3 __BITMAP_SET.3 \
 	bitmap.3 __BITMAP_SIZE.3 \
+	bitmap.3 __BITMAP_TYPE.3 \
 	bitmap.3 __BITMAP_ZERO.3
 
 .include bsd.man.mk

Index: src/share/man/man3/bitmap.3
diff -u src/share/man/man3/bitmap.3:1.6 src/share/man/man3/bitmap.3:1.7
--- src/share/man/man3/bitmap.3:1.6	Tue Dec  4 13:10:25 2012
+++ src/share/man/man3/bitmap.3	Thu Dec  6 20:54:42 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: bitmap.3,v 1.6 2012/12/04 18:10:25 wiz Exp $
+.\	$NetBSD: bitmap.3,v 1.7 2012/12/07 01:54:42 christos Exp $
 .\
 .\ Copyright (c) 2012 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 December 4, 2012
+.Dd December 6, 2012
 .Dt BITMAP 3
 .Os
 .Sh NAME
@@ -35,6 +35,7 @@
 .Nm __BITMAP_ISSET ,
 .Nm __BITMAP_SET ,
 .Nm __BITMAP_SIZE ,
+.Nm __BITMAP_TYPE ,
 .Nm __BITMAP_ZERO
 .Nd bitmap manipulation macros
 .Sh LIBRARY
@@ -45,6 +46,7 @@
 .Fn __BITMAP_ISSET int bit type *bitmap
 .Fn __BITMAP_SET int bit type *bitmap
 .Fn __BITMAP_SIZE type int nbits
+.Fn __BITMAP_TYPE name type int nbits
 .Fn __BITMAP_ZERO type *bitmap
 .Sh DESCRIPTION
 The supplied macros are similar to the
@@ -71,9 +73,10 @@ The following macros are provided for ma
 bitmaps:
 .Pp
 .Fn __BITMAP_CLR bit bitmap
-initializes a descriptor set pointed to by
-.Fa bitmap
-to the null set.
+removes the given
+.Fa bit
+from the
+.Fa bitmap .
 .Pp
 .Fn __BITMAP_ISSET bit bitmap
 is non-zero if
@@ -82,23 +85,31 @@ is a member of
 .Fa bitmap ,
 zero otherwise.
 .Pp
+.Fn __BITMAP_SET bit bitmap
+Sets the given
+.Fa bit
+in the
+.Fa bitmap .
+.Pp
 .Fn __BITMAP_SIZE type nbits
 Returns the number of elements would be required of the given
 .Fa type
 to hold
 .Fa nbits .
 .Pp
-.Fn __BITMAP_SET bit bitmap
-Sets the given
-.Fa bit
-in the
-.Fa bitmap .
+.Fn __BITMAP_TYPE name type nbits
+Declares the properly sized bitmap structure
+of the given
+.Fa type
+that holds
+.Fa nbits
+and is named
+.Fa name .
 .Pp
-.Fn __BITMAP_CLR bit bitmap
-removes the given
-.Fa bit
-from the
-.Fa bitmap .
+.Fn __BITMAP_ZERO bit bitmap
+initializes a descriptor set pointed to by
+.Fa bitmap
+to the null set.
 .Pp
 The behavior of these macros is undefined for negative
 bit values or ones greater than the number of bits the bitmap can hold.
@@ -109,19 +120,19 @@ bit values or ones greater than the numb
 int
 main(int argc, char **argv)
 {
-	uint32_t bitmap[__BITMAP_SIZE(uint32_t, 5000)];
+	__BITMAP_TYPE(, uint32_t, 5000) bitmap;
 
 	/* Initialize the read set to null */
-	__BITMAP_ZERO(bitmap);
+	__BITMAP_ZERO(\*[Am]bitmap);
 
 	/* Set bit 1 */
-	__BITMAP_SET(1, bitmap);
+	__BITMAP_SET(1, \*[Am]bitmap);
 
 	for (size_t i = 0; i \*[Lt] 5000; i++) {
-		if (__BITMAP_ISSET(i, bitmap)) {
+		if (__BITMAP_ISSET(i, \*[Am]bitmap)) {
 			/* Should just print 1 */
 			printf(Bit %zu is set\en, i);
-			__BITMAP_CLR(i, bitmap);
+			__BITMAP_CLR(i, \*[Am]bitmap);
 		}
 		break;
 	}

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Tue Dec  4 18:02:48 UTC 2012

Modified Files:
src/share/man/man3: bitmap.3 bitstring.3

Log Message:
more xref and info


To generate a diff of this commit:
cvs rdiff -u -r1.4 -r1.5 src/share/man/man3/bitmap.3
cvs rdiff -u -r1.14 -r1.15 src/share/man/man3/bitstring.3

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/man3/bitmap.3
diff -u src/share/man/man3/bitmap.3:1.4 src/share/man/man3/bitmap.3:1.5
--- src/share/man/man3/bitmap.3:1.4	Tue Dec  4 01:57:45 2012
+++ src/share/man/man3/bitmap.3	Tue Dec  4 13:02:48 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: bitmap.3,v 1.4 2012/12/04 06:57:45 jruoho Exp $
+.\	$NetBSD: bitmap.3,v 1.5 2012/12/04 18:02:48 christos Exp $
 .\
 .\ Copyright (c) 2012 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -50,7 +50,9 @@
 The supplied macros are similar to the
 .Xr select 2
 .Fn FD_SET
-family, and to the
+family, to the
+.Xr setbit 9 ,
+macros and the
 .Xr bitstring 3
 library.
 They are different from
@@ -58,6 +60,9 @@ They are different from
 because they are designed to handle multiple sized bitmaps at the same time,
 and they can be of any integral type.
 They are different from
+.Xr setbit 9
+because they can operate on different integral types, not just on bytes.
+They are different from
 .Xr bitstring 3
 because they are just macros, they don't allocate memory or use code,
 and they can be used in both kernel and userland.
@@ -126,7 +131,8 @@ main(int argc, char **argv)
 .Sh SEE ALSO
 .Xr select 2 ,
 .Xr bitops 3 ,
-.Xr bitstring 3
+.Xr bitstring 3,
+.Xr setbit 9
 .Sh HISTORY
 The
 .Fn __BITMAP_*

Index: src/share/man/man3/bitstring.3
diff -u src/share/man/man3/bitstring.3:1.14 src/share/man/man3/bitstring.3:1.15
--- src/share/man/man3/bitstring.3:1.14	Tue Dec  4 01:57:45 2012
+++ src/share/man/man3/bitstring.3	Tue Dec  4 13:02:48 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: bitstring.3,v 1.14 2012/12/04 06:57:45 jruoho Exp $
+.\	$NetBSD: bitstring.3,v 1.15 2012/12/04 18:02:48 christos Exp $
 .\
 .\ Copyright (c) 1989, 1991, 1993
 .\	The Regents of the University of California.  All rights reserved.
@@ -172,7 +172,8 @@ make_lpr_available()
 .Ed
 .Sh SEE ALSO
 .Xr bitmap 3 ,
-.Xr malloc 3
+.Xr malloc 3 ,
+.Xr setbit 9
 .Sh HISTORY
 The
 .Nm bitstring

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Tue Dec  4 18:10:25 UTC 2012

Modified Files:
src/share/man/man3: bitmap.3

Log Message:
Whitespace.


To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/share/man/man3/bitmap.3

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/man3/bitmap.3
diff -u src/share/man/man3/bitmap.3:1.5 src/share/man/man3/bitmap.3:1.6
--- src/share/man/man3/bitmap.3:1.5	Tue Dec  4 18:02:48 2012
+++ src/share/man/man3/bitmap.3	Tue Dec  4 18:10:25 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: bitmap.3,v 1.5 2012/12/04 18:02:48 christos Exp $
+.\	$NetBSD: bitmap.3,v 1.6 2012/12/04 18:10:25 wiz Exp $
 .\
 .\ Copyright (c) 2012 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -131,7 +131,7 @@ main(int argc, char **argv)
 .Sh SEE ALSO
 .Xr select 2 ,
 .Xr bitops 3 ,
-.Xr bitstring 3,
+.Xr bitstring 3 ,
 .Xr setbit 9
 .Sh HISTORY
 The

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sat Dec  1 20:33:02 UTC 2012

Modified Files:
src/share/man/man3: Makefile
Added Files:
src/share/man/man3: bitmap.3

Log Message:
add documentation for the bitmap macros


To generate a diff of this commit:
cvs rdiff -u -r1.79 -r1.80 src/share/man/man3/Makefile
cvs rdiff -u -r0 -r1.1 src/share/man/man3/bitmap.3

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/man3/Makefile
diff -u src/share/man/man3/Makefile:1.79 src/share/man/man3/Makefile:1.80
--- src/share/man/man3/Makefile:1.79	Tue Aug  9 13:58:27 2011
+++ src/share/man/man3/Makefile	Sat Dec  1 15:33:02 2012
@@ -1,4 +1,4 @@
-#	$NetBSD: Makefile,v 1.79 2011/08/09 17:58:27 jruoho Exp $
+#	$NetBSD: Makefile,v 1.80 2012/12/01 20:33:02 christos Exp $
 #	@(#)Makefile	8.2 (Berkeley) 12/13/93
 
 MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.3 CMSG_DATA.3 \
@@ -6,7 +6,7 @@ MAN=	_DIAGASSERT.3 __CONCAT.3 __UNCONST.
 	__builtin_constant_p.3 __builtin_prefetch.3 \
 	__builtin_return_address.3 \
 	__builtin_types_compatible_p.3 __insn_barrier.3 \
-	assert.3 attribute.3 bitops.3 bits.3 bitstring.3 \
+	assert.3 attribute.3 bitmap.3 bitops.3 bits.3 bitstring.3 \
 	cdefs.3 dirent.3 dlfcn.3 dl_iterate_phdr.3 end.3 \
 	fast_divide32.3 ffs32.3 gcq.3 \
 	ilog2.3 intro.3 inttypes.3 iso646.3 limits.3 \
@@ -268,6 +268,11 @@ MLINKS+=CMSG_DATA.3 CMSG_FIRSTHDR.3 \
 	CMSG_DATA.3 CMSG_NXTHDR.3 \
 	CMSG_DATA.3 CMSG_SPACE.3 \
 	CMSG_DATA.3 cmsg.3
+MLINKS+=bitmap.3 __BITMAP_CLR.3 \
+	bitmap.3 __BITMAP_ISSET.3 \
+	bitmap.3 __BITMAP_SET.3 \
+	bitmap.3 __BITMAP_SIZE.3 \
+	bitmap.3 __BITMAP_ZERO.3
 
 .include bsd.man.mk
 .include bsd.subdir.mk

Added files:

Index: src/share/man/man3/bitmap.3
diff -u /dev/null src/share/man/man3/bitmap.3:1.1
--- /dev/null	Sat Dec  1 15:33:02 2012
+++ src/share/man/man3/bitmap.3	Sat Dec  1 15:33:02 2012
@@ -0,0 +1,133 @@
+.\	$NetBSD: bitmap.3,v 1.1 2012/12/01 20:33:02 christos Exp $
+.\
+.\ Copyright (c) 2012 The NetBSD Foundation, Inc.
+.\ All rights reserved.
+.\
+.\ This code is derived from software contributed to The NetBSD Foundation
+.\ by Christos Zoulas.
+.\
+.\ 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 December 1, 2012
+.Dt bitmap 3
+.Os
+.Sh NAME
+.Nm __BITMAP_CLR ,
+.Nm __BITMAP_ISSET,
+.Nm __BITMAP_SET ,
+.Nm __BITMAP_SIZE ,
+.Nm __BITMAP_ZERO 
+.Nd bitmap manipulation macros
+.Sh LIBRARY
+.Lb libc
+.Sh SYNOPSIS
+.In sys/bitops.h
+.Fn __BITMAP_CLR int bit type *bitmap
+.Fn __BITMAP_ISSET int bit type *bitmap
+.Fn __BITMAP_SET int bit type *bitmap
+.Fn __BITMAP_SIZE type int nbits
+.Fn __BITMAP_ZERO type *bitmap
+.Sh DESCRIPTION
+The supplied macros are similar to the 
+.Xr select 2
+.Fn FD_SET
+family, and to the 
+.Xr bitstring 3
+library.
+They are different from
+.Fn FD_SET
+because they are designed to handle multiple sized bitmaps at the same time,
+and they can be of any integral type.
+They are different from
+.Xr bitstring 3
+because they are just macros, they don't allocate memory or use code,
+and they can be used in both kernel and userland.
+.Pp
+The following macros are provided for manipulating creating and manipulating
+bitmaps:
+.Pp
+.Fn __BITMAP_CLR bit, bitmap
+initializes a descriptor set pointed to by
+.Fa bitmap
+to the null set.
+.Pp
+.Fn __BITMAP_ISSET bit bitmap
+is non-zero if
+.Fa bit
+is a member of
+.Fa bitmap ,
+zero otherwise.
+.Pp
+.Fn __BITMAP_SIZE type nbits
+Returns the number of elements would be required of the given
+.Fa type
+to hold
+.Fa nbits .
+.Pp
+.Fn __BITMAP_SET bit bitmap
+Sets the given
+.Fa bit
+in the
+.Fa bitmap .
+.Pp
+.Fn __BITMAP_CLR bit bitmap
+removes the 

CVS commit: src/share/man/man3

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sat Dec  1 20:38:42 UTC 2012

Modified Files:
src/share/man/man3: bitmap.3

Log Message:
fix bug


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/share/man/man3/bitmap.3

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/man3/bitmap.3
diff -u src/share/man/man3/bitmap.3:1.1 src/share/man/man3/bitmap.3:1.2
--- src/share/man/man3/bitmap.3:1.1	Sat Dec  1 15:33:02 2012
+++ src/share/man/man3/bitmap.3	Sat Dec  1 15:38:41 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: bitmap.3,v 1.1 2012/12/01 20:33:02 christos Exp $
+.\	$NetBSD: bitmap.3,v 1.2 2012/12/01 20:38:41 christos Exp $
 .\
 .\ Copyright (c) 2012 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -112,7 +112,7 @@ main(int argc, char **argv)
 	/* Set bit 1 */
 	__BITMAP_SET(1, bitmap);
 
-	for (size_t i = 0; i \*[Lt]= 5000; i++) {
+	for (size_t i = 0; i \*[Lt] 5000; i++) {
 		if (__BITMAP_ISSET(i, bitmap)) {
 			/* Should just print 1 */
 			printf(Bit %zu is set\en, i);

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Sat Dec  1 21:21:44 UTC 2012

Modified Files:
src/share/man/man3: bitmap.3

Log Message:
Whitespace, comma nit, uppercase Dt argument.


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/bitmap.3

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/man3/bitmap.3
diff -u src/share/man/man3/bitmap.3:1.2 src/share/man/man3/bitmap.3:1.3
--- src/share/man/man3/bitmap.3:1.2	Sat Dec  1 20:38:41 2012
+++ src/share/man/man3/bitmap.3	Sat Dec  1 21:21:44 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: bitmap.3,v 1.2 2012/12/01 20:38:41 christos Exp $
+.\	$NetBSD: bitmap.3,v 1.3 2012/12/01 21:21:44 wiz Exp $
 .\
 .\ Copyright (c) 2012 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -28,14 +28,14 @@
 .\ POSSIBILITY OF SUCH DAMAGE.
 .\
 .Dd December 1, 2012
-.Dt bitmap 3
+.Dt BITMAP 3
 .Os
 .Sh NAME
 .Nm __BITMAP_CLR ,
-.Nm __BITMAP_ISSET,
+.Nm __BITMAP_ISSET ,
 .Nm __BITMAP_SET ,
 .Nm __BITMAP_SIZE ,
-.Nm __BITMAP_ZERO 
+.Nm __BITMAP_ZERO
 .Nd bitmap manipulation macros
 .Sh LIBRARY
 .Lb libc
@@ -47,10 +47,10 @@
 .Fn __BITMAP_SIZE type int nbits
 .Fn __BITMAP_ZERO type *bitmap
 .Sh DESCRIPTION
-The supplied macros are similar to the 
+The supplied macros are similar to the
 .Xr select 2
 .Fn FD_SET
-family, and to the 
+family, and to the
 .Xr bitstring 3
 library.
 They are different from
@@ -65,7 +65,7 @@ and they can be used in both kernel and 
 The following macros are provided for manipulating creating and manipulating
 bitmaps:
 .Pp
-.Fn __BITMAP_CLR bit, bitmap
+.Fn __BITMAP_CLR bit bitmap
 initializes a descriptor set pointed to by
 .Fa bitmap
 to the null set.

CVS commit: src/share/man/man3

[SAITOH Masanobu]

Module Name:src
Committed By:   msaitoh
Date:   Tue Oct 16 17:39:35 UTC 2012

Modified Files:
src/share/man/man3: bits.3

Log Message:
Return value of __BIT() and __BITS() is not uint32_t but uint64_t.


To generate a diff of this commit:
cvs rdiff -u -r1.12 -r1.13 src/share/man/man3/bits.3

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/man3/bits.3
diff -u src/share/man/man3/bits.3:1.12 src/share/man/man3/bits.3:1.13
--- src/share/man/man3/bits.3:1.12	Sat Apr 30 19:34:10 2011
+++ src/share/man/man3/bits.3	Tue Oct 16 17:39:35 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: bits.3,v 1.12 2011/04/30 19:34:10 jym Exp $
+.\	$NetBSD: bits.3,v 1.13 2012/10/16 17:39:35 msaitoh Exp $
 .\
 .\ Copyright (c) 2006, 2010 David Young.  All rights reserved.
 .\
@@ -25,7 +25,7 @@
 .\ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\ POSSIBILITY OF SUCH DAMAGE.
 .\
-.Dd April 8, 2011
+.Dd October 17, 2012
 .Dt BITS 3
 .Os
 .Sh NAME
@@ -38,9 +38,9 @@
 .Sh SYNOPSIS
 .In sys/param.h
 .In sys/cdefs.h
-.Ft uint32_t
+.Ft uint64_t
 .Fn __BIT n
-.Ft uint32_t
+.Ft uint64_t
 .Fn __BITS m n
 .Fn __SHIFTIN v mask
 .Fn __SHIFTOUT v mask

CVS commit: src/share/man/man3

[SAITOH Masanobu]

Module Name:src
Committed By:   msaitoh
Date:   Tue Oct 16 19:40:59 UTC 2012

Modified Files:
src/share/man/man3: bits.3

Log Message:
Change to uintmax_t again.


To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 src/share/man/man3/bits.3

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/man3/bits.3
diff -u src/share/man/man3/bits.3:1.13 src/share/man/man3/bits.3:1.14
--- src/share/man/man3/bits.3:1.13	Tue Oct 16 17:39:35 2012
+++ src/share/man/man3/bits.3	Tue Oct 16 19:40:59 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: bits.3,v 1.13 2012/10/16 17:39:35 msaitoh Exp $
+.\	$NetBSD: bits.3,v 1.14 2012/10/16 19:40:59 msaitoh Exp $
 .\
 .\ Copyright (c) 2006, 2010 David Young.  All rights reserved.
 .\
@@ -38,9 +38,9 @@
 .Sh SYNOPSIS
 .In sys/param.h
 .In sys/cdefs.h
-.Ft uint64_t
+.Ft uintmax_t
 .Fn __BIT n
-.Ft uint64_t
+.Ft uintmax_t
 .Fn __BITS m n
 .Fn __SHIFTIN v mask
 .Fn __SHIFTOUT v mask

CVS commit: src/share/man/man3

[Nicolas Joly]

Module Name:src
Committed By:   njoly
Date:   Mon Oct  8 18:20:34 UTC 2012

Modified Files:
src/share/man/man3: queue.3

Log Message:
Remove a tab character in non-literal context.
While here, replace all sp macros with Pp.


To generate a diff of this commit:
cvs rdiff -u -r1.42 -r1.43 src/share/man/man3/queue.3

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/man3/queue.3
diff -u src/share/man/man3/queue.3:1.42 src/share/man/man3/queue.3:1.43
--- src/share/man/man3/queue.3:1.42	Mon Apr 20 09:56:07 2009
+++ src/share/man/man3/queue.3	Mon Oct  8 18:20:34 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: queue.3,v 1.42 2009/04/20 09:56:07 mschuett Exp $
+.\	$NetBSD: queue.3,v 1.43 2012/10/08 18:20:34 njoly Exp $
 .\
 .\ Copyright (c) 2000, 2002 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -154,7 +154,7 @@
 .Nd implementations of singly-linked lists, simple queues, lists, tail queues, and circular queues
 .Sh SYNOPSIS
 .In sys/queue.h
-.sp
+.Pp
 .Fn SLIST_HEAD HEADNAME TYPE
 .Fn SLIST_HEAD_INITIALIZER head
 .Fn SLIST_ENTRY TYPE
@@ -171,7 +171,7 @@
 .Fn SLIST_FIRST SLIST_HEAD *head
 .Ft TYPE *
 .Fn SLIST_NEXT TYPE *elm SLIST_ENTRY NAME
-.sp
+.Pp
 .Fn SIMPLEQ_HEAD HEADNAME TYPE
 .Fn SIMPLEQ_HEAD_INITIALIZER head
 .Fn SIMPLEQ_ENTRY TYPE
@@ -192,7 +192,7 @@
 .Ft TYPE *
 .Fn SIMPLEQ_LAST SIMPLEQ_HEAD *head TYPE *elm SIMPLEQ_ENTRY NAME
 .Fn SIMPLEQ_CONCAT SIMPLEQ_HEAD *head1 SIMPLEQ_HEAD *head2
-.sp
+.Pp
 .Fn STAILQ_HEAD HEADNAME TYPE
 .Fn STAILQ_HEAD_INITIALIZER head
 .Fn STAILQ_ENTRY TYPE
@@ -213,7 +213,7 @@
 .Ft TYPE *
 .Fn STAILQ_LAST STAILQ_HEAD *head TYPE *elm STAILQ_ENTRY NAME
 .Fn STAILQ_CONCAT STAILQ_HEAD *head1 STAILQ_HEAD *head2
-.sp
+.Pp
 .Fn LIST_HEAD HEADNAME TYPE
 .Fn LIST_HEAD_INITIALIZER head
 .Fn LIST_ENTRY TYPE
@@ -229,7 +229,7 @@
 .Fn LIST_FIRST LIST_HEAD *head
 .Ft TYPE *
 .Fn LIST_NEXT TYPE *elm LIST_ENTRY NAME
-.sp
+.Pp
 .Fn TAILQ_HEAD HEADNAME TYPE
 .Fn TAILQ_HEAD_INITIALIZER head
 .Fn TAILQ_ENTRY TYPE
@@ -254,7 +254,7 @@
 .Ft TYPE *
 .Fn TAILQ_PREV TYPE *elm HEADNAME TAILQ_ENTRY NAME
 .Fn TAILQ_CONCAT TAILQ_HEAD *head1 TAILQ_HEAD *head2 TAILQ_ENTRY NAME
-.sp
+.Pp
 .Fn CIRCLEQ_HEAD HEADNAME TYPE
 .Fn CIRCLEQ_HEAD_INITIALIZER head
 .Fn CIRCLEQ_ENTRY TYPE
@@ -319,7 +319,7 @@ Each head entry requires two pointers ra
 .El
 .Pp
 Simple queues are ideal for applications with large datasets and few or
-no removals, or for implementing a FIFO	queue.
+no removals, or for implementing a FIFO queue.
 .Pp
 All doubly linked types of data structures (lists, tail queues, and circle
 queues) additionally allow:
@@ -588,7 +588,7 @@ structure is declared as follows:
 .Bd -literal -offset indent
 SIMPLEQ_HEAD(HEADNAME, TYPE) head;
 .Ed
-.sp
+.Pp
 where
 .Li HEADNAME
 is the name of the structure to be defined, and
@@ -598,7 +598,7 @@ A pointer to the head of the simple queu
 .Bd -literal -offset indent
 struct HEADNAME *headp;
 .Ed
-.sp
+.Pp
 (The names
 .Li head
 and
@@ -771,7 +771,7 @@ structure is declared as follows:
 .Bd -literal -offset indent
 LIST_HEAD(HEADNAME, TYPE) head;
 .Ed
-.sp
+.Pp
 where
 .Fa HEADNAME
 is the name of the structure to be defined, and
@@ -781,7 +781,7 @@ A pointer to the head of the list can la
 .Bd -literal -offset indent
 struct HEADNAME *headp;
 .Ed
-.sp
+.Pp
 (The names
 .Li head
 and
@@ -902,7 +902,7 @@ structure is declared as follows:
 .Bd -literal -offset indent
 TAILQ_HEAD(HEADNAME, TYPE) head;
 .Ed
-.sp
+.Pp
 where
 .Li HEADNAME
 is the name of the structure to be defined, and
@@ -912,7 +912,7 @@ A pointer to the head of the tail queue 
 .Bd -literal -offset indent
 struct HEADNAME *headp;
 .Ed
-.sp
+.Pp
 (The names
 .Li head
 and
@@ -1063,7 +1063,7 @@ structure is declared as follows:
 .Bd -literal -offset indent
 CIRCLEQ_HEAD(HEADNAME, TYPE) head;
 .Ed
-.sp
+.Pp
 where
 .Li HEADNAME
 is the name of the structure to be defined, and
@@ -1073,7 +1073,7 @@ A pointer to the head of the circular qu
 .Bd -literal -offset indent
 struct HEADNAME *headp;
 .Ed
-.sp
+.Pp
 (The names
 .Li head
 and

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Sun Aug 19 19:31:14 UTC 2012

Modified Files:
src/share/man/man3: rbtree.3

Log Message:
Add more function argument names to the man page, trying to address
PR 46814 by Lloyd Parkes. Bump date.


To generate a diff of this commit:
cvs rdiff -u -r1.6 -r1.7 src/share/man/man3/rbtree.3

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/man3/rbtree.3
diff -u src/share/man/man3/rbtree.3:1.6 src/share/man/man3/rbtree.3:1.7
--- src/share/man/man3/rbtree.3:1.6	Fri Feb 17 08:22:47 2012
+++ src/share/man/man3/rbtree.3	Sun Aug 19 19:31:13 2012
@@ -1,4 +1,4 @@
-.\ $NetBSD: rbtree.3,v 1.6 2012/02/17 08:22:47 yamt Exp $
+.\ $NetBSD: rbtree.3,v 1.7 2012/08/19 19:31:13 wiz 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 February 17, 2012
+.Dd August 19, 2012
 .Dt RBTREE 3
 .Os
 .Sh NAME
@@ -38,19 +38,19 @@
 .Sh SYNOPSIS
 .In sys/rbtree.h
 .Ft void
-.Fn rb_tree_init rb_tree_t * const rb_tree_ops_t *
+.Fn rb_tree_init rb_tree_t *rbt const rb_tree_ops_t *ops
 .Ft void *
-.Fn rb_tree_insert_node rb_tree_t * void *
+.Fn rb_tree_insert_node rb_tree_t *rbt void *rb
 .Ft void
-.Fn rb_tree_remove_node rb_tree_t * void *
+.Fn rb_tree_remove_node rb_tree_t *rbt void *rb
 .Ft void *
-.Fn rb_tree_find_node rb_tree_t * const void *
+.Fn rb_tree_find_node rb_tree_t *rbt const void *key
 .Ft void *
-.Fn rb_tree_find_node_geq rb_tree_t * const void *
+.Fn rb_tree_find_node_geq rb_tree_t *rbt const void *key
 .Ft void *
-.Fn rb_tree_find_node_leq rb_tree_t * const void *
+.Fn rb_tree_find_node_leq rb_tree_t *rbt const void *key
 .Ft void *
-.Fn rb_tree_iterate rb_tree_t * void * const unsigned int
+.Fn rb_tree_iterate rb_tree_t *rbt void *rb const unsigned int direction
 .Sh DESCRIPTION
 .Nm
 provides red-black trees.
@@ -74,20 +74,39 @@ The maximum height of a red-black tree i
 .It Vt rb_tree_t
 A red-black tree.
 .It Vt typedef signed int \
-(* rbto_compare_nodes_fn)(void *, const void *, const void *);
+(* rbto_compare_nodes_fn)(void *context, const void *node1, const void *node2);
 The node-comparison operator.
 Defines an ordering on nodes.
-Returns a negative value if the first node precedes the second node.
-Returns a positive value if the first node follows the second node.
-Returns 0 if the first node and the second are identical according
-to the ordering.
+Returns a negative value if the first node
+.Ar node1
+precedes the second node
+.Ar node2 .
+Returns a positive value if the first node
+.Ar node1
+follows the second node
+.Ar node2 .
+Returns 0 if the first node
+.Ar node1
+and the second node
+.Ar node2
+are identical according to the ordering.
 .It Vt typedef signed int \
-(* rbto_compare_key_fn)(void *, const void *, const void *);
+(* rbto_compare_key_fn)(void *context, const void *node, const void *key);
 The node-key comparison operator.
 Defines the order of nodes and keys.
-Returns a negative value if the node precedes the key.
-Returns a positive value if the node follows the key.
-Returns 0 if the node is identical to the key according to the ordering.
+Returns a negative value if the node
+.Ar node
+precedes the key
+.Ar key .
+Returns a positive value if the node
+.Ar node
+follows the key
+.Ar key .
+Returns 0 if the node
+.Ar node
+is identical to the key
+.Ar key
+according to the ordering.
 .It Vt rb_tree_ops_t
 Defines the operator for comparing two nodes in the same tree,
 the operator for comparing a node in the tree with a key,

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Tue Jul  3 09:27:52 UTC 2012

Modified Files:
src/share/man/man3: intro.3

Log Message:
Reference libusbhid instead of usb(3) (which was the predecessor for libusbhid).
Bump date.


To generate a diff of this commit:
cvs rdiff -u -r1.27 -r1.28 src/share/man/man3/intro.3

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/man3/intro.3
diff -u src/share/man/man3/intro.3:1.27 src/share/man/man3/intro.3:1.28
--- src/share/man/man3/intro.3:1.27	Mon Jul  2 21:44:09 2012
+++ src/share/man/man3/intro.3	Tue Jul  3 09:27:52 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: intro.3,v 1.27 2012/07/02 21:44:09 oki Exp $
+.\	$NetBSD: intro.3,v 1.28 2012/07/03 09:27:52 wiz Exp $
 .\
 .\ Copyright (c) 1980, 1991, 1993
 .\	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\
 .\ @(#)intro.3	8.1 (Berkeley) 6/5/93
 .\
-.Dd April 5, 2012
+.Dd July 3, 2012
 .Dt INTRO 3
 .Os
 .Sh NAME
@@ -285,9 +285,9 @@ The terminal-independent operation libra
 See
 .Xr terminfo 3 .
 .It Em libusb Pq Fl l Ns Ar usb
-The Universal Serial Bus (USB) access library.
+The Universal Serial Bus (USB) Human Interface Devices access library.
 See
-.Xr usb 3 .
+.Xr libusbhid 3 .
 .It Em libutil Pq Fl l Ns Ar util
 The system utilities library.
 See

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Tue Jul  3 09:28:08 UTC 2012

Modified Files:
src/share/man/man3: intro.3

Log Message:
Finish previous.


To generate a diff of this commit:
cvs rdiff -u -r1.28 -r1.29 src/share/man/man3/intro.3

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/man3/intro.3
diff -u src/share/man/man3/intro.3:1.28 src/share/man/man3/intro.3:1.29
--- src/share/man/man3/intro.3:1.28	Tue Jul  3 09:27:52 2012
+++ src/share/man/man3/intro.3	Tue Jul  3 09:28:08 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: intro.3,v 1.28 2012/07/03 09:27:52 wiz Exp $
+.\	$NetBSD: intro.3,v 1.29 2012/07/03 09:28:08 wiz Exp $
 .\
 .\ Copyright (c) 1980, 1991, 1993
 .\	The Regents of the University of California.  All rights reserved.
@@ -284,7 +284,7 @@ The telnet library.
 The terminal-independent operation library.
 See
 .Xr terminfo 3 .
-.It Em libusb Pq Fl l Ns Ar usb
+.It Em libusbhid Pq Fl l Ns Ar usbhid
 The Universal Serial Bus (USB) Human Interface Devices access library.
 See
 .Xr libusbhid 3 .

CVS commit: src/share/man/man3

[Masaru OKI]

Module Name:src
Committed By:   oki
Date:   Mon Jul  2 21:44:09 UTC 2012

Modified Files:
src/share/man/man3: intro.3

Log Message:
add reference to usb(3) and zlib(3).


To generate a diff of this commit:
cvs rdiff -u -r1.26 -r1.27 src/share/man/man3/intro.3

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/man3/intro.3
diff -u src/share/man/man3/intro.3:1.26 src/share/man/man3/intro.3:1.27
--- src/share/man/man3/intro.3:1.26	Sat Apr 21 12:27:28 2012
+++ src/share/man/man3/intro.3	Mon Jul  2 21:44:09 2012
@@ -1,4 +1,4 @@
-.\	$NetBSD: intro.3,v 1.26 2012/04/21 12:27:28 roy Exp $
+.\	$NetBSD: intro.3,v 1.27 2012/07/02 21:44:09 oki Exp $
 .\
 .\ Copyright (c) 1980, 1991, 1993
 .\	The Regents of the University of California.  All rights reserved.
@@ -286,8 +286,8 @@ See
 .Xr terminfo 3 .
 .It Em libusb Pq Fl l Ns Ar usb
 The Universal Serial Bus (USB) access library.
-.\ See
-.\ .Xr usb 3 .
+See
+.Xr usb 3 .
 .It Em libutil Pq Fl l Ns Ar util
 The system utilities library.
 See
@@ -301,6 +301,8 @@ The library for
 .Xr yacc 1 .
 .It Em libz Pq Fl l Ns Ar z
 General-purpose compression library.
+See
+.Xr zlib 3 .
 .El
 .Sh SEE ALSO
 .Xr cc 1 ,

CVS commit: src/share/man/man3

[YAMAMOTO Takashi]

Module Name:src
Committed By:   yamt
Date:   Fri Feb 17 08:22:48 UTC 2012

Modified Files:
src/share/man/man3: rbtree.3

Log Message:
sync with code
(remove const quals)


To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/share/man/man3/rbtree.3

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/man3/rbtree.3
diff -u src/share/man/man3/rbtree.3:1.5 src/share/man/man3/rbtree.3:1.6
--- src/share/man/man3/rbtree.3:1.5	Mon Mar 28 13:46:14 2011
+++ src/share/man/man3/rbtree.3	Fri Feb 17 08:22:47 2012
@@ -1,4 +1,4 @@
-.\ $NetBSD: rbtree.3,v 1.5 2011/03/28 13:46:14 ahoka Exp $
+.\ $NetBSD: rbtree.3,v 1.6 2012/02/17 08:22:47 yamt 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 17, 2011
+.Dd February 17, 2012
 .Dt RBTREE 3
 .Os
 .Sh NAME
@@ -74,7 +74,7 @@ The maximum height of a red-black tree i
 .It Vt rb_tree_t
 A red-black tree.
 .It Vt typedef signed int \
-(*const rbto_compare_nodes_fn)(void *, const void *, const void *);
+(* rbto_compare_nodes_fn)(void *, const void *, const void *);
 The node-comparison operator.
 Defines an ordering on nodes.
 Returns a negative value if the first node precedes the second node.
@@ -82,7 +82,7 @@ Returns a positive value if the first no
 Returns 0 if the first node and the second are identical according
 to the ordering.
 .It Vt typedef signed int \
-(*const rbto_compare_key_fn)(void *, const void *, const void *);
+(* rbto_compare_key_fn)(void *, const void *, const void *);
 The node-key comparison operator.
 Defines the order of nodes and keys.
 Returns a negative value if the node precedes the key.

CVS commit: src/share/man/man3

[Jean-Yves Migeon]

Module Name:src
Committed By:   jym
Date:   Sun Sep 18 17:43:20 UTC 2011

Modified Files:
src/share/man/man3: attribute.3

Log Message:
typo: prefict - predict


To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/share/man/man3/attribute.3

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/man3/attribute.3
diff -u src/share/man/man3/attribute.3:1.10 src/share/man/man3/attribute.3:1.11
--- src/share/man/man3/attribute.3:1.10	Sat Mar 19 04:59:44 2011
+++ src/share/man/man3/attribute.3	Sun Sep 18 17:43:20 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: attribute.3,v 1.10 2011/03/19 04:59:44 jruoho Exp $
+.\ $NetBSD: attribute.3,v 1.11 2011/09/18 17:43:20 jym Exp $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -59,7 +59,7 @@
 .Pp
 .Fn __predict_true exp
 .Pp
-.Fn __prefict_false exp
+.Fn __predict_false exp
 .Sh DESCRIPTION
 The
 .Tn GNU

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Sat Jun 25 12:44:37 UTC 2011

Modified Files:
src/share/man/man3: dlfcn.3

Log Message:
Bump date for previous.


To generate a diff of this commit:
cvs rdiff -u -r1.32 -r1.33 src/share/man/man3/dlfcn.3

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/man3/dlfcn.3
diff -u src/share/man/man3/dlfcn.3:1.32 src/share/man/man3/dlfcn.3:1.33
--- src/share/man/man3/dlfcn.3:1.32	Sat Jun 25 05:45:11 2011
+++ src/share/man/man3/dlfcn.3	Sat Jun 25 12:44:37 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: dlfcn.3,v 1.32 2011/06/25 05:45:11 nonaka Exp $
+.\	$NetBSD: dlfcn.3,v 1.33 2011/06/25 12:44:37 wiz Exp $
 .\
 .\ Copyright (c) 1998 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 February 13, 2011
+.Dd June 25, 2011
 .Dt DLFCN 3
 .Os
 .Sh NAME

CVS commit: src/share/man/man3

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Tue May 10 06:39:46 UTC 2011

Modified Files:
src/share/man/man3: ilog2.3

Log Message:
Xref ilogb(3).


To generate a diff of this commit:
cvs rdiff -u -r1.4 -r1.5 src/share/man/man3/ilog2.3

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/man3/ilog2.3
diff -u src/share/man/man3/ilog2.3:1.4 src/share/man/man3/ilog2.3:1.5
--- src/share/man/man3/ilog2.3:1.4	Fri Apr  8 08:40:05 2011
+++ src/share/man/man3/ilog2.3	Tue May 10 06:39:45 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: ilog2.3,v 1.4 2011/04/08 08:40:05 jruoho Exp $ $
+.\ $NetBSD: ilog2.3,v 1.5 2011/05/10 06:39:45 jruoho 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 April 8, 2011
+.Dd May 10, 2011
 .Dt ILOG2 3
 .Os
 .Sh NAME
@@ -55,6 +55,7 @@
 A value \-1 is returned on error.
 .Sh SEE ALSO
 .Xr bitops 3 ,
+.Xr ilogb 3 ,
 .Xr log2 3 ,
 .Xr imax 9 ,
 .Xr powerof2 9

CVS commit: src/share/man/man3

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Tue May 10 12:09:00 UTC 2011

Modified Files:
src/share/man/man3: fast_divide32.3

Log Message:
Xref div(3) and remainder(3).


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 src/share/man/man3/fast_divide32.3

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/man3/fast_divide32.3
diff -u src/share/man/man3/fast_divide32.3:1.7 src/share/man/man3/fast_divide32.3:1.8
--- src/share/man/man3/fast_divide32.3:1.7	Fri Apr  8 08:40:05 2011
+++ src/share/man/man3/fast_divide32.3	Tue May 10 12:09:00 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: fast_divide32.3,v 1.7 2011/04/08 08:40:05 jruoho Exp $
+.\	$NetBSD: fast_divide32.3,v 1.8 2011/05/10 12:09:00 jruoho 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 April 8, 2011
+.Dd May 10, 2011
 .Dt FAST_DIVIDE32 3
 .Os
 .Sh NAME
@@ -92,7 +92,9 @@
 r = fast_remainder32(a, b, m, s1, s2);
 .Ed
 .Sh SEE ALSO
-.Xr bitops 3
+.Xr bitops 3 ,
+.Xr div 3 ,
+.Xr remainder 3
 .Rs
 .%A Torbj\(:orn Granlund
 .%A Peter L. Montgomery

CVS commit: src/share/man/man3

[Jean-Yves Migeon]

Module Name:src
Committed By:   jym
Date:   Sat Apr 30 19:34:11 UTC 2011

Modified Files:
src/share/man/man3: bits.3

Log Message:
Small typo fix.


To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/share/man/man3/bits.3

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/man3/bits.3
diff -u src/share/man/man3/bits.3:1.11 src/share/man/man3/bits.3:1.12
--- src/share/man/man3/bits.3:1.11	Fri Apr  8 08:40:05 2011
+++ src/share/man/man3/bits.3	Sat Apr 30 19:34:10 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: bits.3,v 1.11 2011/04/08 08:40:05 jruoho Exp $
+.\	$NetBSD: bits.3,v 1.12 2011/04/30 19:34:10 jym Exp $
 .\
 .\ Copyright (c) 2006, 2010 David Young.  All rights reserved.
 .\
@@ -61,7 +61,9 @@
 .Pp
 .Bl -tag -width __BITS -offset indent
 .It Fn __BIT n
-Return a bitmask with bit m set, where the least significant bit is bit 0.
+Return a bitmask with bit
+.Fa n
+set, where the least significant bit is bit 0.
 .It Fn __BITS m n
 Return a bitmask with bits
 .Fa m

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Thu Apr 14 06:56:28 UTC 2011

Modified Files:
src/share/man/man3: __alignof__.3 offsetof.3

Log Message:
No need to use \*[q], use plain double quotes instead.


To generate a diff of this commit:
cvs rdiff -u -r1.4 -r1.5 src/share/man/man3/__alignof__.3 \
src/share/man/man3/offsetof.3

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/man3/__alignof__.3
diff -u src/share/man/man3/__alignof__.3:1.4 src/share/man/man3/__alignof__.3:1.5
--- src/share/man/man3/__alignof__.3:1.4	Mon Dec 20 19:15:26 2010
+++ src/share/man/man3/__alignof__.3	Thu Apr 14 06:56:28 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: __alignof__.3,v 1.4 2010/12/20 19:15:26 jruoho Exp $
+.\ $NetBSD: __alignof__.3,v 1.5 2011/04/14 06:56:28 wiz Exp $
 .\
 .\ Copyright (c) 2010 Jukka Ruohonen jruoho...@iki.fi
 .\ All rights reserved.
@@ -61,7 +61,7 @@
 If the architecture aligns integers along 32-bit address boundaries,
 the following should print the value 4.
 .Bd -literal -offset indent
-(void)printf(\*[q]%d\en\*[q], __alignof__(int));
+(void)printf(%d\en, __alignof__(int));
 .Ed
 .Pp
 On the other hand, the following example should print the value 1,
@@ -73,7 +73,7 @@
 	char y;
 } a;
 
-(void)printf(\*[q]%d\en\*[q], __alignof__(a.y));
+(void)printf(%d\en, __alignof__(a.y));
 .Ed
 .Sh SEE ALSO
 .Xr gcc 1 ,
Index: src/share/man/man3/offsetof.3
diff -u src/share/man/man3/offsetof.3:1.4 src/share/man/man3/offsetof.3:1.5
--- src/share/man/man3/offsetof.3:1.4	Fri Apr  1 05:24:37 2011
+++ src/share/man/man3/offsetof.3	Thu Apr 14 06:56:28 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: offsetof.3,v 1.4 2011/04/01 05:24:37 jruoho Exp $
+.\	$NetBSD: offsetof.3,v 1.5 2011/04/14 06:56:28 wiz Exp $
 .\
 .\	$OpenBSD: offsetof.3,v 1.2 2010/02/18 18:30:19 jmc Exp $
 .\
@@ -59,7 +59,7 @@
 y = offsetof(struct example, y);
 z = offsetof(struct example, z);
 
-(void)printf(\*[q]%zu %zu %zu\en\*[q], x, y, z);
+(void)printf(%zu %zu %zu\en, x, y, z);
 .Ed
 .Sh SEE ALSO
 .Xr __alignof__ 3 ,

CVS commit: src/share/man/man3

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Tue Apr 12 13:48:29 UTC 2011

Modified Files:
src/share/man/man3: tm.3

Log Message:
Put asctime(3) explicitly to SEE ALSO.


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/tm.3

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/man3/tm.3
diff -u src/share/man/man3/tm.3:1.2 src/share/man/man3/tm.3:1.3
--- src/share/man/man3/tm.3:1.2	Tue Apr 12 08:39:26 2011
+++ src/share/man/man3/tm.3	Tue Apr 12 13:48:29 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: tm.3,v 1.2 2011/04/12 08:39:26 jruoho Exp $
+.\ $NetBSD: tm.3,v 1.3 2011/04/12 13:48:29 jruoho Exp $
 .\
 .\ Copyright (c) 2011 Jukka Ruohonen jruoho...@iki.fi
 .\ All rights reserved.
@@ -111,6 +111,7 @@
 argument has been freed by
 .Xr tzfree 3 .
 .Sh SEE ALSO
+.Xr asctime 3 ,
 .Xr timeval 3
 .Sh STANDARDS
 The

CVS commit: src/share/man/man3

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Tue Apr 12 04:27:02 UTC 2011

Modified Files:
src/share/man/man3: unistd.3

Log Message:
Small rewording.


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/unistd.3

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/man3/unistd.3
diff -u src/share/man/man3/unistd.3:1.2 src/share/man/man3/unistd.3:1.3
--- src/share/man/man3/unistd.3:1.2	Sun Apr 10 10:01:06 2011
+++ src/share/man/man3/unistd.3	Tue Apr 12 04:27:02 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: unistd.3,v 1.2 2011/04/10 10:01:06 wiz Exp $
+.\ $NetBSD: unistd.3,v 1.3 2011/04/12 04:27:02 jruoho Exp $
 .\
 .\ Copyright (c) 2011 Jukka Ruohonen jruoho...@iki.fi
 .\ All rights reserved.
@@ -24,7 +24,7 @@
 .\ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\ POSSIBILITY OF SUCH DAMAGE.
 .\
-.Dd April 10, 2011
+.Dd April 12, 2011
 .Dt UNISTD 3
 .Os
 .Sh NAME
@@ -58,12 +58,13 @@
 and
 .Xr sysconf 3 .
 .It
-Prototypes for several important system calls such as
-.Xr alarm 3 ,
+Prototypes for several important system calls and library routines such as
+.Xr chown 2 ,
+.Xr dup 2 ,
 .Xr execl 3 ,
 .Xr fork 2 ,
-.Xr link 2 ,
 .Xr pipe 2 ,
+.Xr rmdir 2 ,
 .Xr setuid 2 ,
 and
 .Xr write 2 .

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Sun Apr 10 10:01:07 UTC 2011

Modified Files:
src/share/man/man3: unistd.3

Log Message:
Fix some xrefs.


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/share/man/man3/unistd.3

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/man3/unistd.3
diff -u src/share/man/man3/unistd.3:1.1 src/share/man/man3/unistd.3:1.2
--- src/share/man/man3/unistd.3:1.1	Sun Apr 10 09:58:01 2011
+++ src/share/man/man3/unistd.3	Sun Apr 10 10:01:06 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: unistd.3,v 1.1 2011/04/10 09:58:01 jruoho Exp $
+.\ $NetBSD: unistd.3,v 1.2 2011/04/10 10:01:06 wiz Exp $
 .\
 .\ Copyright (c) 2011 Jukka Ruohonen jruoho...@iki.fi
 .\ All rights reserved.
@@ -56,11 +56,11 @@
 Various limits and other symbolic constants described in
 .Xr pathconf 2
 and
-.Xr sysconf 2 .
+.Xr sysconf 3 .
 .It
 Prototypes for several important system calls such as
-.Xr alarm 2 ,
-.Xr execl 2 ,
+.Xr alarm 3 ,
+.Xr execl 3 ,
 .Xr fork 2 ,
 .Xr link 2 ,
 .Xr pipe 2 ,

CVS commit: src/share/man/man3

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Sun Apr 10 10:02:34 UTC 2011

Modified Files:
src/share/man/man3: param.3 stddef.3 stdint.3 stdlib.3 types.3

Log Message:
Xref unistd(3).


To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/share/man/man3/param.3
cvs rdiff -u -r1.7 -r1.8 src/share/man/man3/stddef.3
cvs rdiff -u -r1.4 -r1.5 src/share/man/man3/stdint.3
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/stdlib.3
cvs rdiff -u -r1.5 -r1.6 src/share/man/man3/types.3

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/man3/param.3
diff -u src/share/man/man3/param.3:1.3 src/share/man/man3/param.3:1.4
--- src/share/man/man3/param.3:1.3	Fri Apr  8 08:40:05 2011
+++ src/share/man/man3/param.3	Sun Apr 10 10:02:34 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: param.3,v 1.3 2011/04/08 08:40:05 jruoho Exp $
+.\ $NetBSD: param.3,v 1.4 2011/04/10 10:02:34 jruoho Exp $
 .\
 .\ Copyright (c) 2011 Jukka Ruohonen jruoho...@iki.fi
 .\ All rights reserved.
@@ -24,7 +24,7 @@
 .\ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\ POSSIBILITY OF SUCH DAMAGE.
 .\
-.Dd April 8, 2011
+.Dd April 10, 2011
 .Dt PARAM 3
 .Os
 .Sh NAME
@@ -92,7 +92,8 @@
 .Sh SEE ALSO
 .Xr bitops 3 ,
 .Xr cdefs 3 ,
-.Xr types 3
+.Xr types 3 ,
+.Xr unistd 3
 .Sh HISTORY
 A
 .In param.h

Index: src/share/man/man3/stddef.3
diff -u src/share/man/man3/stddef.3:1.7 src/share/man/man3/stddef.3:1.8
--- src/share/man/man3/stddef.3:1.7	Fri May 14 02:45:39 2010
+++ src/share/man/man3/stddef.3	Sun Apr 10 10:02:34 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: stddef.3,v 1.7 2010/05/14 02:45:39 joerg Exp $
+.\ $NetBSD: stddef.3,v 1.8 2011/04/10 10:02:34 jruoho 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 21, 2010
+.Dd April 10, 2011
 .Dt STDDEF 3
 .Os
 .Sh NAME
@@ -67,7 +67,8 @@
 Some of the described types and macros may appear also in other headers.
 .Sh SEE ALSO
 .Xr offsetof 3 ,
-.Xr stdlib 3
+.Xr stdlib 3 ,
+.Xr unistd 3
 .Sh STANDARDS
 As described here, the
 .In stddef.h

Index: src/share/man/man3/stdint.3
diff -u src/share/man/man3/stdint.3:1.4 src/share/man/man3/stdint.3:1.5
--- src/share/man/man3/stdint.3:1.4	Sun Mar 21 19:42:51 2010
+++ src/share/man/man3/stdint.3	Sun Apr 10 10:02:34 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: stdint.3,v 1.4 2010/03/21 19:42:51 jruoho Exp $
+.\ $NetBSD: stdint.3,v 1.5 2011/04/10 10:02:34 jruoho Exp $
 .\
 .\ Copyright (c) 2002 Mike Barcroft m...@freebsd.org
 .\ All rights reserved.
@@ -26,7 +26,7 @@
 .\
 .\ $FreeBSD: src/share/man/man7/stdint.7,v 1.5 2003/09/08 19:57:21 ru Exp $
 .\
-.Dd March 20, 2010
+.Dd April 10, 2011
 .Dt STDINT 3
 .Os
 .Sh NAME
@@ -122,7 +122,8 @@
 .Vt void .
 .Sh SEE ALSO
 .Xr inttypes 3 ,
-.Xr stdbool 3
+.Xr stdbool 3 ,
+.Xr unistd 3
 .Sh STANDARDS
 The
 .In stdint.h

Index: src/share/man/man3/stdlib.3
diff -u src/share/man/man3/stdlib.3:1.2 src/share/man/man3/stdlib.3:1.3
--- src/share/man/man3/stdlib.3:1.2	Fri May 14 02:45:39 2010
+++ src/share/man/man3/stdlib.3	Sun Apr 10 10:02:34 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: stdlib.3,v 1.2 2010/05/14 02:45:39 joerg Exp $
+.\ $NetBSD: stdlib.3,v 1.3 2011/04/10 10:02:34 jruoho 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 25, 2010
+.Dd April 10, 2011
 .Dt STDLIB 3
 .Os
 .Sh NAME
@@ -93,7 +93,9 @@
 and
 .Xr strtol 3 .
 .Sh SEE ALSO
-.Xr stddef 3
+.Xr stddef 3 ,
+.Xr types 3 ,
+.Xr unistd 3
 .Sh STANDARDS
 As described here, the
 .In stdlib.h

Index: src/share/man/man3/types.3
diff -u src/share/man/man3/types.3:1.5 src/share/man/man3/types.3:1.6
--- src/share/man/man3/types.3:1.5	Fri Apr  8 07:55:04 2011
+++ src/share/man/man3/types.3	Sun Apr 10 10:02:34 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: types.3,v 1.5 2011/04/08 07:55:04 jruoho Exp $
+.\	$NetBSD: types.3,v 1.6 2011/04/10 10:02:34 jruoho Exp $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -56,7 +56,7 @@
 .\
 .\ @(#)types.5	8.1 (Berkeley) 6/5/93
 .\
-.Dd April 8, 2011
+.Dd April 10, 2011
 .Dt TYPES 3
 .Os
 .Sh NAME
@@ -207,7 +207,8 @@
 .Xr stdbool 3 ,
 .Xr stddef 3 ,
 .Xr stdint 3 ,
-.Xr stdlib 3
+.Xr stdlib 3 ,
+.Xr unistd 3
 .Sh STANDARDS
 The
 .In sys/types.h

CVS commit: src/share/man/man3

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Fri Apr  8 07:57:48 UTC 2011

Modified Files:
src/share/man/man3: param.3

Log Message:
Remove leftover .Ed.


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/share/man/man3/param.3

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/man3/param.3
diff -u src/share/man/man3/param.3:1.1 src/share/man/man3/param.3:1.2
--- src/share/man/man3/param.3:1.1	Fri Apr  8 07:47:42 2011
+++ src/share/man/man3/param.3	Fri Apr  8 07:57:48 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: param.3,v 1.1 2011/04/08 07:47:42 jruoho Exp $
+.\ $NetBSD: param.3,v 1.2 2011/04/08 07:57:48 jruoho Exp $
 .\
 .\ Copyright (c) 2011 Jukka Ruohonen jruoho...@iki.fi
 .\ All rights reserved.
@@ -88,7 +88,6 @@
 Examples range from definitions such as
 .Dq #define BSD
 to old priority levels used in the kernel.
-.Ed
 .El
 .Sh SEE ALSO
 .Xr cdefs 3 ,

CVS commit: src/share/man/man3

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Fri Apr  8 08:12:52 UTC 2011

Modified Files:
src/share/man/man3: paths.3

Log Message:
Use bullets in the list.


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/paths.3

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/man3/paths.3
diff -u src/share/man/man3/paths.3:1.2 src/share/man/man3/paths.3:1.3
--- src/share/man/man3/paths.3:1.2	Fri Apr  1 13:54:00 2011
+++ src/share/man/man3/paths.3	Fri Apr  8 08:12:51 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: paths.3,v 1.2 2011/04/01 13:54:00 njoly Exp $
+.\ $NetBSD: paths.3,v 1.3 2011/04/08 08:12:51 jruoho Exp $
 .\
 .\ Copyright (c) 2011 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 30, 2011
+.Dd April 8, 2011
 .Dt PATHS 3
 .Os
 .Sh NAME
@@ -43,7 +43,7 @@
 All defined constants are prefixed with
 .Dv _PATH .
 The constants include:
-.Bl -enum -offset indent
+.Bl -bullet -offset indent
 .It
 The default user search path set by
 .Xr login 1

CVS commit: src/share/man/man3

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Fri Apr  8 08:40:05 UTC 2011

Modified Files:
src/share/man/man3: bits.3 fast_divide32.3 ffs32.3 ilog2.3 param.3

Log Message:
Xref bitops(3).


To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/share/man/man3/bits.3
cvs rdiff -u -r1.6 -r1.7 src/share/man/man3/fast_divide32.3
cvs rdiff -u -r1.4 -r1.5 src/share/man/man3/ffs32.3
cvs rdiff -u -r1.3 -r1.4 src/share/man/man3/ilog2.3
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/param.3

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/man3/bits.3
diff -u src/share/man/man3/bits.3:1.10 src/share/man/man3/bits.3:1.11
--- src/share/man/man3/bits.3:1.10	Thu Dec 16 10:40:04 2010
+++ src/share/man/man3/bits.3	Fri Apr  8 08:40:05 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: bits.3,v 1.10 2010/12/16 10:40:04 jruoho Exp $
+.\	$NetBSD: bits.3,v 1.11 2011/04/08 08:40:05 jruoho Exp $
 .\
 .\ Copyright (c) 2006, 2010 David Young.  All rights reserved.
 .\
@@ -25,7 +25,7 @@
 .\ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\ POSSIBILITY OF SUCH DAMAGE.
 .\
-.Dd December 16, 2010
+.Dd April 8, 2011
 .Dt BITS 3
 .Os
 .Sh NAME
@@ -123,6 +123,7 @@
 val = __SHIFTOUT(0xf, mask);		/* 0011 */
 .Ed
 .Sh SEE ALSO
+.Xr bitops 3 ,
 .Xr cdefs 3
 .Sh HISTORY
 The

Index: src/share/man/man3/fast_divide32.3
diff -u src/share/man/man3/fast_divide32.3:1.6 src/share/man/man3/fast_divide32.3:1.7
--- src/share/man/man3/fast_divide32.3:1.6	Thu Apr 15 03:36:18 2010
+++ src/share/man/man3/fast_divide32.3	Fri Apr  8 08:40:05 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: fast_divide32.3,v 1.6 2010/04/15 03:36:18 jruoho Exp $
+.\	$NetBSD: fast_divide32.3,v 1.7 2011/04/08 08:40:05 jruoho 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 April 14, 2010
+.Dd April 8, 2011
 .Dt FAST_DIVIDE32 3
 .Os
 .Sh NAME
@@ -92,6 +92,7 @@
 r = fast_remainder32(a, b, m, s1, s2);
 .Ed
 .Sh SEE ALSO
+.Xr bitops 3
 .Rs
 .%A Torbj\(:orn Granlund
 .%A Peter L. Montgomery

Index: src/share/man/man3/ffs32.3
diff -u src/share/man/man3/ffs32.3:1.4 src/share/man/man3/ffs32.3:1.5
--- src/share/man/man3/ffs32.3:1.4	Fri May 14 02:45:39 2010
+++ src/share/man/man3/ffs32.3	Fri Apr  8 08:40:05 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: ffs32.3,v 1.4 2010/05/14 02:45:39 joerg Exp $
+.\	$NetBSD: ffs32.3,v 1.5 2011/04/08 08:40:05 jruoho 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 April 28, 2010
+.Dd April 8, 2011
 .Dt FFS32 3
 .Os
 .Sh NAME
@@ -94,6 +94,7 @@
 .Ed
 .Sh SEE ALSO
 .Xr bits 3 ,
+.Xr bitops 3 ,
 .Xr bitstring 3 ,
 .Xr ffs 3 ,
 .Xr setbit 9

Index: src/share/man/man3/ilog2.3
diff -u src/share/man/man3/ilog2.3:1.3 src/share/man/man3/ilog2.3:1.4
--- src/share/man/man3/ilog2.3:1.3	Sun Jun 20 21:57:59 2010
+++ src/share/man/man3/ilog2.3	Fri Apr  8 08:40:05 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: ilog2.3,v 1.3 2010/06/20 21:57:59 joerg Exp $ $
+.\ $NetBSD: ilog2.3,v 1.4 2011/04/08 08:40:05 jruoho 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 June 8, 2010
+.Dd April 8, 2011
 .Dt ILOG2 3
 .Os
 .Sh NAME
@@ -54,6 +54,7 @@
 .Sh ERRORS
 A value \-1 is returned on error.
 .Sh SEE ALSO
+.Xr bitops 3 ,
 .Xr log2 3 ,
 .Xr imax 9 ,
 .Xr powerof2 9

Index: src/share/man/man3/param.3
diff -u src/share/man/man3/param.3:1.2 src/share/man/man3/param.3:1.3
--- src/share/man/man3/param.3:1.2	Fri Apr  8 07:57:48 2011
+++ src/share/man/man3/param.3	Fri Apr  8 08:40:05 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: param.3,v 1.2 2011/04/08 07:57:48 jruoho Exp $
+.\ $NetBSD: param.3,v 1.3 2011/04/08 08:40:05 jruoho Exp $
 .\
 .\ Copyright (c) 2011 Jukka Ruohonen jruoho...@iki.fi
 .\ All rights reserved.
@@ -90,6 +90,7 @@
 to old priority levels used in the kernel.
 .El
 .Sh SEE ALSO
+.Xr bitops 3 ,
 .Xr cdefs 3 ,
 .Xr types 3
 .Sh HISTORY

CVS commit: src/share/man/man3

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Fri Apr  8 08:42:56 UTC 2011

Modified Files:
src/share/man/man3: bitops.3

Log Message:
Clarify a little; ilog2(3) is a macro.


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/share/man/man3/bitops.3

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/man3/bitops.3
diff -u src/share/man/man3/bitops.3:1.1 src/share/man/man3/bitops.3:1.2
--- src/share/man/man3/bitops.3:1.1	Fri Apr  8 08:36:34 2011
+++ src/share/man/man3/bitops.3	Fri Apr  8 08:42:56 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: bitops.3,v 1.1 2011/04/08 08:36:34 jruoho Exp $
+.\ $NetBSD: bitops.3,v 1.2 2011/04/08 08:42:56 jruoho Exp $
 .\
 .\ Copyright (c) 2011 Jukka Ruohonen jruoho...@iki.fi
 .\ All rights reserved.
@@ -46,12 +46,13 @@
 and
 .Vt uint64_t
 .It Xr ilog2 3
-a function for binary logarithm
+a macro for binary logarithm
 .It Xr fast_divide32 3
 a function for fast 32-bit division
 .El
 .Sh SEE ALSO
 .Xr bits 3 ,
+.Xr bitstring 3 ,
 .Xr cdefs 3 ,
 .Xr param 3
 .Sh HISTORY

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Apr  8 08:47:13 UTC 2011

Modified Files:
src/share/man/man3: end.3

Log Message:
New sentence, new line.


To generate a diff of this commit:
cvs rdiff -u -r1.8 -r1.9 src/share/man/man3/end.3

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/man3/end.3
diff -u src/share/man/man3/end.3:1.8 src/share/man/man3/end.3:1.9
--- src/share/man/man3/end.3:1.8	Thu Sep  1 12:39:33 2005
+++ src/share/man/man3/end.3	Fri Apr  8 08:47:12 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: end.3,v 1.8 2005/09/01 12:39:33 kleink Exp $
+.\	$NetBSD: end.3,v 1.9 2011/04/08 08:47:12 wiz Exp $
 .\
 .\ Copyright (c) 1986
 .\	The Regents of the University of California.  All rights reserved.
@@ -57,7 +57,8 @@
 .Va end
 is located at the first address after the end of the data segment
 .Pq Tn BSS
-when the program is loaded.  Use the
+when the program is loaded.
+Use the
 .Xr sbrk 2
 .\.Fn sbrk 0
 system call with zero as its argument to find the current end of the
@@ -74,6 +75,7 @@
 .Sh BUGS
 Traditionally, no variable existed that pointed to the start of the
 text segment because the text segment always started at address
-zero. Although it is no longer valid to make this assumption, no
+zero.
+Although it is no longer valid to make this assumption, no
 variable similar to the ones documented above exists to point to the
 start of the text segment.

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Apr  8 08:47:34 UTC 2011

Modified Files:
src/share/man/man3: sysexits.3

Log Message:
Do not Xr yourself.


To generate a diff of this commit:
cvs rdiff -u -r1.4 -r1.5 src/share/man/man3/sysexits.3

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/man3/sysexits.3
diff -u src/share/man/man3/sysexits.3:1.4 src/share/man/man3/sysexits.3:1.5
--- src/share/man/man3/sysexits.3:1.4	Thu Mar 25 06:56:20 2010
+++ src/share/man/man3/sysexits.3	Fri Apr  8 08:47:34 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: sysexits.3,v 1.4 2010/03/25 06:56:20 jruoho Exp $
+.\	$NetBSD: sysexits.3,v 1.5 2011/04/08 08:47:34 wiz Exp $
 .\
 .\ Copyright (c) 1996 Joerg Wunsch
 .\
@@ -142,7 +142,7 @@
 file appeared somewhere after
 .Bx 4.3 .
 The
-.Xr sysexits 3
+.Nm
 manual page appeared in
 .Nx 4.0 .
 .Sh AUTHORS

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Apr  8 08:47:50 UTC 2011

Modified Files:
src/share/man/man3: ffs32.3

Log Message:
Sort SEE ALSO.


To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/share/man/man3/ffs32.3

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/man3/ffs32.3
diff -u src/share/man/man3/ffs32.3:1.5 src/share/man/man3/ffs32.3:1.6
--- src/share/man/man3/ffs32.3:1.5	Fri Apr  8 08:40:05 2011
+++ src/share/man/man3/ffs32.3	Fri Apr  8 08:47:50 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: ffs32.3,v 1.5 2011/04/08 08:40:05 jruoho Exp $
+.\	$NetBSD: ffs32.3,v 1.6 2011/04/08 08:47:50 wiz Exp $
 .\
 .\ Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\ All rights reserved.
@@ -93,8 +93,8 @@
 l = fls32(n);
 .Ed
 .Sh SEE ALSO
-.Xr bits 3 ,
 .Xr bitops 3 ,
+.Xr bits 3 ,
 .Xr bitstring 3 ,
 .Xr ffs 3 ,
 .Xr setbit 9

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Apr  8 08:47:54 UTC 2011

Modified Files:
src/share/man/man3: stdarg.3 varargs.3

Log Message:
Sort sections.


To generate a diff of this commit:
cvs rdiff -u -r1.19 -r1.20 src/share/man/man3/stdarg.3
cvs rdiff -u -r1.7 -r1.8 src/share/man/man3/varargs.3

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/man3/stdarg.3
diff -u src/share/man/man3/stdarg.3:1.19 src/share/man/man3/stdarg.3:1.20
--- src/share/man/man3/stdarg.3:1.19	Mon Mar 22 18:36:27 2010
+++ src/share/man/man3/stdarg.3	Fri Apr  8 08:47:54 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: stdarg.3,v 1.19 2010/03/22 18:36:27 joerg Exp $
+.\	$NetBSD: stdarg.3,v 1.20 2011/04/08 08:47:54 wiz Exp $
 .\
 .\ Copyright (c) 1990, 1991, 1993
 .\	The Regents of the University of California.  All rights reserved.
@@ -219,6 +219,13 @@
 	va_end(ap);
 }
 .Ed
+.Sh COMPATIBILITY
+These macros are
+.Em not
+compatible with the historic macros they replace.
+A backward compatible version can be found in the include
+file
+.In varargs.h .
 .Sh STANDARDS
 The
 .Fn va_start ,
@@ -240,13 +247,6 @@
 .Fn va_copy
 macro was introduced in
 .St -isoC-99 .
-.Sh COMPATIBILITY
-These macros are
-.Em not
-compatible with the historic macros they replace.
-A backward compatible version can be found in the include
-file
-.In varargs.h .
 .Sh BUGS
 Unlike the
 .Em varargs

Index: src/share/man/man3/varargs.3
diff -u src/share/man/man3/varargs.3:1.7 src/share/man/man3/varargs.3:1.8
--- src/share/man/man3/varargs.3:1.7	Mon Mar 22 18:36:27 2010
+++ src/share/man/man3/varargs.3	Fri Apr  8 08:47:54 2011
@@ -1,4 +1,4 @@
-.\	$NetBSD: varargs.3,v 1.7 2010/03/22 18:36:27 joerg Exp $
+.\	$NetBSD: varargs.3,v 1.8 2011/04/08 08:47:54 wiz Exp $
 .\
 .\ Copyright (c) 1990, 1991, 1993
 .\	The Regents of the University of California.  All rights reserved.
@@ -184,6 +184,13 @@
 	va_end(ap);
 }
 .Ed
+.Sh COMPATIBILITY
+These macros are
+.Em not
+compatible with the new macros they were replaced by.
+In particular, it is not possible for a
+.Em stdarg
+function to have no fixed arguments.
 .Sh SEE ALSO
 .Xr stdarg 3
 .Sh STANDARDS
@@ -194,10 +201,3 @@
 see
 .Xr stdarg 3
 for its description.
-.Sh COMPATIBILITY
-These macros are
-.Em not
-compatible with the new macros they were replaced by.
-In particular, it is not possible for a
-.Em stdarg
-function to have no fixed arguments.

CVS commit: src/share/man/man3

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Apr  8 08:50:52 UTC 2011

Modified Files:
src/share/man/man3: dirent.3

Log Message:
Remove superfluous Pp.


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

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/man3/dirent.3
diff -u src/share/man/man3/dirent.3:1.3 src/share/man/man3/dirent.3:1.4
--- src/share/man/man3/dirent.3:1.3	Thu Oct 14 20:14:50 2010
+++ src/share/man/man3/dirent.3	Fri Apr  8 08:50:52 2011
@@ -1,4 +1,4 @@
-.\ $NetBSD: dirent.3,v 1.3 2010/10/14 20:14:50 skrll Exp $
+.\ $NetBSD: dirent.3,v 1.4 2011/04/08 08:50:52 wiz Exp $
 .\
 .\ Copyright (c) 1983, 1991, 1993
 .\	The Regents of the University of California.  All rights reserved.
@@ -192,7 +192,6 @@
 instead of applying the
 .Fn sizeof
 operator.
-.Pp
 .Sh SEE ALSO
 .Xr getdents 2 ,
 .Xr fs 5 ,