git: f2c6a00a2e46 - stable/13 - tree.3: explain RB_FIND() and RB_NFIND()

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Wed, 10 Aug 2022 00:44:13 UTC
The branch stable/13 has been updated by kib:

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

commit f2c6a00a2e4636a99f4e97c983b8dd1c132eae3e
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2022-08-01 09:43:10 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2022-08-10 00:44:03 +0000

    tree.3: explain RB_FIND() and RB_NFIND()
    
    (cherry picked from commit 08349b18ea26d1e191333f9b3550cd95b09cfe34)
---
 share/man/man3/tree.3 | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/share/man/man3/tree.3 b/share/man/man3/tree.3
index c68c71fff85b..c45ce3d3ceb6 100644
--- a/share/man/man3/tree.3
+++ b/share/man/man3/tree.3
@@ -520,10 +520,25 @@ The
 and
 .Fn RB_NFIND
 macros can be used to find a particular element in the tree.
+.Pp
+The
+.Fn RB_FIND
+macro returns the element in the tree equal to the provided
+key, or
+.Dv NULL
+if there is no such element.
+.Pp
+The
+.Fn RB_NFIND
+macro returns the least element greater than or equal to the provided
+key, or
+.Dv NULL
+if there is no such element.
 .Bd -literal -offset indent
-struct TYPE find, *res;
+struct TYPE find, *res, *resn;
 find.key = 30;
 res = RB_FIND(NAME, head, &find);
+resn = RB_NFIND(NAME, head, &find);
 .Ed
 .Pp
 The