From 554cdf8f575074bb36eb624d5fe76897d9707b70 Mon Sep 17 00:00:00 2001
From: Andrew Turner <andrew@FreeBSD.org>
Date: Mon, 24 Jul 2023 17:58:13 +0100
Subject: [PATCH] arm: Explain why _atomic_subword.h is needed

Sponsored by:	Arm Ltd
Differential Revision:	https://reviews.freebsd.org/D41134
---
 sys/arm/include/atomic.h | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/sys/arm/include/atomic.h b/sys/arm/include/atomic.h
index f166b0091e9..d60b5dbbf7e 100644
--- a/sys/arm/include/atomic.h
+++ b/sys/arm/include/atomic.h
@@ -93,6 +93,12 @@ atomic_swap_long(volatile u_long *p, u_long v)
 #define atomic_store_rel_int		atomic_store_rel_32
 #define atomic_swap_int			atomic_swap_32
 
+/*
+ * For:
+ *  - atomic_load_acq_8
+ *  - atomic_load_acq_16
+ *  - atomic_testandset_acq_long
+ */
 #include <sys/_atomic_subword.h>
 
 #endif /* _MACHINE_ATOMIC_H_ */