From b3c28677159c26070f26909b3f4c2e00e50d7bff Mon Sep 17 00:00:00 2001
From: Nick Mathewson <nickm@torproject.org>
Date: Wed, 4 Sep 2019 14:03:38 -0400
Subject: [PATCH] Document fields of struct_magic_decl_t.

---
 src/lib/conf/conftypes.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/lib/conf/conftypes.h b/src/lib/conf/conftypes.h
index fabad97d0c..3db115204b 100644
--- a/src/lib/conf/conftypes.h
+++ b/src/lib/conf/conftypes.h
@@ -100,8 +100,12 @@ typedef struct struct_member_t {
  * that they have the correct type.
  */
 typedef struct struct_magic_decl_t {
+  /** The name of the structure */
   const char *typename;
+  /** A value used to recognize instances of this structure. */
   uint32_t magic_val;
+  /** The location within the structure at which we expect to find
+   * <b>magic_val</b>. */
   int magic_offset;
 } struct_magic_decl_t;