git: a5a186baf2c8 - main - queue.3: document STAILQ_REVERSE

The branch main has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=a5a186baf2c89ebfd795d74d9223d57acd8c0383

commit a5a186baf2c89ebfd795d74d9223d57acd8c0383
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2025-05-04 16:04:09 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2025-05-06 17:14:56 +0000

    queue.3: document STAILQ_REVERSE
    
    Reviewed by:    markj, olce
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
    Differential revision:  https://reviews.freebsd.org/D50131
---
 share/man/man3/Makefile | 1 +
 share/man/man3/queue.3  | 6 ++++++
 2 files changed, 7 insertions(+)

diff --git a/share/man/man3/Makefile b/share/man/man3/Makefile
index c610283173a2..7322954b45ca 100644
--- a/share/man/man3/Makefile
+++ b/share/man/man3/Makefile
@@ -258,6 +258,7 @@ MLINKS+=	queue.3 LIST_CLASS_ENTRY.3 \
 		queue.3 STAILQ_REMOVE.3 \
 		queue.3 STAILQ_REMOVE_AFTER.3 \
 		queue.3 STAILQ_REMOVE_HEAD.3 \
+		queue.3 STAILQ_REVERSE.3 \
 		queue.3 STAILQ_SWAP.3 \
 		queue.3 TAILQ_CLASS_ENTRY.3 \
 		queue.3 TAILQ_CLASS_HEAD.3 \
diff --git a/share/man/man3/queue.3 b/share/man/man3/queue.3
index 8d4492b8be69..79c8d92decbe 100644
--- a/share/man/man3/queue.3
+++ b/share/man/man3/queue.3
@@ -73,6 +73,7 @@
 .Nm STAILQ_REMOVE ,
 .Nm STAILQ_REMOVE_AFTER ,
 .Nm STAILQ_REMOVE_HEAD ,
+.Nm STAILQ_REVERSE ,
 .Nm STAILQ_SPLIT_AFTER ,
 .Nm STAILQ_SWAP ,
 .Nm LIST_CLASS_ENTRY ,
@@ -177,6 +178,7 @@ lists and tail queues
 .Fn STAILQ_REMOVE "STAILQ_HEAD *head" "TYPE *elm" "TYPE" "STAILQ_ENTRY NAME"
 .Fn STAILQ_REMOVE_AFTER "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
 .Fn STAILQ_REMOVE_HEAD "STAILQ_HEAD *head" "STAILQ_ENTRY NAME"
+.Fn STAILQ_REVERSE "STAILQ_HEAD *head" "TYPE" "STAILQ_ENTRY NAME"
 .Fn STAILQ_SPLIT_AFTER "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_HEAD *rest" "STAILQ_ENTRY NAME"
 .Fn STAILQ_SWAP "STAILQ_HEAD *head1" "STAILQ_HEAD *head2" "TYPE"
 .\"
@@ -791,6 +793,10 @@ A doubly-linked tail queue should be used if this macro is needed in
 high-usage code paths or to operate on long tail queues.
 .Pp
 The macro
+.Nm STAILQ_REVERSE
+reverses the queue in place.
+.Pp
+The macro
 .Nm STAILQ_SPLIT_AFTER
 splits the tail queue referenced by
 .Fa head ,