Merge pull request #3953 from MicrosoftDocs/main637898744477064019

Repo sync for protected CLA branch

Author: Colin Robertson

docs/atl/reference/cwindowimpl-class.md

@@ -276,7 +276,7 @@ virtual void OnFinalMessage(HWND hWnd);
 
 ### Remarks
 
-The default implementation of `OnFinalMessage` does nothing, but you can override this function to handle cleanup before destroying a window. If you want to automatically delete your object upon the window destruction, you can call **delete this;** in this function.
+The default implementation of `OnFinalMessage` does nothing, but you can override this function to handle cleanup before destroying a window. If you want to automatically delete your object upon the window destruction, you can call `delete this;` in this function.
 
 ## <a name="subclasswindow"></a> CWindowImpl::SubclassWindow
 

docs/cpp/function-overloading.md

@@ -368,7 +368,7 @@ Even though the second one requires both a standard conversion and the user-defi
 > [!NOTE]
 > User-defined conversions are considered conversion by construction or conversion by initialization (conversion function). Both methods are considered equal when considering the best match.
 
-## Argument matching and the this pointer
+## Argument matching and the `this` pointer
 
 Class member functions are treated differently, depending on whether they are declared as **`static`**. Because nonstatic functions have an implicit argument that supplies the **`this`** pointer, nonstatic functions are considered to have one more argument than static functions; otherwise, they are declared identically.
 

docs/cpp/object-lifetime-and-resource-management-modern-cpp.md

@@ -1,13 +1,13 @@
 ---
 title: "Object lifetime and resource management (RAII)"
 description: "Follow the principle of RAII in modern C++ to avoid resource leaks."
-ms.date: "11/19/2019"
+ms.date: 06/02/2022
 ms.topic: "conceptual"
 ms.assetid: 8aa0e1a1-e04d-46b1-acca-1d548490700f
 ---
 # Object lifetime and resource management (RAII)
 
-Unlike managed languages, C++ doesn't have automatic *garbage collection*. That's an internal process that releases heap memory and other resources as a program runs. A C++ program is responsible for returning all acquired resources to the operating system. Failure to release an unused resource is called a *leak*. Leaked resources are unavailable to other programs until the process exits. Memory leaks in particular are a common cause of bugs in C-style programming.
+Unlike managed languages, C++ doesn't have automatic *garbage collection*, an internal process that releases heap memory and other resources as a program runs. A C++ program is responsible for returning all acquired resources to the operating system. Failure to release an unused resource is called a *leak*. Leaked resources are unavailable to other programs until the process exits. Memory leaks in particular are a common cause of bugs in C-style programming.
 
 Modern C++ avoids using heap memory as much as possible by declaring objects on the stack. When a resource is too large for the stack, then it should be *owned* by an object. As the object gets initialized, it acquires the resource it owns. The object is then responsible for releasing the resource in its destructor. The owning object itself is declared on the stack. The principle that *objects own resources* is also known as "resource acquisition is initialization," or RAII.
 
@@ -48,7 +48,7 @@ public:
 };
 
 void functionUsingWidget() {
-    widget w(1000000);   // lifetime automatically tied to enclosing scope
+    widget w(1000000);  // lifetime automatically tied to enclosing scope
                         // constructs w, including the w.data member
     w.do_something();
 
@@ -63,20 +63,19 @@ Since C++11, there's a better way to write the previous example: by using a smar
 class widget
 {
 private:
-    std::unique_ptr<int> data;
+    std::unique_ptr<int[]> data;
 public:
-    widget(const int size) { data = std::make_unique<int>(size); }
+    widget(const int size) { data = std::make_unique<int[]>(size); }
     void do_something() {}
 };
 
 void functionUsingWidget() {
-    widget w(1000000);   // lifetime automatically tied to enclosing scope
-                // constructs w, including the w.data gadget member
+    widget w(1000000);  // lifetime automatically tied to enclosing scope
+                        // constructs w, including the w.data gadget member
     // ...
     w.do_something();
     // ...
 } // automatic destruction and deallocation for w and w.data
-
 ```
 
 By using smart pointers for memory allocation, you may eliminate the potential for memory leaks. This model works for other resources, such as file handles or sockets. You can manage your own resources in a similar way in your classes. For more information, see [Smart pointers](smart-pointers-modern-cpp.md).
@@ -85,6 +84,6 @@ The design of C++ ensures objects are destroyed when they go out of scope. That
 
 ## See also
 
-[Welcome back to C++](../cpp/welcome-back-to-cpp-modern-cpp.md)<br/>
-[C++ Language Reference](../cpp/cpp-language-reference.md)<br/>
+[Welcome back to C++](../cpp/welcome-back-to-cpp-modern-cpp.md)\
+[C++ language reference](../cpp/cpp-language-reference.md)\
 [C++ Standard Library](../standard-library/cpp-standard-library-reference.md)

docs/cpp/this-pointer.md

@@ -1,13 +1,13 @@
 ---
-title: "this pointer"
+title: "The this pointer"
 description: "The this pointer is a compiler-generated pointer to the current object in nonstatic member functions."
 ms.date: "01/22/2020"
 f1_keywords: ["this_cpp"]
 helpviewer_keywords: ["nonstatic member functions [C++]", "pointers, to class instance", "this pointer"]
 ms.assetid: 92e3256a-4ad9-4d46-8be1-d77fad90791f
 no-loc: [this, class, struct, union, sizeof, const, volatile]
 ---
-# this pointer
+# The `this` pointer
 
 The **`this`** pointer is a pointer accessible only within the nonstatic member functions of a **`class`**, **`struct`**, or **`union`** type. It points to the object for which the member function is called. Static member functions don't have a **`this`** pointer.
 
@@ -131,7 +131,7 @@ my buffer
 your buffer
 ```
 
-## Type of the this pointer
+## Type of the `this` pointer
 
 The **`this`** pointer's type can be modified in the function declaration by the **`const`** and **`volatile`** keywords. To declare a function that has either of these attributes, add the keyword(s) after the function argument list.
 
@@ -161,15 +161,15 @@ int main()
 }
 ```
 
-The type of **`this`** in a member function is described by the following syntax. The *cv-qualifier-list* is determined from the member function's declarator. It can be **`const`** or **`volatile`** (or both). *class-type* is the name of the class:
+The type of **`this`** in a member function is described by the following syntax. The *`cv-qualifier-list`* is determined from the member function's declarator. It can be **`const`** or **`volatile`** (or both). *`class-type`* is the name of the class:
 
-[*cv-qualifier-list*] *class-type* **\* const this**
+[*`cv-qualifier-list`*] *`class-type`* **`* const this`**
 
-In other words, the **`this`** pointer is always a const pointer. It can't be reassigned.  The **`const`** or **`volatile`** qualifiers used in the member function declaration apply to the class instance the **`this`** pointer points at, in the scope of that function.
+In other words, the **`this`** pointer is always a **`const`** pointer. It can't be reassigned.  The **`const`** or **`volatile`** qualifiers used in the member function declaration apply to the class instance the **`this`** pointer points at, in the scope of that function.
 
 The following table explains more about how these modifiers work.
 
-### Semantics of this modifiers
+### Semantics of `this` modifiers
 
 |Modifier|Meaning|
 |--------------|-------------|

docs/cpp/welcome-back-to-cpp-modern-cpp.md

@@ -1,7 +1,7 @@
 ---
 title: "Welcome back to C++ - Modern C++"
 description: "Describes the new programming idioms in Modern C++ and their rationale."
-ms.date: 02/07/2022
+ms.date: 06/02/2022
 ms.topic: "conceptual"
 ms.assetid: 1cb1b849-ed9c-4721-a972-fd8f3dab42e2
 ---
@@ -24,15 +24,15 @@ To support easy adoption of RAII principles, the C++ Standard Library provides t
 class widget
 {
 private:
-    std::unique_ptr<int> data;
+    std::unique_ptr<int[]> data;
 public:
-    widget(const int size) { data = std::make_unique<int>(size); }
+    widget(const int size) { data = std::make_unique<int[]>(size); }
     void do_something() {}
 };
 
 void functionUsingWidget() {
-    widget w(1000000);   // lifetime automatically tied to enclosing scope
-                // constructs w, including the w.data gadget member
+    widget w(1000000);  // lifetime automatically tied to enclosing scope
+                        // constructs w, including the w.data gadget member
     // ...
     w.do_something();
     // ...

docs/error-messages/compiler-errors-1/compiler-error-c2107.md

@@ -14,7 +14,7 @@ A subscript is applied to an expression that does not evaluate to a pointer.
 
 ## Example
 
-C2107 can occur if you incorrectly use the **`this`** pointer of a value type to access the type's default indexer. For more information, see [Semantics of the this pointer](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Semantics_of_the_this_pointer).
+C2107 can occur if you incorrectly use the **`this`** pointer of a value type to access the type's default indexer. For more information, see [Semantics of the `this` pointer](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Semantics_of_the_this_pointer).
 
 The following sample generates C2107.
 

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

@@ -1,13 +1,15 @@
 ---
 description: "Learn more about: Compiler Error C2834"
 title: "Compiler Error C2834"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2834"]
 helpviewer_keywords: ["C2834"]
 ms.assetid: 28f9f6eb-ab2a-4e64-aaaa-9d14f955de41
 ---
 # Compiler Error C2834
 
-'operator operator' must be globally qualified
+> 'operator *operator-name*' must be globally qualified
 
 The `new` and `delete` operators are tied to the class where they reside. Scope resolution cannot be used to select a version of `new` or `delete` from a different class. To implement multiple forms of the `new` or `delete` operator, create a version of the operator with extra formal parameters.
+
+This error is obsolete in Visual Studio 2022 and later versions.

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

@@ -1,13 +1,15 @@
 ---
 description: "Learn more about: Compiler Error C2858"
 title: "Compiler Error C2858"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2858"]
 helpviewer_keywords: ["C2858"]
 ms.assetid: 1fb1d770-307e-476e-9984-a1d8f8ce2820
 ---
 # Compiler Error C2858
 
-command-line option '/Yc (/Fdfilename)' inconsistent with precompiled header, which used '/Fdfilename'
+> command-line option '/Yc (/Fd*filename1*)' inconsistent with precompiled header, which used '/Fd*filename2*'
 
-The program database specified by the Use Precompiled Header ([/Yu](../../build/reference/yu-use-precompiled-header-file.md)) option is not the one specified by the previous Create Precompiled Header ([/Yc](../../build/reference/yc-create-precompiled-header-file.md)) option.
+The program database specified by the Use Precompiled Header ([`/Yu`](../../build/reference/yu-use-precompiled-header-file.md)) option is not the one specified by the previous Create Precompiled Header ([`/Yc`](../../build/reference/yc-create-precompiled-header-file.md)) option.
+
+This error is obsolete in Visual Studio 2022 and later versions.

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

@@ -8,10 +8,12 @@ ms.assetid: d589fc0c-08b2-4a79-bc0e-dca5eb80bdd5
 ---
 # Compiler Error C2875
 
-using-declaration causes a multiple declaration of 'class::identifier'
+> using-declaration causes a multiple declaration of 'class::identifier'
 
 The declaration causes the same item to be defined twice.
 
+This error is obsolete in Visual Studio 2022 and later versions.
+
 The following sample generates C2875:
 
 ```cpp

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

@@ -1,16 +1,18 @@
 ---
 description: "Learn more about: Compiler Error C2896"
 title: "Compiler Error C2896"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2896"]
 helpviewer_keywords: ["C2896"]
 ms.assetid: b600407b-cb05-42e3-9069-2aa6960f0eaa
 ---
 # Compiler Error C2896
 
-'function1' : cannot use function template 'function2' as argument
+> '*function1*' : cannot use function template '*function2*' as argument
 
-A function template cannot be an argument to another function template.
+A function template can't be an argument to another function template.
+
+This error is obsolete in Visual Studio 2022 and later versions.
 
 The following sample generates C2896:
 

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

@@ -1,17 +1,19 @@
 ---
 description: "Learn more about: Compiler Error C2902"
 title: "Compiler Error C2902"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2902"]
 helpviewer_keywords: ["C2902"]
 ms.assetid: 89d78d0e-78e5-4c2c-a0f9-a60110e9395e
 ---
 # Compiler Error C2902
 
-'token' : unexpected token following 'template', identifier expected
+> '*token*' : unexpected token following '*template*', identifier expected
 
 The token following the keyword **`template`** was not an identifier.
 
+This error is obsolete in Visual Studio 2022 and later versions.
+
 The following sample generates C2902:
 
 ```cpp

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

@@ -1,16 +1,20 @@
 ---
 description: "Learn more about: Compiler Error C2917"
 title: "Compiler Error C2917"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2917"]
 helpviewer_keywords: ["C2917"]
 ms.assetid: ec9da9ee-0f37-47b3-87dd-19ef5a14dc4c
 ---
 # Compiler Error C2917
 
-'name' : invalid template-parameter
+> '*name*' : invalid template-parameter
 
-A template parameter list contains an identifier that was not a template parameter.
+## Remarks
+
+A template parameter list contains an identifier that wasn't a template parameter.
+
+This error is obsolete in Visual Studio 2022 and later versions.
 
 ## Example
 

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

@@ -1,16 +1,18 @@
 ---
 description: "Learn more about: Compiler Error C2931"
 title: "Compiler Error C2931"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2931"]
 helpviewer_keywords: ["C2931"]
 ms.assetid: 33430407-b149-4ba3-baf8-b0dae1ea3a5d
 ---
 # Compiler Error C2931
 
-'class' : type-class-id redefined as a member function of 'identifier'
+'*class*' : type-class-id redefined as a member function of '*identifier*'
 
-You cannot use a generic or template class as a member function of another class.
+You can't use a generic or template class as a member function of another class.
+
+This error is obsolete in Visual Studio 2022 and later versions.
 
 This error can be caused if braces are improperly matched.
 

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

@@ -8,9 +8,11 @@ ms.assetid: c28e88d9-e654-4367-bfb4-13c780bca9bd
 ---
 # Compiler Error C2932
 
-'class' : type-class-id redefined as a data member of 'identifier'
+> '*class*' : type-class-id redefined as a data member of '*identifier*'
 
-You cannot use a generic or template class as a data member.
+You can't use a generic or template class as a data member.
+
+This error is obsolete in Visual Studio 2022 and later versions.
 
 The following sample generates C2932:
 

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

@@ -1,16 +1,18 @@
 ---
 description: "Learn more about: Compiler Error C2933"
 title: "Compiler Error C2933"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2933"]
 helpviewer_keywords: ["C2933"]
 ms.assetid: 394891e3-6b52-4b61-83d2-a1c5125d9bd5
 ---
 # Compiler Error C2933
 
-'class' : type-class-id redefined as a typedef member of 'identifier'
+> '*class*' : type-class-id redefined as a typedef member of '*identifier*'
 
-You cannot use a generic or template class as a **`typedef`** member.
+You can't use a generic or template class as a **`typedef`** member.
+
+This error is obsolete in Visual Studio 2022 and later versions.
 
 The following sample generates C2933:
 

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

@@ -1,13 +1,15 @@
 ---
 description: "Learn more about: Compiler Error C2934"
 title: "Compiler Error C2934"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2934"]
 helpviewer_keywords: ["C2934"]
 ms.assetid: b7f7e7aa-2d4c-4e17-8564-2c005ab81fd5
 ---
 # Compiler Error C2934
 
-'class' : type-class-id redefined as a nested 'item' of 'identifier'
+'*class*' : type-class-id redefined as a nested 'item' of '*identifier*'
 
-You cannot use a generic or template class as a nested item.
+You can't use a generic or template class as a nested item.
+
+This error is obsolete in Visual Studio 2022 and later versions.

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

@@ -1,16 +1,18 @@
 ---
 description: "Learn more about: Compiler Error C2935"
 title: "Compiler Error C2935"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2935"]
 helpviewer_keywords: ["C2935"]
 ms.assetid: e11ef90d-0756-4e43-8a09-4974c6aa72a3
 ---
 # Compiler Error C2935
 
-'class' : type-class-id redefined as a global function
+> '*class*' : type-class-id redefined as a global function
 
-You cannot use a generic or template class as a global function.
+You can't use a generic or template class as a global function.
+
+This error is obsolete in Visual Studio 2022 and later versions.
 
 This error can be caused if braces are improperly matched.
 

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

@@ -1,16 +1,18 @@
 ---
 description: "Learn more about: Compiler Error C2936"
 title: "Compiler Error C2936"
-ms.date: "11/04/2016"
+ms.date: 06/01/2022
 f1_keywords: ["C2936"]
 helpviewer_keywords: ["C2936"]
 ms.assetid: 5d1ba0fc-0c78-4a37-a83b-1ef8527763be
 ---
 # Compiler Error C2936
 
-'class' : type-class-id redefined as a global data variable
+> '*class*' : type-class-id redefined as a global data variable
 
-You cannot use a generic or template class as a global data variable.
+You can't use a generic or template class as a global data variable.
+
+This error is obsolete in Visual Studio 2022 and later versions.
 
 This error can be caused if braces are improperly matched.