10/19/2021 AM Publish (#3846)

* add new classes: ambiguous_local_time & nonexistent_local_time

* acrolinx

* fix links

* finish descriptions

* fix more links

* smoothing out

* proofing

* add some better linking

* tune description

* update descriptions

* needed to update local-info-struct.md to reflect changes to descriptions for nonexistent and ambiguous

* add chrono functions

* rounding out duration links

* Add documentation for IntelliSense linter for C++ (#3821)

* Add first draft of linter check documentation

* WIP overview.

Signed-off-by: Kyle Reed <[email protected]>

* Update toc. First draft of the linter overview.

* Add screenshots, move files, code samples are stand-alone.

Signed-off-by: Kyle Reed <[email protected]>

* Style and Acrolinx grammar checker pass

* Add missing Options cues for checks

* Update to use latest option names

Co-authored-by: [email protected] <[email protected]>

* connecting duration up to it's non-member pieces and doing some general updates

* fix links

* cleanup

* Split out VS2019 content for linter (#3824)

* Update working-with-project-properties.md

* cleanup

* cleanup

* cleanup

* cleanup

* cleanup

* cleanup

* cleanup

* fix function signature

* fix line ending

* remove duplicate

* Address /profile issues per Paddy McD (#3834)

* Fixed documentation that destroy dialogs

* Update void-cpp for cpp-docs 3441

Reported in MicrosoftDocs/cpp-docs/issues/3441
Clarify kinds of class member where you can't use `void*`.
Fix styles.
Acrolinx a few things.

* More clarity on void pointers to members

* zoned_traits (#3831)

* add zoned_traits

* draft clock_cast and clock_time_conversion

* first draft

* draft

* draft

* fix heading

* cleanup

* add tzdb and tzdb-list

* draft

* draft

* pull examples

* draft cleanup

* acrolinx

* draft cleanup

* draft cleanup

* incorp tech review

* tech review

* cleanup

* cleanup

* acrolinx

* fix casing

* add example descriptions

* wording

* last adjustments

* wording

Co-authored-by: TylerMSFT <[email protected]>

* Update 16.1 conformance per J Emmett

* Update docs/error-messages/compiler-errors-2/compiler-error-c2666.md

* Fix typo in page title

* Fix TOC schema before VS2022 changes

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Colin Robertson <[email protected]>
Co-authored-by: Kyle Reed <[email protected]>
Co-authored-by: Chai Wei Jie <[email protected]>
Co-authored-by: opbld15 <[email protected]>
Co-authored-by: PRMerger19 <[email protected]>
Co-authored-by: Laura Brenner <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Andrea Courtright <[email protected]>
Co-authored-by: PRMerger15 <[email protected]>
Co-authored-by: opbld16 <[email protected]>
Co-authored-by: PRMerger8 <[email protected]>
Co-authored-by: Anju Del Moral Gonzalez <[email protected]>
Co-authored-by: opbld17 <[email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Miya Natsuhara <[email protected]>
Co-authored-by: Kristine Toliver <[email protected]>

Author: 18 people

docs/_breadcrumb/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Docs
   tocHref: /
   topicHref: /

docs/assembler/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Compiler intrinsics and assembly language
   href: ../intrinsics/index.yml
 - name: Compiler intrinsics

docs/atl-mfc-shared/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: ATL-MFC shared classes
   href: ../atl-mfc-shared/atl-mfc-shared-classes.md
 - name: ATL-MFC concepts

docs/atl/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Active Template Library (ATL)
   href: atl-com-desktop-components.md
 - name: Active Template Library (ATL) concepts

docs/build-insights/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: "C++ Build Insights"
   href: ../build-insights/index.yml
 - name: "Get started with C++ Build Insights"

docs/build/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Projects and build systems
   href: ../build/projects-and-build-systems-cpp.md
 - name: Visual Studio projects - C++

docs/c-language/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: C language documentation
   href: ../c-language/index.yml
 - name: C language reference

docs/c-runtime-library/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: C runtime library (CRT) reference
   href: ../c-runtime-library/c-run-time-library-reference.md
 - name: CRT library features

docs/code-quality/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Code analysis documentation
   href: ../code-quality/index.yml
 - name: Overview

docs/cpp/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: C++ language documentation
   href: ../cpp/index.yml
 - name: C++ language reference
@@ -69,9 +70,9 @@
           href: ../cpp/void-cpp.md
         - name: bool
           href: ../cpp/bool-cpp.md
-        - name: false
+        - name: "false"
           href: ../cpp/false-cpp.md
-        - name: true
+        - name: "true"
           href: ../cpp/true-cpp.md
         - name: char, wchar_t, char8_t, char16_t, char32_t
           href: ../cpp/char-wchar-t-char16-t-char32-t.md
@@ -419,8 +420,6 @@
           href: ../cpp/special-member-functions.md
         - name: Static members
           href: ../cpp/static-members-cpp.md
-        - name: C++ classes as value types
-          href: ../cpp/value-types-modern-cpp.md
         - name: User-defined type conversions
           href: ../cpp/user-defined-type-conversions-cpp.md
         - name: Mutable data members
@@ -481,8 +480,6 @@
           href: ../cpp/how-to-create-and-use-weak-ptr-instances.md
         - name: "How to: Create and use CComPtr and CComQIPtr instances"
           href: ../cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md
-        - name: Pimpl for compile-time encapsulation
-          href: ../cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md  
     - name: Exception handling in C++
       items: 
         - name: Exception handling in C++

docs/cppcx/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: UWP development
   href: ../cppcx/universal-windows-apps-cpp.md
 - name: C++/CX language reference

docs/cross-platform/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Cross-platform mobile development with C++
   href: ../cross-platform/index.yml
 - name: Overview

docs/data/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Data access in Visual C++
   href: ../data/data-access-in-cpp.md
 - name: Data access programming (MFC-ATL)

docs/dotnet/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: .NET programming with C++/CLI
   href: ../dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md
 - name: "Walkthrough: Compile a C++/CLI program that targets the CLR"

docs/error-messages/compiler-errors-2/compiler-error-c2666.md

@@ -1,7 +1,7 @@
 ---
 description: "Learn more about: Compiler Error C2666"
 title: "Compiler Error C2666"
-ms.date: "11/04/2016"
+ms.date: 10/18/2021
 f1_keywords: ["C2666"]
 helpviewer_keywords: ["C2666"]
 ms.assetid: 78364d15-c6eb-439a-9088-e04a0176692b
@@ -30,6 +30,52 @@ int main() {
 }
 ```
 
+This error can be generated as a result of compiler conformance work that was done for Visual Studio 2019 version 16.1:
+
+- A conversion that promotes an enumeration whose underlying type is fixed to its underlying type is better than one that promotes to the promoted underlying type, if the two are different.
+
+The following example demonstrates how compiler behavior changes in Visual Studio 2019 version 16.1 and later versions:
+
+```cpp
+#include <type_traits>
+
+enum E : unsigned char { e };
+
+int f(unsigned int)
+{
+    return 1;
+}
+
+int f(unsigned char)
+{
+    return 2;
+}
+
+struct A {};
+struct B : public A {};
+
+int f(unsigned int, const B&)
+{
+    return 3;
+}
+
+int f(unsigned char, const A&)
+{
+    return 4;
+}
+
+int main()
+{
+    // Calls f(unsigned char) in 16.1 and later. Called f(unsigned int) in earlier versions.
+    // The conversion from 'E' to the fixed underlying type 'unsigned char' is better than the
+    // conversion from 'E' to the promoted type 'unsigned int'.
+    f(e);
+  
+    // Error C2666. This call is ambiguous, but previously called f(unsigned int, const B&). 
+    f(e, B{});
+}
+```
+
 This error can also be generated as a result of compiler conformance work that was done for Visual Studio .NET 2003:
 
 - binary operators and user-defined conversions to pointer types

docs/error-messages/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: C/C++ Compiler and build tools errors and warnings
   href: compiler-errors-1/c-cpp-build-errors.md
 - name: BSCMAKE errors and warnings

docs/extensions/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Component Extensions for .NET and UWP
   href: ../extensions/component-extensions-for-runtime-platforms.md
 - name: Tracking reference operator

docs/get-started/breadcrumb/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Docs
   tocHref: /
   topicHref: /

docs/ide/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Read and write C++ code in Visual Studio
   expanded: true
   items: 

docs/intrinsics/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Compiler intrinsics and assembly language
   href: ../intrinsics/index.yml
 - name: Compiler intrinsics

docs/linux/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Linux with Visual Studio C++ documentation
   href: ../linux/index.yml
 - name: Download, install, and set up the Linux Development workload

docs/mfc/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: MFC desktop applications
   href: mfc-desktop-applications.md
 - name: MFC concepts

docs/overview/cpp-conformance-improvements.md

@@ -1,7 +1,7 @@
 ---
 title: "C++ conformance improvements in Visual Studio 2019"
 description: "Microsoft C++ in Visual Studio is progressing toward full conformance with the C++20 language standard."
-ms.date: 06/11/2021
+ms.date: 10/18/2021
 ms.technology: "cpp-language"
 ---
 # C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2019
@@ -523,6 +523,58 @@ void f() {
 
 [P0329R4](https://wg21.link/p0329r4) (C++20) *Designated initialization* allows specific members to be selected in aggregate initialization by using the `Type t { .member = expr }` syntax. Requires **`/std:c++latest`** (or **`/std:c++20`** starting in Visual Studio 2019 version 16.11).
 
+### Ranking of enum conversion to its fixed underlying type
+
+The compiler now ranks enum conversions according to [N4800](https://wg21.link/n4800) 11.3.3.2 Ranking implicit conversion sequences (4.2):
+
+- A conversion that promotes an enumeration whose underlying type is fixed to its underlying type is better than one that promotes to the promoted underlying type, if the two are different.
+
+This conversion ranking wasn't implemented correctly before Visual Studio 2019 version 16.1. The conforming behavior may change overload resolution behavior or expose an ambiguity where one previously was not detected.
+
+This compiler behavior change applies to all **`/std`** modes and is both a source and binary breaking change.
+
+The following example demonstrates how compiler behavior changes in 16.1 and later versions:
+
+```cpp
+#include <type_traits>
+
+enum E : unsigned char { e };
+
+int f(unsigned int)
+{
+    return 1;
+}
+
+int f(unsigned char)
+{
+    return 2;
+}
+
+struct A {};
+struct B : public A {};
+
+int f(unsigned int, const B&)
+{
+    return 3;
+}
+
+int f(unsigned char, const A&)
+{
+    return 4;
+}
+
+int main()
+{
+    // Calls f(unsigned char) in 16.1 and later. Called f(unsigned int) in earlier versions.
+    // The conversion from 'E' to the fixed underlying type 'unsigned char' is better than the
+    // conversion from 'E' to the promoted type 'unsigned int'.
+    f(e);
+  
+    // Error C2666. This call is ambiguous, but previously called f(unsigned int, const B&). 
+    f(e, B{});
+}
+```
+
 ### New and updated standard library functions (C++20)
 
 - `starts_with()` and `ends_with()` for `basic_string` and `basic_string_view`.
@@ -2462,6 +2514,12 @@ struct S {
 };
 ```
 
+## <a name="improvements_16b"></a> Conformance improvements in Visual Studio 2019 version 16.11
+
+### `/std:c++20` compiler mode
+
+Starting in Visual Studio 2019 version 16.11, the compiler now supports the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) compiler mode. Previously, C++20 features were available only in [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) mode in Visual Studio 2019. Features that originally required **`/std:c++latest`** mode now work in **`/std:c++20`** mode or later in the latest versions of Visual Studio.
+
 ## See also
 
 [Microsoft C/C++ language conformance](visual-cpp-language-conformance.md)

docs/overview/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Microsoft C/C++ in Visual Studio
   expanded: false
   items: 

docs/parallel/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Parallel programming in MSVC
   href: ../parallel/parallel-programming-in-visual-cpp.md
 - name: Auto-parallelization and auto-vectorization

docs/porting/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Microsoft C++ Porting and Upgrade Guide
   href: ../porting/visual-cpp-porting-and-upgrading-guide.md
 - name: Upgrade projects from earlier versions

docs/preprocessor/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: C/C++ preprocessor reference
   href: ../preprocessor/c-cpp-preprocessor-reference.md
 - name: Preprocessor

docs/sanitizers/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: "Code Sanitizers"
   href: ../sanitizers/index.yml
 - name: "AddressSanitizer"

docs/standard-library/file-clock-class.md

@@ -1,6 +1,6 @@
 ---
 description: "Learn more about: file_clock class"
-title: "fiie_clock class"
+title: "file_clock class"
 ms.date: 08/19/2021
 f1_keywords: ["chrono/std::chrono::file_clock", "chrono/std::chrono::file_clock::now", "chrono/std::chrono::file_clock::to_utc", "chrono/std::chrono::file_clock::from_utc", "chrono/std::chrono::file_clock::is_steady Constant"]
 ---
@@ -177,4 +177,4 @@ A [time_point](time-point-class.md) object that represents the current time.
 [`system_clock` struct](system-clock-structure.md)\
 [`tai_clock` class](tai-clock-class.md)\
 [`utc_clock` class](utc-clock-class.md)\
-[Header Files Reference](cpp-standard-library-header-files.md)
+[Header Files Reference](cpp-standard-library-header-files.md)

docs/standard-library/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: C++ Standard Library reference
   href: cpp-standard-library-reference.md
 - name: C++ Standard Library header files

docs/text/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Text and strings in MSVC
   href: ../text/text-and-strings-in-visual-cpp.md
 - name: Unicode and MBCS

docs/windows/toc.yml

@@ -1,3 +1,4 @@
+items: 
 - name: Overview of Windows programming in C++
   href: ../windows/overview-of-windows-programming-in-cpp.md
 - name: Desktop Applications in C++