[src/netbsd-3]: src/lib/libc/stdlib Pull up revision 1.2 (requested by drochn...

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

details:   https://anonhg.NetBSD.org/src/rev/8c803a73307b
branches:  netbsd-3
changeset: 576834:8c803a73307b
user:      tron <tron%NetBSD.org@localhost>
date:      Thu Aug 04 17:40:46 2005 +0000

description:
Pull up revision 1.2 (requested by drochner in ticket #632):
add some clarification, and refer to POSIX
partly borrowed from FreeBSD

diffstat:

 lib/libc/stdlib/insque.3 |  23 ++++++++++++++++++++---
 1 files changed, 20 insertions(+), 3 deletions(-)

diffs (39 lines):

diff -r 141d60712ce8 -r 8c803a73307b lib/libc/stdlib/insque.3
--- a/lib/libc/stdlib/insque.3  Thu Aug 04 17:36:28 2005 +0000
+++ b/lib/libc/stdlib/insque.3  Thu Aug 04 17:40:46 2005 +0000
@@ -24,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"    $NetBSD: insque.3,v 1.3.2.2 2005/08/04 17:33:23 tron Exp $
+.\"    $NetBSD: insque.3,v 1.3.2.3 2005/08/04 17:40:46 tron Exp $
 .\"
 .Dd July 6, 2005
 .Dt INSQUE 3
@@ -46,7 +46,24 @@
 and
 .Fn remque
 manipulate queues built from doubly linked lists.
-.Sh DIAGNOSTICS
-These functions are not atomic unless that machine architecture allows it.
+The queue can be either circular or linear.
+The functions expect their
+arguments to point to a structure whose first and second members are
+pointers to the next and previous element, respectively.
+The
+.Fn insque
+function also allows the
+.Fa pred
+argument to be a
+.Dv NULL
+pointer for the initialization of a new linear list's
+head element.
+.Sh STANDARDS
+The
+.Fn insque
+and
+.Fn remque
+functions conform to
+.St -p1003.1-2001 .
 .Sh HISTORY
 These are derived from the insque and remque instructions on a VAX.