From: Ondřej Surý <ondrej@isc.org>
Date: Sat, 13 Sep 2025 04:05:41 +0000 (+0200)
Subject: Fix up the descriptions in rdataslab.h
X-Git-Tag: v9.21.14~39^2~1
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=fa12ba28cec24f01871e95daaf60bc121f829e95;p=thirdparty%2Fbind9.git

Fix up the descriptions in rdataslab.h

There were a lot of outdated comments. They've been updated or removed.
---

diff --git a/lib/dns/include/dns/rdataslab.h b/lib/dns/include/dns/rdataslab.h
index 76df3b78fe9..59387029277 100644
--- a/lib/dns/include/dns/rdataslab.h
+++ b/lib/dns/include/dns/rdataslab.h
@@ -107,33 +107,26 @@ struct dns_slabheader {
 
 	dns_slabheader_proof_t *noqname;
 	dns_slabheader_proof_t *closest;
-	/*%<
-	 * We don't use the LIST macros, because the LIST structure has
-	 * both head and tail pointers, and is doubly linked.
-	 */
-
-	dns_slabtop_t *top;
 
-	/*%<
-	 * If this is the top header for an rdataset, 'next' points
-	 * to the top header for the next rdataset (i.e., the next type).
-	 *
-	 * Otherwise 'up' points up to the header whose down pointer points at
-	 * this header.
+	/*%
+	 * Points to the top slabtop structure for the type.
 	 */
+	dns_slabtop_t *top;
 
-	struct dns_slabheader *down;
-	/*%<
+	/*%
 	 * Points to the header for the next older version of
 	 * this rdataset.
 	 */
+	struct dns_slabheader *down;
 
-	dns_dbnode_t *node;
-	/*%<
-	 * The database and database node objects containing
-	 * this rdataset, if any.
+	/*%
+	 * The database node objects containing this rdataset, if any.
 	 */
+	dns_dbnode_t *node;
 
+	/*%
+	 * Cached glue records for an rdataset of type NS (zone only).
+	 */
 	dns_gluelist_t *gluelist;
 
 	/*%