Merge pull request #5832 from MicrosoftDocs/FromPublicMasterBranch

Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main)

Author: Albertyang0

docs/assembler/masm/dot-code.md

@@ -1,10 +1,9 @@
 ---
-description: "Learn more about: .CODE"
 title: ".CODE"
+description: "Learn more about: .CODE"
 ms.date: "12/17/2019"
 f1_keywords: [".CODE"]
 helpviewer_keywords: [".CODE directive"]
-ms.assetid: 2b8c882c-c0d2-4fa3-8335-e6b12717a4f4
 ---
 # .CODE
 
@@ -16,7 +15,7 @@ When using 32-bit MASM, this should be used along with [.MODEL](dot-model.md).
 
 > **.CODE** ⟦*name*⟧\
 > ⟦ *segmentItem* ⟧...\
-> ⟦ *codesegmentnameId* **ENDS**;;⟧\
+> ⟦ *codesegmentnameId* **ENDS**;;⟧
 
 ### Parameters
 

docs/build/reference/arch-arm64.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: /arch (ARM64)"
 title: "/arch (ARM64)"
+description: "Learn more about: /arch (ARM64)"
 ms.date: 05/24/2024
 ---
 # `/arch` (ARM64)
@@ -27,7 +27,7 @@ You can specify an ARM64 extension from Armv8.0-A through Armv8.9-A, and Armv9.0
 > [!NOTE]
 > Depending on your version of Visual Studio, the compiler may not yet generate instructions from all feature sets required by the extension level you specify. For example, **`/arch:armv8.1`** allows the `*Interlocked*` intrinsic functions to use the appropriate atomic instruction introduced with the Armv8.1-A extension feature `FEAT_LSE`, but compiler support requires Visual Studio 2022 version 17.2 or later.
 
-The `_M_ARM64` macro is defined by default when compiling for an ARM64 target. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md)\
+The `_M_ARM64` macro is defined by default when compiling for an ARM64 target. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md).
 
 The `__ARM_ARCH` macro is defined for `/arch:ARMv8.0` and higher. It indicates the ARM architecture extension level that the compiler is targeting. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md).
 

docs/build/reference/genprofile-fastgenprofile-generate-profiling-instrumented-build.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: /GENPROFILE, /FASTGENPROFILE (Generate Profiling Instrumented Build)"
 title: "/GENPROFILE, /FASTGENPROFILE (Generate Profiling Instrumented Build)"
+description: "Learn more about: /GENPROFILE, /FASTGENPROFILE (Generate Profiling Instrumented Build)"
 ms.date: 04/14/2021
 f1_keywords: ["GENPROFILE", "FASTGENPROFILE", "/GENPROFILE", "/FASTGENPROFILE"]
 helpviewer_keywords: ["GENPROFILE", "FASTGENPROFILE"]
@@ -12,7 +12,7 @@ Specifies generation of a *`.pgd`* file by the linker to support profile-guided
 ## Syntax
 
 > **`/GENPROFILE`**\[**`:`**_`profile-argument`_\[**`,`**_`profile-argument`_ ...]]\
-> **`/FASTGENPROFILE`**\[**`:`**_`profile-argument`_\[**`,`**_`profile-argument`_ ...]]\
+> **`/FASTGENPROFILE`**\[**`:`**_`profile-argument`_\[**`,`**_`profile-argument`_ ...]]
 
 > *`profile-argument`*\
 >  { **`COUNTER32`** | **`COUNTER64`** }\

docs/build/reference/zc-tlsguards.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about the /Zc:tlsGuards (Check TLS initialization) compiler option."
 title: "/Zc:tlsGuards (Check TLS initialization)"
+description: "Learn more about the /Zc:tlsGuards (Check TLS initialization) compiler option."
 ms.date: 11/08/2022
 f1_keywords: ["/Zc:tlsGuards"]
 helpviewer_keywords: ["-Zc:tlsGuards compiler option (C++)", "/Zc:tlsGuards compiler option (C++)"]
@@ -29,4 +29,4 @@ The **`/Zc:tlsGuards`** option is new in Visual Studio 2019 version 16.5. This o
 
 ## See also
 
-[`/Zc` (Conformance)](zc-conformance.md)\
+[`/Zc` (Conformance)](zc-conformance.md)

docs/c-runtime-library/reference/floating-point-ordering.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered"
 title: "isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered"
+description: "Learn more about: isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered"
 ms.date: "01/31/2019"
 f1_keywords: ["isgreater", "math/isgreater", "isgreaterequal", "math/isgreaterequal", "isless", "math/isless", "islessequal", "math/islessequal", "islessgreater", "math/islessgreater", "isunordered", "math/isunordered"]
 helpviewer_keywords: ["isgreater function", "isgreaterequal function", "isless function", "islessequal function", "islessgreater function", "isunordered function"]
@@ -43,7 +43,7 @@ int isunordered(
 ); /* C-only macro */
 ```
 
-```C++
+```cpp
 template <class FloatingType1, class FloatingType2>
 inline bool isgreater(
    FloatingType1 x,

docs/c-runtime-library/reference/log-logf-log10-log10f.md

@@ -122,9 +122,9 @@ Log base 2 of 65536.000000 is 16.000000
 
 ## See also
 
-[Math and floating-point support](../floating-point-support.md) \
-[`exp`, `expf`, `expl`](exp-expf.md) \
-[`_matherr`](matherr.md) \
-[`pow`, `powf`, `powl`](pow-powf-powl.md) \
-[`_CIlog`](../cilog.md) \
-[`_CIlog10`](../cilog10.md)\
+[Math and floating-point support](../floating-point-support.md)\
+[`exp`, `expf`, `expl`](exp-expf.md)\
+[`_matherr`](matherr.md)\
+[`pow`, `powf`, `powl`](pow-powf-powl.md)\
+[`_CIlog`](../cilog.md)\
+[`_CIlog10`](../cilog10.md)

docs/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: strrchr, wcsrchr, _mbsrchr, _mbsrchr_l"
 title: "strrchr, wcsrchr, _mbsrchr, _mbsrchr_l"
+description: "Learn more about: strrchr, wcsrchr, _mbsrchr, _mbsrchr_l"
 ms.date: "4/2/2020"
 api_name: ["strrchr", "wcsrchr", "_mbsrchr", "_mbsrchr_l", "_o__mbsrchr", "_o__mbsrchr_l"]
 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ntdll.dll", "ucrtbase.dll", "api-ms-win-crt-multibyte-l1-1-0.dll", "ntoskrnl.exe"]
@@ -131,4 +131,4 @@ For an example of using **`strrchr`**, see [`strchr`](strchr-wcschr-mbschr-mbsch
 [`strcspn`, `wcscspn`, `_mbscspn`, `_mbscspn_l`](strcspn-wcscspn-mbscspn-mbscspn-l.md)\
 [`_strnicmp`, `_wcsnicmp`, `_mbsnicmp`, `_strnicmp_l`, `_wcsnicmp_l`, `_mbsnicmp_l`](strnicmp-wcsnicmp-mbsnicmp-strnicmp-l-wcsnicmp-l-mbsnicmp-l.md)\
 [`strpbrk`, `wcspbrk`, `_mbspbrk`, `_mbspbrk_l`](strpbrk-wcspbrk-mbspbrk-mbspbrk-l.md)\
-[`strspn`, `wcsspn`, `_mbsspn`, `_mbsspn_l`](strspn-wcsspn-mbsspn-mbsspn-l.md)\
+[`strspn`, `wcsspn`, `_mbsspn`, `_mbsspn_l`](strspn-wcsspn-mbsspn-mbsspn-l.md)

docs/code-quality/c28196.md

@@ -1,10 +1,9 @@
 ---
-description: "Learn more about: Warning C28196"
 title: Warning C28196
+description: "Learn more about: Warning C28196"
 ms.date: 11/04/2016
 f1_keywords: ["C28196", "RETURNING_BAD_RESULT", "__WARNING_RETURNING_BAD_RESULT"]
 helpviewer_keywords: ["C28196"]
-ms.assetid: 5ee89e96-2796-4316-a64c-702463ca1374
 ---
 # Warning C28196
 
@@ -51,4 +50,4 @@ Item *get_item(_In_reads_(len) Item *items, size_t len, size_t index) {
 ## See also
 
 [Annotating function parameters and return values](./annotating-function-parameters-and-return-values.md)\
-[Specifying When and Where an Annotation Applies](./specifying-when-and-where-an-annotation-applies.md)\
+[Specifying When and Where an Annotation Applies](./specifying-when-and-where-an-annotation-applies.md)

docs/cpp/com-ptr-t-extractors.md

@@ -4,7 +4,6 @@ description: "Describes the extraction operators for the _com_ptr_t class."
 ms.date: 07/07/2020
 f1_keywords: ["_com_ptr_t::operatorInterface&", "_com_ptr_t::operatorbool", "_com_ptr_t::operator->", "_com_ptr_t::operator*"]
 helpviewer_keywords: ["operator Interface& [C++]", "* operator [C++], with specific objects", "operator& [C++]", "operator* [C++]", "-> operator [C++], with specific objects", "& operator [C++], with specific objects", "operator Interface* [C++]", "operator * [C++]", "operator->", "operator bool", "extractors, _com_ptr_t class", "extractors [C++]"]
-ms.assetid: 194b9e0e-123c-49ff-a187-0a7fcd68145a
 ---
 # `_com_ptr_t` Extractors
 
@@ -14,7 +13,7 @@ Extract the encapsulated COM interface pointer.
 
 ## Syntax
 
-```c++
+```cpp
 operator Interface*( ) const throw( );
 operator Interface&( ) const;
 Interface& operator*( ) const;

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

@@ -1,23 +1,25 @@
 ---
-description: "Learn more about: Compiler Error C2640"
 title: "Compiler Error C2640"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2640"
+ms.date: "03/17/2025"
 f1_keywords: ["C2640"]
 helpviewer_keywords: ["C2640"]
-ms.assetid: e4d137ab-ed1d-457c-9eec-b70d97f1b0b4
 ---
 # Compiler Error C2640
 
-'identifier' : __based modifier illegal on reference
+> 'abstract declarator': __based modifier illegal on reference
 
-The **`__based`** modifier can be used on pointers only.
+The [**`__based`**](../../cpp/based-pointers-cpp.md) modifier can be used on pointers only.
 
 The following sample generates C2640:
 
 ```cpp
 // C2640.cpp
-void f(int i) {
-    void *vp;
-    int _based(vp) &vr = I;  // C2640
+int* ptr;
+
+int main()
+{
+    int __based(ptr)& based_ref;   // C2640
+    int __based(ptr)* based_ptr;   // OK
 }
 ```