Update deprecated and removed headers in std lib

Colin Robertson · Colin Robertson · commit 2dc23b635ddc · 2019-07-11T15:56:51.000-07:00
diff --git a/docs/standard-library/ccomplex.md b/docs/standard-library/ccomplex.md
@@ -1,12 +1,16 @@
 ---
 title: "&lt;ccomplex&gt;"
-ms.date: "11/04/2016"
-f1_keywords: ["<ccomplex>"]
+ms.date: "07/11/2019"
+f1_keywords: ["<ccomplex>", "ccomplex"]
+helpviewer_keywords: ["ccomplex header"]
 ms.assetid: a9fcb5f0-88e3-464b-a5fd-d1afb8cd7e6f
 ---
 # &lt;ccomplex&gt;
 
-Includes the C++ Standard Library header [\<complex>](../standard-library/complex.md), which effectively includes the Standard C library header \<complex.h> and adds the associated names to the `std` namespace.
+Includes the C++ standard library header [\<complex>](complex.md).
+
+> [!NOTE]
+> The C standard library \<complex.h> header isn't included by \<ccomplex>, because it's effectively replaced by the C++ overloads in \<complex> and \<cmath>. That makes the \<ccomplex> header redundant. The \<complex.h> header is deprecated in C++. The \<ccomplex> header is deprecated in C++17 and removed in the draft C++20 standard.
 
 ## Syntax
 
@@ -16,11 +20,12 @@ Includes the C++ Standard Library header [\<complex>](../standard-library/comple
 
 ## Remarks
 
-Including this header ensures that the names declared using external linkage in the Standard C library header are declared in the `std` namespace.
-
-The name `clog`, which is declared in \<complex.h>, is not defined in the `std` namespace because of potential conflicts with the `clog` that is declared in [\<iostream>](../standard-library/iostream.md).
+The name `clog`, which is declared in \<complex.h>, isn't defined in the `std` namespace because of potential conflicts with the `clog` that's declared in [\<iostream>](iostream.md).
 
 ## See also
 
-[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)<br/>
-[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)<br/>
+[\<complex>](complex.md)\
+[\<cmath>](cmath.md)\
+[Header files reference](cpp-standard-library-header-files.md)\
+[C++ standard library overview](cpp-standard-library-overview.md)\
+[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)
diff --git a/docs/standard-library/ciso646.md b/docs/standard-library/ciso646.md
@@ -1,13 +1,16 @@
 ---
 title: "&lt;ciso646&gt;"
-ms.date: "11/04/2016"
-f1_keywords: ["<ciso646>"]
+ms.date: "07/11/2019"
+f1_keywords: ["<ciso646>", "ciso646"]
 helpviewer_keywords: ["ciso646 header"]
 ms.assetid: 9d570924-d299-4225-9a58-8c4c820f5903
 ---
 # &lt;ciso646&gt;
 
-Includes the Standard C library header \<iso646.h> and adds the associated names to the `std` namespace.
+Includes the C standard library header \<iso646.h>, and adds the associated names to the `std` namespace.
+
+> [!NOTE]
+> Because this compatibility header defines names that are keywords in C++, including it has no effect. The \<iso646.h> header is deprecated in C++. The \<ciso646> header is removed in the draft C++20 standard.
 
 ## Syntax
 
@@ -17,10 +20,10 @@ Includes the Standard C library header \<iso646.h> and adds the associated names
 
 ## Remarks
 
-Including this header ensures that the names declared using external linkage in the Standard C library header are declared in the `std` namespace.
+Including this header ensures that the names declared using external linkage in the C standard library header are declared in the `std` namespace.
 
 ## See also
 
-[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)<br/>
-[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)<br/>
-[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)<br/>
+[Header files reference](cpp-standard-library-header-files.md)\
+[C++ standard library overview](cpp-standard-library-overview.md)\
+[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)
diff --git a/docs/standard-library/cstdalign.md b/docs/standard-library/cstdalign.md
@@ -0,0 +1,32 @@
+---
+title: "&lt;cstdalign&gt;"
+ms.date: "07/11/2019"
+f1_keywords: ["<cstdalign>", "cstdalign", "__alignas_is_defined", "__alignof_is_defined"]
+helpviewer_keywords: ["cstdalign header", "__alignas_is_defined", "__alignof_is_defined"]
+ms.assetid: 9d570924-d299-4225-9a58-8c4c820f5903
+---
+# &lt;cstdalign&gt;
+
+In some C++ standard library implementations, this header includes the C standard library header \<stdalign.h>, and adds the associated names to the `std` namespace. Because that header isn't implemented in MSVC, the \<cstdalign> header defines compatibility macros `__alignas_is_defined` and `__alignof_is_defined`.
+
+> [!NOTE]
+> Because the \<stdalign.h> header defines macros that are keywords in C++, including it has no effect. The \<stdalign.h> header is deprecated in C++. The \<cstdalign> header is deprecated in C++17 and removed in the draft C++20 standard.
+
+## Syntax
+
+```cpp
+#include <cstdalign>
+```
+
+## Macros
+
+| Macro | Description |
+| - | - |
+| `__alignas_is_defined` | A C compatibility macro that expands to the integer constant 1. |
+| `__alignof_is_defined` | A C compatibility macro that expands to the integer constant 1. |
+
+## See also
+
+[Header files reference](cpp-standard-library-header-files.md)\
+[C++ standard library overview](cpp-standard-library-overview.md)\
+[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)
diff --git a/docs/standard-library/cstdbool.md b/docs/standard-library/cstdbool.md
@@ -1,11 +1,16 @@
 ---
 title: "&lt;cstdbool&gt;"
-ms.date: "11/04/2016"
+ms.date: "07/11/2019"
+f1_keywords: ["<cstdbool>", "cstdbool"]
+helpviewer_keywords: ["cstdbool header"]
 ms.assetid: 44ccb8b2-d808-4715-8097-58ba09ab33ed
 ---
 # &lt;cstdbool&gt;
 
-Includes the Standard C library header \<stdbool.h> and adds the associated names to the `std` namespace.
+Includes the C standard library header \<stdbool.h> and adds the associated names to the `std` namespace.
+
+> [!NOTE]
+> Because the \<stdbool.h> header defines macros that are keywords in C++, including it has no effect. The \<stdbool.h> header is deprecated in C++. The \<cstdbool> header is deprecated in C++17 and removed in the draft C++20 standard.
 
 ## Syntax
 
@@ -15,10 +20,10 @@ Includes the Standard C library header \<stdbool.h> and adds the associated name
 
 ## Remarks
 
-Including this header ensures that the names declared using external linkage in the Standard C library header are declared in the `std` namespace.
+Including this header ensures that the names declared using external linkage in the C standard library header are declared in the `std` namespace.
 
 ## See also
 
-[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)<br/>
-[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)<br/>
-[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)<br/>
+[[Header files reference](cpp-standard-library-header-files.md)\
+[C++ standard library overview](cpp-standard-library-overview.md)\
+[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)
diff --git a/docs/standard-library/ctgmath.md b/docs/standard-library/ctgmath.md
@@ -1,11 +1,16 @@
 ---
 title: "&lt;ctgmath&gt;"
-ms.date: "11/04/2016"
+ms.date: "07/11/2019"
+f1_keywords: ["<ctgmath>", "ctgmath"]
+helpviewer_keywords: ["ctgmath header"]
 ms.assetid: ff521893-f445-4dc8-a2f6-699185bb7024
 ---
 # &lt;ctgmath&gt;
 
-In effect, includes the C++ Standard Library headers \<ccomplex> and \<cmath>, which provide type-generic math macros equivalent to \<tgmath.h>.
+In effect, includes the C++ standard library headers \<complex> and \<cmath>, which provide type-generic math macros equivalent to \<tgmath.h>.
+
+> [!NOTE]
+> The C standard library \<tgmath.h> header isn't included by \<ctgmath>, because it's effectively replaced by the C++ overloads in \<complex> and \<cmath>. That makes the \<ctgmath> header redundant. The \<tgmath.h> header is deprecated in C++. The \<ctgmath> header is deprecated in C++17 and removed in the draft C++20 standard.
 
 ## Syntax
 
@@ -15,14 +20,12 @@ In effect, includes the C++ Standard Library headers \<ccomplex> and \<cmath>, w
 
 ## Remarks
 
-The functionality of the Standard C library header \<tgmath.h> is provided by overloads in \<ccomplex> and \<cmath>.
-
-Including this header ensures that the names declared using external linkage in the Standard C library header are declared in the `std` namespace.
+The functionality of the C standard library header \<tgmath.h> is provided by the overloads in \<complex> and \<cmath>.
 
 ## See also
 
-[\<ccomplex>](../standard-library/ccomplex.md)<br/>
-[\<cmath>](../standard-library/cmath.md)<br/>
-[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)<br/>
-[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)<br/>
-[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)<br/>
+[\<complex>](complex.md)\
+[\<cmath>](cmath.md)\
+[Header files reference](cpp-standard-library-header-files.md)\
+[C++ standard library overview](cpp-standard-library-overview.md)\
+[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)
