From 0b9a8924695870c15bc39feb6ec96d525954eaba Mon Sep 17 00:00:00 2001
From: Brian Norris <banorris@uci.edu>
Date: Thu, 11 Oct 2012 10:28:22 -0700
Subject: [PATCH 1/1] include/: add small header comments

---
 include/atomic        | 5 +++++
 include/cstdatomic    | 4 ++++
 include/impatomic.h   | 8 ++++++++
 include/memoryorder.h | 5 +++++
 include/stdatomic.h   | 7 ++++++-
 5 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/include/atomic b/include/atomic
index 52198375..5984e722 100644
--- a/include/atomic
+++ b/include/atomic
@@ -1,3 +1,8 @@
+/**
+ * @file atomic
+ * @brief C++11 atomic interface header
+ */
+
 #ifndef __CXX_ATOMIC__
 #define __CXX_ATOMIC__
 
diff --git a/include/cstdatomic b/include/cstdatomic
index 8bbd9884..b4410971 100644
--- a/include/cstdatomic
+++ b/include/cstdatomic
@@ -1,3 +1,7 @@
+/**
+ * @file cstdatomic
+ * @brief C11 atomic interface header
+ */
 
 #include "impatomic.h"
 
diff --git a/include/impatomic.h b/include/impatomic.h
index ae0796f0..889a960b 100644
--- a/include/impatomic.h
+++ b/include/impatomic.h
@@ -1,3 +1,11 @@
+/**
+ * @file impatomic.h
+ * @brief Common header for C11/C++11 atomics
+ *
+ * Note that some features are unavailable, as they require support from a true
+ * C11/C++11 compiler.
+ */
+
 #ifndef __IMPATOMIC_H__
 #define __IMPATOMIC_H__
 
diff --git a/include/memoryorder.h b/include/memoryorder.h
index 93e87a03..8c4c2a04 100644
--- a/include/memoryorder.h
+++ b/include/memoryorder.h
@@ -1,3 +1,8 @@
+/**
+ * @file memoryorder.h
+ * @brief C11/C++11 atomic memory order listings
+ */
+
 #ifndef MEMORYORDER_H
 #define MEMORYORDER_H
 #ifdef __cplusplus
diff --git a/include/stdatomic.h b/include/stdatomic.h
index 035f848d..7b3ff800 100644
--- a/include/stdatomic.h
+++ b/include/stdatomic.h
@@ -1,3 +1,8 @@
+/**
+ * @file stdatomic.h
+ * @brief C11 atomic interface header
+ */
+
 #ifndef __STDATOMIC_H__
 #define __STDATOMIC_H__
 
@@ -59,6 +64,6 @@ using std::memory_order_release;
 using std::memory_order_acq_rel;
 using std::memory_order_seq_cst;
 
-#endif
+#endif /* __cplusplus */
 
 #endif /* __STDATOMIC_H__ */
-- 
2.34.1