From ba04fd904a412353c7a73751c522c1e79954f4e4 Mon Sep 17 00:00:00 2001
From: Karl Williamson <khw@cpan.org>
Date: Wed, 22 Jun 2022 06:45:58 -0600
Subject: handy.h: Comment MUTABLE_PTR

Tony Cook and Leon Timmermans explained this to me.
---
 handy.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

(limited to 'handy.h')

diff --git a/handy.h b/handy.h
index d1fcf5d608..54ecc24883 100644
--- a/handy.h
+++ b/handy.h
@@ -91,8 +91,10 @@ C<MUTABLE_PTR> is the base macro used to derive new casts.  The other
 already-built-in ones return pointers to what their names indicate.
 
 =cut
- */
 
+The brace group version will raise a diagnostic if 'p' is const; the other
+blindly casts away const.
+ */
 #if defined(PERL_USE_GCC_BRACE_GROUPS)
 #  define MUTABLE_PTR(p) ({ void *p_ = (p); p_; })
 #else
-- 
cgit v1.2.1