Document the recently added {STAILQ,TAILQ}_CONCAT macros.
authorSascha Wildner <swildner@dragonflybsd.org>
Sun, 28 Jan 2007 14:52:02 +0000 (14:52 +0000)
committerSascha Wildner <swildner@dragonflybsd.org>
Sun, 28 Jan 2007 14:52:02 +0000 (14:52 +0000)
share/man/man3/Makefile
share/man/man3/queue.3

index f1efb66..19bd506 100644 (file)
@@ -1,6 +1,6 @@
 #      @(#)Makefile    8.2 (Berkeley) 12/13/93
 # $FreeBSD: src/share/man/man3/Makefile,v 1.15.2.3 2001/04/25 11:11:30 ru Exp $
-# $DragonFly: src/share/man/man3/Makefile,v 1.5 2005/11/20 11:05:44 swildner Exp $
+# $DragonFly: src/share/man/man3/Makefile,v 1.6 2007/01/28 14:52:02 swildner Exp $
 
 MAN=   assert.3 bitstring.3 end.3 fpgetround.3 intro.3 pthread.3 queue.3 \
        stdarg.3 sysexits.3 tree.3
@@ -55,6 +55,7 @@ MLINKS+=queue.3 SLIST_INSERT_HEAD.3
 MLINKS+=queue.3 SLIST_NEXT.3
 MLINKS+=queue.3 SLIST_REMOVE.3
 MLINKS+=queue.3 SLIST_REMOVE_HEAD.3
+MLINKS+=queue.3 STAILQ_CONCAT.3
 MLINKS+=queue.3 STAILQ_EMPTY.3
 MLINKS+=queue.3 STAILQ_ENTRY.3
 MLINKS+=queue.3 STAILQ_FIRST.3
@@ -69,6 +70,7 @@ MLINKS+=queue.3 STAILQ_LAST.3
 MLINKS+=queue.3 STAILQ_NEXT.3
 MLINKS+=queue.3 STAILQ_REMOVE.3
 MLINKS+=queue.3 STAILQ_REMOVE_HEAD.3
+MLINKS+=queue.3 TAILQ_CONCAT.3
 MLINKS+=queue.3 TAILQ_EMPTY.3
 MLINKS+=queue.3 TAILQ_ENTRY.3
 MLINKS+=queue.3 TAILQ_FIRST.3
index 3e46574..1ed3c10 100644 (file)
@@ -31,9 +31,9 @@
 .\"
 .\"    @(#)queue.3     8.2 (Berkeley) 1/24/94
 .\" $FreeBSD: src/share/man/man3/queue.3,v 1.15.2.7 2001/12/18 10:09:02 ru Exp $
-.\" $DragonFly: src/share/man/man3/queue.3,v 1.4 2005/08/05 21:49:22 swildner Exp $
+.\" $DragonFly: src/share/man/man3/queue.3,v 1.5 2007/01/28 14:52:02 swildner Exp $
 .\"
-.Dd January 24, 1994
+.Dd January 8, 2007
 .Dt QUEUE 3
 .Os
 .Sh NAME
@@ -49,6 +49,7 @@
 .Nm SLIST_NEXT ,
 .Nm SLIST_REMOVE_HEAD ,
 .Nm SLIST_REMOVE ,
+.Nm STAILQ_CONCAT ,
 .Nm STAILQ_EMPTY ,
 .Nm STAILQ_ENTRY ,
 .Nm STAILQ_FIRST ,
@@ -76,6 +77,7 @@
 .Nm LIST_INSERT_HEAD ,
 .Nm LIST_NEXT ,
 .Nm LIST_REMOVE ,
+.Nm TAILQ_CONCAT ,
 .Nm TAILQ_EMPTY ,
 .Nm TAILQ_ENTRY ,
 .Nm TAILQ_FIRST ,
@@ -127,6 +129,7 @@ lists, tail queues, and circular queues
 .Fn SLIST_REMOVE_HEAD "SLIST_HEAD *head" "SLIST_ENTRY NAME"
 .Fn SLIST_REMOVE "SLIST_HEAD *head" "TYPE *elm" "TYPE" "SLIST_ENTRY NAME"
 .\"
+.Fn STAILQ_CONCAT "STAILQ_HEAD *head1" "STAILQ_HEAD *head2"
 .Fn STAILQ_EMPTY "STAILQ_HEAD *head"
 .Fn STAILQ_ENTRY "TYPE"
 .Fn STAILQ_FIRST "STAILQ_HEAD *head"
@@ -156,6 +159,7 @@ lists, tail queues, and circular queues
 .Fn LIST_NEXT "TYPE *elm" "LIST_ENTRY NAME"
 .Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME"
 .\"
+.Fn TAILQ_CONCAT "TAILQ_HEAD *head1" "TAILQ_HEAD *head2" "TAILQ_ENTRY NAME"
 .Fn TAILQ_EMPTY "TAILQ_HEAD *head"
 .Fn TAILQ_ENTRY "TYPE"
 .Fn TAILQ_FIRST "TAILQ_HEAD *head"
@@ -489,6 +493,14 @@ evaluates to an initializer for the tail queue
 .Fa head .
 .Pp
 The macro
+.Nm STAILQ_CONCAT
+concatenates the tail queue headed by
+.Fa head2
+onto the end of the one headed by
+.Fa head1
+removing all entries from the former.
+.Pp
+The macro
 .Nm STAILQ_EMPTY
 evaluates to true if there are no items on the tail queue.
 .Pp
@@ -791,6 +803,14 @@ evaluates to an initializer for the tail queue
 .Fa head .
 .Pp
 The macro
+.Nm TAILQ_CONCAT
+concatenates the tail queue headed by
+.Fa head2
+onto the end of the one headed by
+.Fa head1
+removing all entries from the former.
+.Pp
+The macro
 .Nm TAILQ_EMPTY
 evaluates to true if there are no items on the tail queue.
 .Pp