zone: some documentation improvements

diff --git a/src/knot/zone/zone-tree.h b/src/knot/zone/zone-tree.h
index 7fe8b593ab4209b4d92357d576a4c11a3f732e23..35cd138a6ceb9ab2835a473f97f844146fb92e6e 100644 (file)
--- a/src/knot/zone/zone-tree.h
+++ b/src/knot/zone/zone-tree.h
@@ -20,7 +20,9 @@
 #include "knot/zone/node.h"
 
 enum {
+       /*! Indication of a zone tree with bi-nodes (two zone_node_t structures allocated for one node). */
        ZONE_TREE_USE_BINODES = (1 << 0),
+       /*! If set, from each bi-node in the zone tree, the second zone_node_t is valid. */
        ZONE_TREE_BINO_SECOND = (1 << 1),
 };
 

diff --git a/src/knot/zone/zone.h b/src/knot/zone/zone.h
index 440fe2f1347e8ca16ba5920360b4c10358674eab..9525aefaa8b115c99abda6d183f3938aa46a77c6 100644 (file)
--- a/src/knot/zone/zone.h
+++ b/src/knot/zone/zone.h
@@ -33,11 +33,11 @@ struct zone_update;
  * \brief Zone flags.
  */
 typedef enum zone_flag_t {
-       ZONE_FORCE_AXFR     = 1 << 0, /* Force AXFR as next transfer. */
-       ZONE_FORCE_RESIGN   = 1 << 1, /* Force zone re-sign. */
-       ZONE_FORCE_FLUSH    = 1 << 2, /* Force zone flush. */
-       ZONE_FORCE_KSK_ROLL = 1 << 3, /* Force KSK/CSK rollover. */
-       ZONE_FORCE_ZSK_ROLL = 1 << 4, /* Force ZSK rollover. */
+       ZONE_FORCE_AXFR     = 1 << 0, /*!< Force AXFR as next transfer. */
+       ZONE_FORCE_RESIGN   = 1 << 1, /*!< Force zone re-sign. */
+       ZONE_FORCE_FLUSH    = 1 << 2, /*!< Force zone flush. */
+       ZONE_FORCE_KSK_ROLL = 1 << 3, /*!< Force KSK/CSK rollover. */
+       ZONE_FORCE_ZSK_ROLL = 1 << 4, /*!< Force ZSK rollover. */
 } zone_flag_t;
 
 /*!