File tree 1 file changed +10
-0
lines changed
1 file changed +10
-0
lines changed Original file line number Diff line number Diff line change @@ -184,3 +184,13 @@ headers (which is sometimes required for ``constexpr`` support).
184
184
185
185
When defining a function at the ABI boundary, it can also be useful to consider which attributes (like ``[[gnu::pure]] ``
186
186
and ``[[clang::noescape]] ``) can be added to the function to improve the compiler's ability to optimize.
187
+
188
+ library-internal type aliases should be annotated with ``_LIBCPP_NODEBUG ``
189
+ ==========================================================================
190
+
191
+ Libc++ has lots of internal type aliases. Accumulated, these can result in significant amounts of debug information that
192
+ users don't care about usually, since users don't try to debug standard library facilities in most cases. For that
193
+ reason, all library-internal type aliases should be annotated with ``_LIBCPP_NODEBUG `` to suppress compilers from
194
+ generating said debug information.
195
+
196
+ This is enforced by the clang-tidy check ``libcpp-nodebug-on-aliases ``.
You can’t perform that action at this time.
0 commit comments