Merge branch 'main' into patch-13

Author: TylerMSFT

.openpublishing.build.ps1

@@ -1,5 +1,10 @@
 {
   "redirections": [
+    {
+      "source_path": "docs/windows/desktop-applications-visual-cpp.md",
+      "redirect_url": "/cpp/windows/overview-of-windows-programming-in-cpp",
+      "redirect_document_id": true
+    },
     {
       "source_path": "docs/cpp-conformance-improvements-2017.md",
       "redirect_url": "/cpp/overview/cpp-conformance-improvements",
@@ -7745,6 +7750,21 @@
       "redirect_url": "/cpp/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599",
       "redirect_document_id": false
     },
+    {
+      "source_path": "docs/error-messages/compiler-errors-1/fatal-error-c999.md",
+      "redirect_url": "/cpp/error-messages/compiler-errors-1/c-cpp-build-errors",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/error-messages/compiler-errors-1/fatal-error-c1000-c1999.md",
+      "redirect_url": "/cpp/error-messages/compiler-errors-1/c-cpp-build-errors",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/error-messages/compiler-warnings/compiler-warning-level-1-c4999.md",
+      "redirect_url": "/cpp/error-messages/compiler-errors-1/c-cpp-build-errors",
+      "redirect_document_id": false
+    },
     {
       "source_path": "docs/error-messages/compiler-warnings/index.md",
       "redirect_url": "/cpp/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199",

.openpublishing.redirection.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://whatsnewapi.azurewebsites.net/schema",
+  "$schema": "https://github.com/dotnet/docs-tools/blob/main/WhatsNew.Infrastructure/Configuration/reposettings.schema.json",
   "docSetProductName": "C++, C, and Assembler",
   "rootDirectory": "docs/",
   "docLinkSettings": {
@@ -10,7 +10,8 @@
     "minAdditionsToFile": 2,
     "pullRequestTitlesToIgnore": [
       "^Confirm merge from FromPublicMasterBranch",
-      "^Repo sync for protected CLA branch"
+      "^Repo sync for protected CLA branch",
+      "^Repo sync for protected branch"
     ],
     "omitPullRequestTitles": false
   },

.whatsnew.json

@@ -2,7 +2,7 @@
 
 ## Security
 
-Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, such as [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), and [our GitHub organizations](https://opensource.microsoft.com/).
 
 If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.
 

SECURITY.md

@@ -2,7 +2,6 @@
 title: "ARM Assembler command-line reference"
 description: "Reference guide to the Microsoft ARM assembler command-line options."
 ms.date: 05/09/2022
-ms.assetid: f7b89478-1ab5-4995-8cde-a805f0462c45
 ---
 # ARM Assembler command-line reference
 
@@ -98,7 +97,7 @@ A combination of zero or more of the following options:
   For more information, see the [ARM Compiler armasm Reference Guide](https://developer.arm.com/documentation/dui0802/latest/).
 
 - **`-sourcelink:`** *sourcelink_filename*\
-  *sourcelink_filename* specifies a JSON-formatted configuration file that contains a simple mapping of local file paths to URLs for source files to display in the debugger. For more information on the format of this file, see [Source Link JSON Schema](https://github.com/dotnet/designs/blob/master/accepted/2020/diagnostics/source-link.md#source-link-json-schema). Source Link is a language- and source-control agnostic system for providing source debugging for binaries. Source Link is supported for native binaries starting in Visual Studio 2017 version 15.8. For an overview of Source Link, see [Source Link](https://github.com/dotnet/designs/blob/master/accepted/2020/diagnostics/source-link.md). For information on how to use Source Link in your projects, and how to generate the SourceLink file as part of your project, see [Using Source Link](https://github.com/dotnet/sourcelink#using-source-link-in-c-projects).
+  *sourcelink_filename* specifies a JSON-formatted configuration file that contains a simple mapping of local file paths to URLs for source files to display in the debugger. For more information on the format of this file, see [Source Link JSON Schema](https://github.com/dotnet/designs/blob/main/accepted/2020/diagnostics/source-link.md#source-link-json-schema). Source Link is a language- and source-control agnostic system for providing source debugging for binaries. Source Link is supported for native binaries starting in Visual Studio 2017 version 15.8. For an overview of Source Link, see [Source Link](https://github.com/dotnet/designs/blob/main/accepted/2020/diagnostics/source-link.md). For information on how to use Source Link in your projects, and how to generate the SourceLink file as part of your project, see [Using Source Link](https://github.com/dotnet/sourcelink#using-source-link-in-c-projects).
 
 - **`-via`** *filename*\
   Read extra command-line arguments from *filename*.

docs/assembler/arm/arm-assembler-command-line-reference.md

@@ -8,7 +8,9 @@ ms.assetid: 2b8c882c-c0d2-4fa3-8335-e6b12717a4f4
 ---
 # .CODE
 
-(32-bit MASM only.) When used with [.MODEL](dot-model.md), indicates the start of a code segment.
+Indicates the start of a code segment.
+
+When using 32-bit MASM, this should be used along with [.MODEL](dot-model.md).
 
 ## Syntax
 

docs/assembler/masm/dot-code.md

@@ -8,7 +8,9 @@ ms.assetid: 32797935-9c79-46e0-bf6f-07d0c2bf1dc1
 ---
 # .DATA
 
- (32-bit MASM only.) When used with [.MODEL](dot-model.md), starts a near data segment for initialized data (segment name _DATA).
+Indicates the start of a data segment.
+
+When using 32-bit MASM, this starts a near data segment for initialized data (segment name _DATA) and should be used along with [.MODEL](dot-model.md).
 
 ## Syntax
 

docs/assembler/masm/dot-data.md

@@ -1,10 +1,9 @@
 ---
-description: "Learn more about: .NOLISTIF"
 title: ".NOLISTIF"
+description: "Learn more about: .NOLISTIF"
 ms.date: "12/16/2019"
 f1_keywords: [".NOLISTIF"]
 helpviewer_keywords: [".NOLISTIF directive"]
-ms.assetid: 9243af7a-7221-4531-bbc3-281b6b292bfd
 ---
 # .NOLISTIF
 
@@ -20,5 +19,5 @@ This is the default. Same as [.SFCOND](dot-sfcond.md).
 
 ## See also
 
-[Directives reference](directives-reference.md)
+[Directives reference](directives-reference.md)\
 [MASM BNF Grammar](masm-bnf-grammar.md)

docs/assembler/masm/dot-nolistif.md

@@ -1,9 +1,8 @@
 ---
-description: "Learn more about: EXTERN"
+description: "Learn more about the MASM directive: EXTERN"
 title: "EXTERN (MASM)"
-ms.date: "12/06/2019"
+ms.date: 1/10/2025
 helpviewer_keywords: ["EXTERN directive"]
-ms.assetid: 667d703d-3aaf-4139-a586-29bc5dab1aff
 ---
 # EXTERN
 
@@ -17,7 +16,9 @@ Defines one or more external variables, labels, or symbols called *name* whose t
 
 The *language-type* argument is valid in 32-bit MASM only.
 
-The *type* can be [ABS](operator-abs.md), which imports *name* as a constant. Same as [EXTRN](extrn.md).
+The *type* can be [`ABS`](operator-abs.md), which imports *name* as a constant. Same as [`EXTRN`](extrn.md).
+
+The *type* can also be [`PROC`](proc.md), in which case *name* is treated as an external procedure.
 
 ## See also
 

docs/assembler/masm/extern-masm.md

@@ -6,11 +6,11 @@ helpviewer_keywords: ["MASM (Microsoft Macro Assembler), reference", "MASM (Micr
 ---
 # Microsoft Macro Assembler reference
 
-The Microsoft Macro Assembler (MASM) provides several advantages over inline assembly. MASM contains a macro language that has features such as looping, arithmetic, and text string processing. MASM gives you greater control over the hardware. By using MASM, you also can reduce time and memory overhead in your code.
+The Microsoft Macro Assembler (MASM) provides several advantages over inline assembly. MASM contains a macro language that has features such as looping, arithmetic, and string processing. MASM gives you greater control over the hardware. By using MASM, you also can reduce time and memory overhead in your code.
 
 ## In This Section
 
-[ML and ML64 command-line option](ml-and-ml64-command-line-reference.md)\
+[ML and ML64 command-line options](ml-and-ml64-command-line-reference.md)\
 Describes the ML and ML64 command-line options.
 
 [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md)\
@@ -34,8 +34,7 @@ Describes fatal and nonfatal error messages and warnings.
 [Processor Manufacturer Programming Manuals](processor-manufacturer-programming-manuals.md)\
 Provides links to programming information about processors not manufactured, sold, or supported by Microsoft.
 
-[MASM BNF Grammar](masm-bnf-grammar.md)
-
+[MASM BNF Grammar](masm-bnf-grammar.md)\
 Formal BNF description of MASM for x64.
 
 ## Related Sections