Skip to content

Commit 9c076eb

Browse files
authored
[diff.mods.to.headers] Explain what happened to meaningless C headers (#1051)
1 parent 9df9501 commit 9c076eb

File tree

1 file changed

+22
-2
lines changed

1 file changed

+22
-2
lines changed

source/compatibility.tex

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2152,11 +2152,31 @@
21522152
\rSec2[diff.mods.to.headers]{Modifications to headers}
21532153

21542154
\pnum
2155-
For compatibility with the C standard library,
2156-
\indextext{library!C standard}%
2155+
For compatibility with the C standard library\indextext{library!C standard},
21572156
the \Cpp standard library provides the C headers enumerated
21582157
in~\ref{depr.c.headers}, but their use is deprecated in \Cpp.
21592158

2159+
\pnum
2160+
There are no \Cpp headers for the C headers
2161+
\tcode{<stdatomic.h>}\indextext{\idxhdr{stdatomic.h}},
2162+
\tcode{<stdnoreturn.h>}\indextext{\idxhdr{stdnoreturn.h}},
2163+
and \tcode{<threads.h>}\indextext{\idxhdr{threads.h}},
2164+
nor are the C headers themselves part of \Cpp.
2165+
2166+
\pnum
2167+
The headers \tcode{<ccomplex>}\indextext{\idxhdr{ccomplex}}~(\ref{ccomplex.syn})
2168+
and \tcode{<ctgmath>}\indextext{\idxhdr{ctgmath}}~(\ref{ctgmath.syn}), as well
2169+
as their corresponding C headers \tcode{<complex.h>}\indextext{\idxhdr{complex.h}}
2170+
and \tcode{<tgmath.h>}\indextext{\idxhdr{tgmath.h}}, do not contain any of the
2171+
content from the C standard library and instead merely include other headers
2172+
from the \Cpp standard library.
2173+
2174+
\pnum
2175+
The headers \tcode{<ciso646>}, \tcode{<cstdalign>}~(\ref{cstdalign.syn}),
2176+
and \tcode{<cstdbool>}~(\ref{cstdbool.syn}) are meaningless in \Cpp. Use of
2177+
the \Cpp headers \tcode{<ccomplex>}, \tcode{<cstdalign>}, \tcode{<cstdbool>},
2178+
and \tcode{<ctgmath>} is deprecated~(\ref{depr.c.headers}).
2179+
21602180
\rSec2[diff.mods.to.definitions]{Modifications to definitions}
21612181

21622182
\rSec3[diff.char16]{Types \tcode{char16_t} and \tcode{char32_t}}

0 commit comments

Comments
 (0)