3 files changed, 17 insertions, 2 deletions
diff --git a/src/lib/trace/debug.h b/src/lib/trace/debug.h
index 9b5d9d05c8..a764f552ea 100644
--- a/src/lib/trace/debug.h
+++ b/src/lib/trace/debug.h
@@ -1,6 +1,11 @@
 /* Copyright (c) 2017-2018, The Tor Project, Inc. */
 /* See LICENSE for licensing information */
 
+/**
+ * \file debug.h
+ * \brief Macros for debugging our event-trace support.
+ **/
+
 #ifndef TOR_TRACE_LOG_DEBUG_H
 #define TOR_TRACE_LOG_DEBUG_H
 
diff --git a/src/lib/trace/trace.c b/src/lib/trace/trace.c
index c0bbbb0cc6..535ffde183 100644
--- a/src/lib/trace/trace.c
+++ b/src/lib/trace/trace.c
@@ -1,6 +1,13 @@
 /* Copyright (c) 2017-2018, The Tor Project, Inc. */
 /* See LICENSE for licensing information */
 
+/**
+ * \file trace.c
+ * \brief Common functions for event-tracing implementation
+ *
+ * See trace.h and doc/HACKING/Tracing.md for more information.
+ **/
+
 #include "lib/trace/trace.h"
 
 /** Initialize the tracing library. */
@@ -8,4 +15,3 @@ void
 tor_trace_init(void)
 {
 }
-
diff --git a/src/lib/trace/trace.h b/src/lib/trace/trace.h
index 2dd51aace1..5f7b0ee7cd 100644
--- a/src/lib/trace/trace.h
+++ b/src/lib/trace/trace.h
@@ -1,10 +1,14 @@
 /* Copyright (c) 2017-2018, The Tor Project, Inc. */
 /* See LICENSE for licensing information */
 
+/**
+ * \file trace.h
+ * \brief Header for trace.c
+ **/
+
 #ifndef TOR_TRACE_TRACE_H
 #define TOR_TRACE_TRACE_H
 
 void tor_trace_init(void);
 
 #endif // TOR_TRACE_TRACE_H
-