Skip to content

Commit acd52ab

Browse files
TylerMSFTTylerMSFT
and
TylerMSFT
authored
Twhitney addlinks (#3636)
* add cross-linking * update SDK version required * fix toc * fix dupe headings * fix dupe heading * add requirements to static_assert * add metadata * tune up wording about sdk version needed, and remove reference to a insider build sdk that is no longer available Co-authored-by: TylerMSFT <[email protected]>
1 parent 29be4c8 commit acd52ab

21 files changed

+112
-59
lines changed

docs/c-language/alignment-c.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Alignment (C11)"
33
description: "Describes Microsoft Visual C type alignment"
4-
ms.date: 06/22/2021
4+
ms.date: 06/29/2021
55
helpviewer_keywords: ["_Alignof keyword [C]", "_Alignas keyword [C]", "memory, alignment"]
66
---
77
# Alignment (C11)
@@ -57,7 +57,7 @@ typedef struct
5757
{
5858
int value; // aligns on a 4-byte boundary. There will be 28 bytes of padding between value and alignas
5959
alignas(32) char alignedMemory[32]; // assuming a 32 byte friendly cache alignment
60-
} cacheFriendly; // this struct will be 32-byte aligned because alignedMemory is 32-byte alligned and is the largest alignment specified in the struct
60+
} cacheFriendly; // this struct will be 32-byte aligned because alignedMemory is 32-byte aligned and is the largest alignment specified in the struct
6161
6262
int main()
6363
{
@@ -123,9 +123,9 @@ int main()
123123

124124
## Requirements
125125

126-
[`/std:c11`](../build/reference/std-specify-language-standard-version.md) or later is required.
126+
Compile with [`/std:c11`](../build/reference/std-specify-language-standard-version.md).
127127

128-
Requires Windows SDK 10.0.20201.0 or later. Windows SDK 10.0.20348.0 (version 2104) or later is recommended. You can download the latest SDK from the [Windows 10 SDK](https://developer.microsoft.com/windows/downloads/windows-10-sdk/) page. For more information, and instructions on how to install and use the SDK for C development, see [Install C11 and C17 support in Visual Studio](../overview/install-c17-support.md).
128+
Windows SDK 10.0.20348.0 (version 2104) or later. See [Windows 10 SDK](https://developer.microsoft.com/windows/downloads/windows-10-sdk/) to download the latest SDK. For instructions to install and use the SDK for C11 and C17 development, see [Install C11 and C17 support in Visual Studio](../overview/install-c17-support.md).
129129

130130
## See also
131131

docs/c-language/generic_selection.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Generic selection (C11)"
33
description: "Describes the C11 _Generic keyword used in the Microsoft Visual C compiler"
4-
ms.date: "12/9/2020"
4+
ms.date: "6/29/2021"
55
helpviewer_keywords: ["_Generic keyword [C]"]
66
---
77

@@ -70,6 +70,12 @@ Type name: double
7070

7171
```
7272

73+
## Requirements
74+
75+
Compile with [`/std:c11`](../build/reference/std-specify-language-standard-version.md).
76+
77+
Windows SDK 10.0.20348.0 (version 2104) or later. See [Windows 10 SDK](https://developer.microsoft.com/windows/downloads/windows-10-sdk/) to download the latest SDK. For instructions to install and use the SDK for C11 and C17 development, see [Install C11 and C17 support in Visual Studio](../overview/install-c17-support.md).
78+
7379
## See also
7480

7581
[`/std` (Specify Language Standard Version)](../build/reference/std-specify-language-standard-version.md)\

docs/c-language/static-assert-c.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "_Static_assert keyword and static_assert macro (C11)"
33
description: "Describes the C11 _Static_assert keyword and the C11 static_assert macro."
4-
ms.date: 06/22/2021
4+
ms.date: 06/29/2021
55
f1_keywords: ["static_assert_c", "_Static_assert"]
66
helpviewer_keywords: ["assertions [C], _Static_assert, static_assert"]
77
---
@@ -71,6 +71,10 @@ int main()
7171
|-------------|---------------------|
7272
|**`static_assert`**|\<assert.h>|
7373

74+
Compile with [`/std:c11`](../build/reference/std-specify-language-standard-version.md).
75+
76+
Windows SDK 10.0.20348.0 (version 2104) or later. See [Windows 10 SDK](https://developer.microsoft.com/windows/downloads/windows-10-sdk/) to download the latest SDK. For instructions to install and use the SDK for C11 and C17 development, see [Install C11 and C17 support in Visual Studio](../overview/install-c17-support.md).
77+
7478
## See also
7579

7680
[`_STATIC_ASSERT` Macro](../c-runtime-library/reference/static-assert-macro.md)\

docs/c-runtime-library/tgmath.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: "Type-generic math"
3-
description: "Describes macros in <tgmath.h> that make it easier to write C code that calls the right math function, based on argument type."
3+
description: "Describes macros in <tgmath.h> that make it easier to write C code that calls the correct math function, based on argument type."
44
ms.topic: "conceptual"
5-
ms.date: "12/10/2020"
5+
ms.date: "6/28/2021"
66
helpviewer_keywords: ["CRT tgmath.h"]
77
---
88

@@ -85,9 +85,9 @@ The following table lists the macros that are available in `<tgmath.h>` and what
8585

8686
## Requirements
8787

88-
[std:c++11](../build/reference/std-specify-language-standard-version.md) or later is required.
88+
Compile with [`/std:c11`](../build/reference/std-specify-language-standard-version.md).
8989

90-
Windows SDK version 10.0.20201.0 or later. This is currently an Insider build which you can download from [Windows Insider Preview Downloads](https://www.microsoft.com/software-download/windowsinsiderpreviewSDK). See [C11 and C17: Getting Started](https://devblogs.microsoft.com/cppblog/c11-and-c17-standard-support-arriving-in-msvc/#c11-and-c17-getting-started) for instructions on installing and using this SDK.
90+
Windows SDK 10.0.20348.0 (version 2104) or later. See [Windows 10 SDK](https://developer.microsoft.com/windows/downloads/windows-10-sdk/) to download the latest SDK. For instructions to install and use the SDK for C11 and C17 development, see [Install C11 and C17 support in Visual Studio](../overview/install-c17-support.md).
9191

9292
## See also
9393

docs/overview/install-c17-support.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Install C11 and C17 support in Visual Studio
33
description: "Install Windows SDK and CRT support for C11 and C17 in Visual Studio"
4-
ms.date: 06/22/2021
4+
ms.date: 06/29/2021
55
helpviewer_keywords: ["Install Windows SDK support for C"]
66
---
77
# Install C11 and C17 support in Visual Studio
@@ -16,7 +16,7 @@ Support for C11 and C17 standards requires Visual Studio 2019 version 16.8 or la
1616

1717
Support for C11 and C17 standards is available starting in Visual Studio 2019 version 16.8. Support requires an updated Universal C Runtime (UCRT) and the latest Windows SDK updates, to work properly with the conforming preprocessor ([`/Zc:preprocessor`](../build/reference/zc-preprocessor.md)).
1818

19-
Windows SDK releases correspond with Windows OS releases. C11 and C17 support requires Windows SDK 10.0.20201.0 or later. Windows SDK 10.0.20348.0 (version 2104) or later is recommended. Normally, the Windows SDK is an installable option in the Individual Components tab in the Visual Studio Installer. That's the recommended way to update the SDK for use with Visual Studio. However, at the time of writing, the latest Windows SDK isn't available in the Visual Studio Installer. You can follow these steps to set up the latest SDK and build C11 or C17 code in Visual Studio or at the command line.
19+
Windows SDK releases correspond with Windows OS releases. C11 and C17 support requires Windows SDK 10.0.20348.0 (version 2104) or later. Normally, the Windows SDK is an installable option in the Individual Components tab in the Visual Studio Installer. That's the recommended way to update the SDK for use with Visual Studio. However, at the time of writing, the latest Windows SDK isn't available in the Visual Studio Installer. You can follow these steps to set up the latest SDK and build C11 or C17 code in Visual Studio or at the command line.
2020

2121
## Prerequisites
2222

docs/standard-library/chrono-operators.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1061,7 +1061,7 @@ A `duration` object.
10611061
*`Div`*\
10621062
An integral value.
10631063
1064-
*`Left`*\
1064+
*`Left`*\w
10651065
The left `duration` object.
10661066
10671067
*`Right`*\

docs/standard-library/cstdalign.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,20 @@
11
---
2-
description: "Learn more about: &lt;cstdalign&gt;"
3-
title: "&lt;cstdalign&gt;"
4-
ms.date: "07/11/2019"
2+
description: "Learn more about: <cstdalign>"
3+
title: "<cstdalign>"
4+
ms.date: "6/28/2021"
55
f1_keywords: ["<cstdalign>", "__alignas_is_defined", "__alignof_is_defined"]
66
helpviewer_keywords: ["cstdalign header", "__alignas_is_defined", "__alignof_is_defined"]
7-
ms.assetid: 9d570924-d299-4225-9a58-8c4c820f5903
87
---
9-
# &lt;cstdalign&gt;
8+
# `<cstdalign>`
109

11-
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`.
10+
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`.
1211

1312
> [!NOTE]
14-
> 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.
13+
> 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.
1514
1615
## Requirements
1716

18-
**Header:** \<cstdalign>
17+
**Header:** `<cstdalign>`
1918

2019
**Namespace:** std
2120

docs/standard-library/ctgmath.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,31 @@
11
---
2-
description: "Learn more about: &lt;ctgmath&gt;"
3-
title: "&lt;ctgmath&gt;"
4-
ms.date: "07/11/2019"
2+
description: "Learn more about: `<ctgmath>`"
3+
title: "`<ctgmath>`"
4+
ms.date: "6/28/2021"
55
f1_keywords: ["<ctgmath>"]
66
helpviewer_keywords: ["ctgmath header"]
7-
ms.assetid: ff521893-f445-4dc8-a2f6-699185bb7024
87
---
9-
# &lt;ctgmath&gt;
8+
# `<ctgmath>`;
109

11-
In effect, includes the C++ standard library headers \<complex> and \<cmath>, which provide type-generic math macros equivalent to \<tgmath.h>.
10+
In effect, includes the C++ standard library headers `<complex>` and `<cmath>`, which provide type-generic math macros equivalent to `<tgmath.h>`.
1211

1312
> [!NOTE]
14-
> 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.
13+
> 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.
1514
1615
## Requirements
1716

18-
**Header:** \<ctgmath>
17+
**Header:** `<ctgmath>`
1918

20-
**Namespace:** std
19+
**Namespace:** `std`
2120

2221
## Remarks
2322

24-
The functionality of the C standard library header \<tgmath.h> is provided by the overloads in \<complex> and \<cmath>.
23+
The functionality of the C standard library header `<tgmath.h>` is provided by the overloads in `<complex>` and `<cmath>`.
2524

2625
## See also
2726

28-
[\<complex>](complex.md)\
29-
[\<cmath>](cmath.md)\
27+
[`<complex>`](complex.md)\
28+
[`<cmath>`](cmath.md)\
3029
[Header files reference](cpp-standard-library-header-files.md)\
3130
[C++ standard library overview](cpp-standard-library-overview.md)\
3231
[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)

docs/standard-library/day-class.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -268,4 +268,8 @@ Output:
268268
## See also
269269

270270
[`<chrono>`](../standard-library/chrono.md)\
271+
[`month_day` class](month-day-class.md)\
272+
[`month_day_last` class](month-day-last-class.md)\
273+
[`year_month_day`](year-month-day-class.md)\
274+
[`year_month_day_last`](year-month-day-last-class.md)\
271275
[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)

docs/standard-library/month-day-class.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: month_day Class"
33
title: "month_day class"
4-
ms.date: "6/25/2021"
4+
ms.date: "6/28/2021"
55
f1_keywords: ["chrono/std::chrono::month_day", "chrono/std::chrono::month_day::day", "chrono/std::chrono::month_day::month", "chrono/std::chrono::month_day::ok"]
66
helpviewer_keywords: ["std::chrono [C++], month_day"]
77
---
@@ -64,6 +64,8 @@ Construct a `month_day` with a month value of *`m`*.
6464
1\) The default constructor doesn't initialize the month or day values.\
6565
2\) Construct a `month_day` with the month value initialized to `m` and the day value initialized to `d`.
6666
67+
For information about C++ 20 syntax to specify dates, see [`operator/`](chrono-operators.md#op_/)
68+
6769
### Example: Create a `month_day`
6870
6971
```cpp
@@ -129,6 +131,8 @@ A `month_day` is valid if the month is valid and the day is less than or equal t
129131

130132
[`<chrono>`](chrono.md)\
131133
[`month` class](month-class.md)\
134+
[`month_day` class](month-day-class.md)\
132135
[`month_day_last` class](month-day-last-class.md)\
133136
[`month_weekday` class](month-weekday-class.md)\
134-
[`month_weekday_last` class](month-weekday-last-class.md)
137+
[`month_weekday_last` class](month-weekday-last-class.md)\
138+
[`operator/`](chrono-operators.md#op_/)

docs/standard-library/month-day-last-class.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: month_day_last Class"
33
title: "month_day_last class"
4-
ms.date: "06/25/2021"
4+
ms.date: "06/28/2021"
55
f1_keywords: ["chrono/std::chrono::month_day_last", "chrono/std::chrono::month_day_last::month", "chrono/std::chrono::month_day_last::ok"]
66
helpviewer_keywords: ["std::chrono [C++], month_day_last"]
77
---
@@ -53,6 +53,10 @@ constexpr explicit month_day_last(const month& m) noexcept;
5353
*`m`*\
5454
Construct a `month_day_last` for the month specified by *`m`*.
5555
56+
## Remarks
57+
58+
For information about C++ 20 syntax used to specify dates, see [`operator/`](chrono-operators.md#op_/)
59+
5660
### Example: Create a `month_day_last`
5761
5862
```cpp
@@ -102,6 +106,9 @@ constexpr bool ok() const noexcept;
102106

103107
[`<chrono>`](chrono.md)\
104108
[`month` class](month-class.md)\
109+
[`month_day` class](month-day-class.md)\
105110
[`month_day_last` class](month-day-last-class.md)\
106111
[`month_weekday` class](month-weekday-class.md)\
107-
[`month_weekday_last` class](month-weekday-last-class.md)
112+
[`month_weekday_last` class](month-weekday-last-class.md)\
113+
[`operator/`](chrono-operators.md#op_/)
114+
[Header Files Reference](cpp-standard-library-header-files.md)

docs/standard-library/month-weekday-class.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: month_weekday Class"
33
title: "month_weekday class"
4-
ms.date: "06/25/2021"
4+
ms.date: "06/28/2021"
55
f1_keywords: ["chrono/std::chrono::month_weekday", "chrono/std::chrono::month_weekday::weekday", "chrono/std::chrono::month_weekday::month", "chrono/std::chrono::month_weekday::ok", "chrono/std::chrono::month_weekday::weekday_indexed"]
66
helpviewer_keywords: ["std::chrono [C++], month_weekday"]
77
---
@@ -61,6 +61,10 @@ Construct a `month_weekday` with a month value of *`m`*.
6161
*`wdi`*\
6262
Construct a `month_weekday` with a weekday value of *`wdi`*.
6363
64+
## Remarks: Constructor
65+
66+
For information about C++ 20 syntax to specify dates, see [`operator/`](chrono-operators.md#op_/)
67+
6468
### Example: Create a `month_weekday`
6569
6670
```cpp

docs/standard-library/month-weekday-last-class.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: month_weekday_last Class"
33
title: "month_weekday_last class"
4-
ms.date: "6/25/2021"
4+
ms.date: "6/28/2021"
55
f1_keywords: ["chrono/std::chrono::month_weekday_last", "chrono/std::chrono::month_weekday_last::ok", "std::chrono::month_weekday_last::month_weekday_last", "chrono/std::chrono::month_weekday_last::ok", "chrono/std::chrono::month_weekday_last::month"]
66
helpviewer_keywords: ["std::chrono [C++], month_weekday_last"]
77
---
@@ -60,6 +60,10 @@ The `month` value for the created `month_weekday_last` class.
6060
*`wdl`*\
6161
The` weekday_last` value for the created `month_weekday_last` class.
6262
63+
## Remarks: Constructor
64+
65+
For information about C++ 20 syntax to specify dates, see [`operator/`](chrono-operators.md#op_/)
66+
6367
### Example: Create a `month_weekday_last`
6468
6569
```cpp
@@ -130,4 +134,5 @@ The `weekday_last` value.
130134
[`month` class](month-class.md)\
131135
[`month_day` class](month-day-class.md)\
132136
[`month_day_last` class](month-day-last-class.md)\
133-
[`month_weekday` class](month-weekday-class.md)
137+
[`month_weekday` class](month-weekday-class.md)\
138+
[`operator/`](chrono-operators.md#op_/)

docs/standard-library/toc.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,8 @@
158158
href: ../standard-library/duration-values-structure.md
159159
- name: hh_mm_ss class
160160
href: ../standard-library/hhmmss-class.md
161+
- name: high_resolution_clock struct
162+
href: high-resolution-clock-struct.md
161163
- name: leap_second class
162164
href: ../standard-library/leap-second-class.md
163165
- name: leap_second_info struct
@@ -184,10 +186,10 @@
184186
href: ../standard-library/treat-as-floating-point-structure.md
185187
- name: weekday class
186188
href: weekday-class.md
187-
- name: weekday_last class
188-
href: weekdaylast-class.md
189189
- name: weekday_indexed
190190
href: weekdayindexed-class.md
191+
- name: weekday_last class
192+
href: weekdaylast-class.md
191193
- name: year class
192194
href: year-class.md
193195
- name: year_month class

docs/standard-library/weekdaylast-class.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: weekday_last Class"
33
title: "weekday_last class"
4-
ms.date: "06/25/2021"
4+
ms.date: "06/28/2021"
55
f1_keywords: ["chrono/std::chrono::weekday_last", "chrono/std::chrono::weekday_last::ok", "std::chrono::weekday_last::weekday", "chrono/std::chrono::weekday_last::ok", "chrono/std::chrono::weekday_last::weekday"]
66
helpviewer_keywords: ["std::chrono [C++], weekday_last"]
77
---
@@ -116,7 +116,7 @@ Mon
116116

117117
## See also
118118

119+
[`<chrono>`](chrono.md)\
119120
[`weekday` class](weekday-class.md)\
120121
[`weekday_indexed` class](weekdayindexed-class.md)\
121-
[`<chrono>`](chrono.md)\
122122
[Header Files Reference](cpp-standard-library-header-files.md)

docs/standard-library/year-class.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: year Class"
33
title: "year class"
4-
ms.date: "06/25/2021"
4+
ms.date: "06/28/2021"
55
f1_keywords: ["chrono/std::chrono::year", "chrono/std::chrono::year::operator++", "chrono/std::chrono::year::operator--", "chrono/std::chrono::year::operator+=", "chrono/std::chrono::year::operator-=", "chrono/std::chrono::year::operator int", "chrono/std::chrono::year::is_leap", "chrono/std::chrono::year::max", "chrono/std::chrono::min", "chrono/std::chrono::year::ok"]
66
helpviewer_keywords: ["std::chrono [C++], year"]
77
---
@@ -378,10 +378,10 @@ int main()
378378

379379
## See also
380380

381+
[`<chrono>`](chrono.md)\
381382
[`year_month`](year-month-class.md)\
382383
[`year_month_day`](year-month-day-class.md)\
383384
[`year_month_day_last`](year-month-day-last-class.md)\
384385
[`year_month_weekday`](year-month-weekday-class.md)\
385386
[`year_month_weekday_last`](year-month-weekday-last-class.md)\
386-
[`<chrono>`](chrono.md)\
387387
[Header Files Reference](cpp-standard-library-header-files.md)

0 commit comments

Comments
 (0)