Skip to content

Commit fa34ae0

Browse files
Taojunshencolin-homeopbld16opbld15opbld17
authored
8/31/2022 AM Publish (#4496)
* crtsetdbgflag.md: _CrtCheckMemory is not called by default * Visual C++ 17.0 has unlimited string literals * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4430) * 7/19/2022 AM Publish (#4424) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/20/2022 AM Publish (#4426) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/21/2022 AM Publish (#4427) * Follow up 4221 Acrolinx score for TN035 * Fix heading style * Update C++-specific template info * Fix links to raw and rendered markdown Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * crtsetdbgflag.md: _CrtCheckMemory is not called by default Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Taojunshen <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> * wordsmith * clarify wording * wording * Update .openpublishing.publish.config.json * Repo sync for protected CLA branch (#4061) * add initial doc stubs * Initial docs push, contains stubs for some files and a stub for a landing page * update some links * add more cards and links to the Hub page * fix error * remove monikor's so it's easy to test, fix rtos-view.md path * fix link * add more to the sidebar * update peripheral view by consolidating to the table, change things to objects in rtos-view * add tabs * forgot to end tabbed section * fix items after adding tabs * update h1 * slightly fix some wording * add link from C++ and C workloads, features, and libraries to embedded hub * move into own directory so that the url is better * fix some warnings * remove next steps that pointed to linux items * prefer tabbed view vs table * attempt to add moniker * attempt highest moniker in range * assign to a specific version * push again to get new build * add '=' sign to try and test it * add metadata for msvc-170 * add moniker range for index.yml * remove inline moniker since we only need it on the files themselves * Follow up 4221 Acrolinx score for TN035 * Fix heading style * Update C++-specific template info * Fix links to raw and rendered markdown * Edit pass for house style * add 'while debugging' for peripheral-view * Fix table issue, stray punctuation Co-authored-by: Garrett Campbell <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: Alma Jenks <[email protected]> * Update ios-functions.md fix typo (#4071) showps→showpos * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4442) * 7/27/2022 AM Publish (#4432) * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4430) * 7/19/2022 AM Publish (#4424) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/20/2022 AM Publish (#4426) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/21/2022 AM Publish (#4427) * Follow up 4221 Acrolinx score for TN035 * Fix heading style * Update C++-specific template info * Fix links to raw and rendered markdown Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * crtsetdbgflag.md: _CrtCheckMemory is not called by default Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Taojunshen <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> * wordsmith * clarify wording * wording Co-authored-by: Feng Xu <[email protected]> Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: PRMerger20 <[email protected]> * 7/28/2022 AM Publish (#4437) * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4430) * 7/19/2022 AM Publish (#4424) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/20/2022 AM Publish (#4426) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/21/2022 AM Publish (#4427) * Follow up 4221 Acrolinx score for TN035 * Fix heading style * Update C++-specific template info * Fix links to raw and rendered markdown Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * crtsetdbgflag.md: _CrtCheckMemory is not called by default Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Taojunshen <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> * wordsmith * clarify wording * wording Co-authored-by: Feng Xu <[email protected]> Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: PRMerger20 <[email protected]> * 7/29/2022 AM Publish (#4441) * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4430) * 7/19/2022 AM Publish (#4424) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/20/2022 AM Publish (#4426) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/21/2022 AM Publish (#4427) * Follow up 4221 Acrolinx score for TN035 * Fix heading style * Update C++-specific template info * Fix links to raw and rendered markdown Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * crtsetdbgflag.md: _CrtCheckMemory is not called by default Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Taojunshen <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> * wordsmith * clarify wording * wording Co-authored-by: Feng Xu <[email protected]> Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: PRMerger20 <[email protected]> Co-authored-by: Alma Jenks <[email protected]> Co-authored-by: Taojunshen <[email protected]> Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: PRMerger20 <[email protected]> * Address cpp-docs 4075 __assume issues * Address cpp-docs 4072 clarity issue * update date * Update multithreading-and-locales.md Wrong `setlocale()` reference, it should be a C runtime function, not a preprocessor macro. * Update for consistent branding. * Update peripheral view docs (#4444) * 7/27/2022 AM Publish (#4432) * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4430) * 7/19/2022 AM Publish (#4424) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/20/2022 AM Publish (#4426) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/21/2022 AM Publish (#4427) * Follow up 4221 Acrolinx score for TN035 * Fix heading style * Update C++-specific template info * Fix links to raw and rendered markdown Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * crtsetdbgflag.md: _CrtCheckMemory is not called by default Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Taojunshen <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> * wordsmith * clarify wording * wording Co-authored-by: Feng Xu <[email protected]> Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: PRMerger20 <[email protected]> * 7/28/2022 AM Publish (#4437) * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4430) * 7/19/2022 AM Publish (#4424) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/20/2022 AM Publish (#4426) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/21/2022 AM Publish (#4427) * Follow up 4221 Acrolinx score for TN035 * Fix heading style * Update C++-specific template info * Fix links to raw and rendered markdown Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * crtsetdbgflag.md: _CrtCheckMemory is not called by default Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Taojunshen <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> * wordsmith * clarify wording * wording Co-authored-by: Feng Xu <[email protected]> Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: PRMerger20 <[email protected]> * 7/29/2022 AM Publish (#4441) * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4430) * 7/19/2022 AM Publish (#4424) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/20/2022 AM Publish (#4426) * Follow up 4221 Acrolinx score for TN035 * Fix heading style Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * 7/21/2022 AM Publish (#4427) * Follow up 4221 Acrolinx score for TN035 * Fix heading style * Update C++-specific template info * Fix links to raw and rendered markdown Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> * crtsetdbgflag.md: _CrtCheckMemory is not called by default Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Taojunshen <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> * wordsmith * clarify wording * wording Co-authored-by: Feng Xu <[email protected]> Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: PRMerger20 <[email protected]> * add search/filter capability to peripheral view docs * add last column bar * Fixing alt-text Co-authored-by: Alma Jenks <[email protected]> Co-authored-by: Taojunshen <[email protected]> Co-authored-by: Feng Xu <[email protected]> Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: PRMerger20 <[email protected]> Co-authored-by: Regan Downer <[email protected]> * Update the ARM64EC-related predefined macros * Update modules tutorial style * Updates for v17.3 * fix copypasta error * Fix dates * Add suggested fixes to corouptines warning * fix uppercase letter fix uppercase letter * fix github #4089 * acrolinx * wording change (#4467) Co-authored-by: TylerMSFT <[email protected]> * fix: ordered list #4055 * Describe why we add (STL) to the C++ Standard Library name (#4469) * wording change * address github 4092 * some acrolinx * update wording * a little more wordsmithing * fix github #4096 and follow up on PR feedback * acrolinx * pr feedback * fix line spacing * line spacing * really fixing line spacing... Co-authored-by: TylerMSFT <[email protected]> * Update link to LibFuzzer documentation Old link was to an ancient LLVM version which said that Windows wasn't supported * add naming note * style update * explain what the freestanding library is * Update Fatal Errors for VS2022 * Split up message text by source * wordsmith * typo * try table * try 3 columns * headers * headings * update headers * update headings * try to nullify warning * Split C999 from C1000, C1999, format table * Fixed inconsistent spelling of "newline" "newline" was spelled as "new-line" two out of four times in the document. * Missing error articles C2000-C2099 * Respelled "newline" as "new-line" * C26472 doc: gsl:narrow throws rather than crashes * Update intrinsic.md Remove extra '\' in the last row of tables, which actually show up in the doc. * C26475 doc: gsl:narrow throws rather than crashes * C26472 doc: Update style * draft to address github #4107 * acrolinx * fix broken link * typo * fix stray code markers * tech review * make params match old doc style * more fiddling with the wording * Remaining error articles in group * Remove redundant F1 tags * review feedbck * Update to address cpp-docs 4117 (#4485) * Update to address cpp-docs 4117 * Fix a typo. * Updated C6248 (#4436) * Updated C6248 Matched wording and format to my other PRs * Updated C6248 Used contractions per Acrolinx's mandate * Updated C6248 Using new formatting as discussed with Colin. Added PREfast name for warning. * Update docs/code-quality/c6248.md Co-authored-by: Michael Squires <[email protected]> * Updated C6248 Changed the ms.date and PREfast->code analysis Co-authored-by: Michael Squires <[email protected]> * Address cpp-docs issue 4097 (#4486) * [BULK UPDATE] DocuTune - Fix build validation issues: docs-link-absolute * [BULK UPDATE] DocuTune - Fix build validation issues: docs-link-absolute * [BULK UPDATE] DocuTune - Fix build validation issues: docs-link-absolute * Update CONTRIBUTING.md * Update CONTRIBUTING.md * Fix name of main branch * Address 4125, 4119, 4102, and features in 17.2 (#4495) * Address 4125 4119 4102 17.2 issues * Acrolinx fixes * Add more intrinsics for 17.2 Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: Oliver Old <[email protected]> Co-authored-by: Igor Zhukov <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: Feng Xu <[email protected]> Co-authored-by: JiayueHu <[email protected]> Co-authored-by: Bryan Gold <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: PRMerger20 <[email protected]> Co-authored-by: irushx <[email protected]> Co-authored-by: Garrett Campbell <[email protected]> Co-authored-by: Alma Jenks <[email protected]> Co-authored-by: pea-sys <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: Anton <[email protected]> Co-authored-by: Garrett Campbell <[email protected]> Co-authored-by: Regan Downer <[email protected]> Co-authored-by: Ben Niu <[email protected]> Co-authored-by: PRMerger19 <[email protected]> Co-authored-by: PRMerger4 <[email protected]> Co-authored-by: PRMerger Service account 2 <[email protected]> Co-authored-by: Gabor Horvath <[email protected]> Co-authored-by: Diana Richards <[email protected]> Co-authored-by: 薄景仁 <[email protected]> Co-authored-by: Linda Spiller <[email protected]> Co-authored-by: AugusMeow <[email protected]> Co-authored-by: Sy Brand <[email protected]> Co-authored-by: Dennis Rea <[email protected]> Co-authored-by: Weiju Wang <[email protected]> Co-authored-by: Bartosz Brachaczek <[email protected]> Co-authored-by: Bartosz Brachaczek <[email protected]> Co-authored-by: Stacyrch140 <[email protected]> Co-authored-by: Samuel Berger <[email protected]> Co-authored-by: Michael Squires <[email protected]> Co-authored-by: Alex Buck <[email protected]> Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com> Co-authored-by: Tamara K <[email protected]>
1 parent 88af168 commit fa34ae0

14 files changed

+124
-70
lines changed

docs/build/reference/arch-arm64.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,26 @@
11
---
22
description: "Learn more about: /arch (ARM64)"
33
title: "/arch (ARM64)"
4-
ms.date: 06/30/2022
4+
ms.date: 08/30/2022
55
---
66
# `/arch` (ARM64)
77

88
Specifies the architecture for code generation on ARM64. For more information on **`/arch`** for other target architectures, see [`/arch` (x86)](arch-x86.md), [`/arch` (x64)](arch-x64.md), and [`/arch` (ARM)](arch-arm.md).
99

1010
## Syntax
1111

12-
> **`/arch:`**\[**`armv8.0`**|**`armv8.8`**]
12+
> **`/arch:`**\[**`armv8.0`**-**`armv8.8`**]
1313
1414
## Arguments
1515

16-
**`/arch:armv8.0`** or **`/arch:armv8.8`**\
16+
**`/arch:armv8.0`** through **`/arch:armv8.8`**\
1717
Optional. Specifies minimum CPU extension requirements for ARMv8.x-A. The default is **`/arch:armv8.0`**.
1818

1919
## Remarks
2020

21-
The `_M_ARM64` macro is defined by default when compiling for an ARM64 target. For more information, see [Predefined Macros](../../preprocessor/predefined-macros.md).
21+
You may specify a CPU extension requirement from Armv8.0-A through Armv8.8-A. However, 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 that was introduced with the ARMv8.1 extension, FEAT_LSE, but compiler support requires Visual Studio 2022 version 17.2 or later.
22+
23+
The `_M_ARM64` macro is defined by default when compiling for an ARM64 target. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md).
2224

2325
When you use [`/clr`](clr-common-language-runtime-compilation.md) to compile, **`/arch`** has no effect on code generation for managed functions. **`/arch`** only affects code generation for native functions.
2426

@@ -28,7 +30,7 @@ When you use [`/clr`](clr-common-language-runtime-compilation.md) to compile, **
2830

2931
1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page.
3032

31-
1. In the **Additional options** box, add *`/arch:armv8.0`* or *`/arch:armv8.8`*. Choose **OK** to save your changes.
33+
1. In the **Additional options** box, add *`/arch:armv8.0`* or higher. Choose **OK** to save your changes.
3234

3335
### To set this compiler option programmatically
3436

Lines changed: 23 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,40 @@
11
---
2-
description: "Learn more about: /FR, /Fr (Create .Sbr File)"
3-
title: "/FR, /Fr (Create .Sbr File)"
4-
ms.date: "11/04/2016"
2+
description: "Learn more about: /FR, /Fr (Name SBR file)"
3+
title: "/FR, /Fr (Name SBR file)"
4+
ms.date: 08/30/2022
55
f1_keywords: ["VC.Project.VCCLWCECompilerTool.BrowseInformation", "VC.Project.VCCLCompilerTool.BrowseInformation", "/fr", "VC.Project.VCCLCompilerTool.BrowseInformationFile", "VC.Project.VCCLWCECompilerTool.BrowseInformationFile"]
66
helpviewer_keywords: ["/FR compiler option [C++]", "-FR compiler option [C++]", "FR compiler option [C++]", "symbolic browser information"]
77
ms.assetid: 3fd8f88b-3924-4feb-9393-287036a28896
88
---
9-
# /FR, /Fr (Create .Sbr File)
9+
# `/FR`, `/Fr` (Name SBR file)
1010

11-
Creates .sbr files.
11+
Creates *`.sbr`* (source browser) files, used by [Code maps](/visualstudio/modeling/code-maps-for-cpp), BSCMAKE, and some third-party code browsing tools.
1212

1313
## Syntax
1414

15-
```
16-
/FR[pathname[\filename]]
17-
/Fr[pathname[\filename]]
18-
```
15+
> **`/FR`**\[*`pathname`*\[*`\filename`*]]\
16+
> **`/Fr`**\[*`pathname`*\[*`\filename`*]]
1917
20-
## Remarks
18+
### Arguments
19+
20+
*`pathname`*\
21+
The optional destination directory for the generated *`.sbr`* files. If this value isn't specified, the files are created in the default output directory. For more information, see [Specifying the pathname](specifying-the-pathname.md).
2122

22-
> [!WARNING]
23-
> Although BSCMAKE is still installed with Visual Studio, it is no longer used by the IDE. Since Visual Studio 2008, browse and symbol information is stored automatically in a SQL Server .sdf file in the solution folder.
23+
*`filename`*\
24+
An optional filename for the generated *`.sbr`* file. If this value isn't specified, the compiler uses the base name of the source file with a *`.sbr`* extension. For more information, see [Specifying the pathname](specifying-the-pathname.md).
2425

25-
During the build process, the Microsoft Browse Information File Maintenance Utility (BSCMAKE) uses these files to create a .BSC file, which is used to display browse information.
26+
## Remarks
2627

27-
**/FR** creates an .sbr file with complete symbolic information.
28+
**`/FR`** creates an *`.sbr`* file with complete symbolic information.
2829

29-
**/Fr** creates an .sbr file without information on local variables.
30+
**`/Fr`** creates an *`.sbr`* file without information on local variables. **`/Fr`** is deprecated; use **`/FR`** instead. For more information, see the Deprecated and removed compiler options section in [Compiler options listed by category](compiler-options-listed-by-category.md).
3031

31-
If you do not specify `filename`, the .sbr file gets the same base name as the source file.
32+
The Visual Studio [Code Maps](/visualstudio/modeling/code-maps-for-cpp) feature requires the *`.sbr`* files generated by **`/FR`**.
3233

33-
**/Fr** is deprecated; use **/FR** instead. For more information, see Deprecated and Removed Compiler Options in [Compiler Options Listed by Category](compiler-options-listed-by-category.md).
34+
The Microsoft Browse Information File Maintenance Utility (BSCMAKE) uses *`.sbr`* files to create a *`.bsc`* file, used to display browse information in some third-party tools. For more information, see [BSCMAKE reference](bscmake-reference.md).
3435

3536
> [!NOTE]
36-
> Do not change the .sbr extension. BSCMAKE requires the intermediary files to have that extension.
37+
> Although BSCMAKE is still installed with Visual Studio, it's no longer used by the IDE. Since Visual Studio 2008, browse and symbol information is stored automatically in a SQL Server SDF file in the solution folder. If you use BSCMAKE, don't change the *`.sbr`* extension. BSCMAKE requires the intermediate files to have that extension.
3738
3839
### To set this compiler option in the Visual Studio development environment
3940

@@ -49,7 +50,7 @@ If you do not specify `filename`, the .sbr file gets the same base name as the s
4950

5051
## See also
5152

52-
[Output-File (/F) Options](output-file-f-options.md)<br/>
53-
[MSVC Compiler Options](compiler-options.md)<br/>
54-
[MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md)<br/>
55-
[Specifying the Pathname](specifying-the-pathname.md)
53+
[Output-File (`/F`) options](output-file-f-options.md)\
54+
[MSVC compiler options](compiler-options.md)\
55+
[MSVC compiler command-line syntax](compiler-command-line-syntax.md)\
56+
[Specifying the pathname](specifying-the-pathname.md)

docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: Compiler Warning (level 1 and level 4) C4700"
33
title: "Compiler Warning (level 1 and level 4) C4700"
4-
ms.date: "02/21/2018"
4+
ms.date: 08/30/2022
55
f1_keywords: ["C4700"]
66
helpviewer_keywords: ["C4700"]
77
ms.assetid: 2da0deb4-77dd-4b05-98d3-b78d74ac4ca7
@@ -10,13 +10,17 @@ ms.assetid: 2da0deb4-77dd-4b05-98d3-b78d74ac4ca7
1010

1111
> uninitialized local variable '*name*' used
1212
13-
The local variable *name* has been *used*, that is, read from, before it has been assigned a value. In C and C++, local variables are not initialized by default. Uninitialized variables can contain any value, and their use leads to undefined behavior. Warning C4700 almost always indicates a bug that can cause unpredictable results or crashes in your program.
13+
## Remarks
1414

15-
To fix this issue, you can initialize local variables when they are declared, or assign a value to them before they are used. A function can be used to initialize a variable that's passed as a reference parameter, or when its address is passed as a pointer parameter.
15+
The local variable *name* has been *used*, that is, read from, before it has been assigned a value. In C and C++, local variables aren't initialized by default. Uninitialized variables can contain any value, and their use leads to undefined behavior. Warning C4700 almost always indicates a bug that can cause unpredictable results or crashes in your program.
16+
17+
To fix this issue, you can initialize local variables when they're declared, or assign a value to them before they're used. A function can be used to initialize a variable that's passed as a reference parameter, or when its address is passed as a pointer parameter.
18+
19+
The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error.
1620

1721
## Example
1822

19-
This sample generates C4700 when variables t, u, and v are used before they are initialized, and shows the kind of garbage value that can result. Variables x, y, and z do not cause the warning, because they are initialized before use:
23+
This sample generates C4700 when variables `t`, `u`, and `v` are used before they're initialized, and shows the kind of garbage value that can result. Variables `x`, `y`, and `z` don't cause the warning, because they're initialized before use:
2024

2125
```cpp
2226
// c4700.cpp
@@ -46,7 +50,7 @@ int main()
4650
}
4751
```
4852
49-
When this code is run, t, u, and v are uninitialized, and the output for s is unpredictable:
53+
When this code is run, `t`, `u`, and `v` are uninitialized, and the output for `s` is unpredictable:
5054
5155
```Output
5256
Value in s: 37816963

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,36 @@
11
---
22
description: "Learn more about: Compiler Warning (level 1) C4532"
33
title: "Compiler Warning (level 1) C4532"
4-
ms.date: "11/04/2016"
4+
ms.date: 08/30/2022
55
f1_keywords: ["C4532"]
66
helpviewer_keywords: ["C4532"]
77
ms.assetid: 4e2a286a-d233-4106-9f65-29be1a94ca02
88
---
99
# Compiler Warning (level 1) C4532
1010

11-
'continue' : jump out of __finally/finally block has undefined behavior during termination handling
11+
> 'continue' : jump out of __finally/finally block has undefined behavior during termination handling
12+
13+
## Remarks
1214

1315
The compiler encountered one of the following keywords:
1416

15-
- [continue](../../cpp/continue-statement-cpp.md)
17+
- [`continue`](../../cpp/continue-statement-cpp.md)
1618

17-
- [break](../../cpp/break-statement-cpp.md)
19+
- [`break`](../../cpp/break-statement-cpp.md)
1820

19-
- [goto](../../cpp/goto-statement-cpp.md)
21+
- [`goto`](../../cpp/goto-statement-cpp.md)
2022

21-
causing a jump out of a [__finally](../../cpp/try-finally-statement.md) or [finally](../../dotnet/finally.md) block during abnormal termination.
23+
causing a jump out of a [`__finally`](../../cpp/try-finally-statement.md) or [`finally`](../../dotnet/finally.md) block during abnormal termination.
2224

2325
If an exception occurs, and while the stack is being unwound during execution of the termination handlers (the **`__finally`** or finally blocks), and your code jumps out of a **`__finally`** block before the **`__finally`** block ends, the behavior is undefined. Control may not return to the unwinding code, so the exception may not be handled properly.
2426

2527
If you must jump out of a **`__finally`** block, check for abnormal termination first.
2628

27-
The following sample generates C4532; simply comment out the jump statements to resolve the warnings.
29+
The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error.
30+
31+
## Example
32+
33+
The following sample generates C4532; delete or comment out the jump statements to resolve the warnings.
2834

2935
```cpp
3036
// C4532.cpp

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,24 @@
11
---
22
description: "Learn more about: Compiler Warning (level 1) C4533"
33
title: "Compiler Warning (level 1) C4533"
4-
ms.date: "11/04/2016"
4+
ms.date: 08/30/2022
55
f1_keywords: ["C4533"]
66
helpviewer_keywords: ["C4533"]
77
ms.assetid: 359fecda-d540-46e5-b214-dbabe9ef50d2
88
---
99
# Compiler Warning (level 1) C4533
1010

11-
initialization of 'variable' is skipped by 'instruction'
11+
> initialization of '*variable*' is skipped by '*instruction*'
1212
13-
An instruction in your program changed the flow of control, such that, an instruction that initialized a variable was not executed. The following sample generates C4533:
13+
## Remarks
14+
15+
An instruction in your program changed the flow of control, so an instruction that initialized a variable wasn't executed.
16+
17+
The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error.
18+
19+
## Example
20+
21+
The following sample generates C4533. To resolve the issue, move the initialization before the jump instruction or after the target of the jump.
1422

1523
```cpp
1624
// C4533.cpp

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: Compiler Warning (Level 1) C4789"
33
title: "Compiler Warning (Level 1) C4789"
4-
ms.date: "03/25/2019"
4+
ms.date: 08/30/2022
55
f1_keywords: ["C4789"]
66
helpviewer_keywords: ["C4789"]
77
ms.assetid: 5800c301-5afb-4af0-85c1-ceb54d775234
@@ -18,11 +18,11 @@ ms.assetid: 5800c301-5afb-4af0-85c1-ceb54d775234
1818

1919
The warning occurs if the copy uses the intrinsic form of one of these CRT functions:
2020

21-
- [strcpy](../../c-runtime-library/reference/strcpy-wcscpy-mbscpy.md)
21+
- [`strcpy`](../../c-runtime-library/reference/strcpy-wcscpy-mbscpy.md)
2222

23-
- [memset](../../c-runtime-library/reference/memset-wmemset.md)
23+
- [`memset`](../../c-runtime-library/reference/memset-wmemset.md)
2424

25-
- [memcpy](../../c-runtime-library/reference/memcpy-wmemcpy.md), [wmemcpy](../../c-runtime-library/reference/memcpy-wmemcpy.md)
25+
- [`memcpy`](../../c-runtime-library/reference/memcpy-wmemcpy.md), [`wmemcpy`](../../c-runtime-library/reference/memcpy-wmemcpy.md)
2626

2727
The warning also appears when you cast a parameter to a larger data type, and then make a copy assignment from an lvalue reference.
2828

@@ -35,7 +35,9 @@ Visual C++ might generate this warning for a code path that never executes. You
3535
#pragma warning( pop )
3636
```
3737

38-
This idiom keeps Visual C++ from generating the warning for that specific block of code. The `#pragma warning(push)` preserves the existing state before `#pragma warning(disable: 4789)` changes it. The `#pragma warning(pop)` restores the pushed state, and removes the effects of the `#pragma warning(disable:4789)`. For more information about the C++ preprocessor directive `#pragma`, see [warning](../../preprocessor/warning.md) and [Pragma Directives and the __Pragma Keyword](../../preprocessor/pragma-directives-and-the-pragma-keyword.md).
38+
This idiom keeps Visual C++ from generating the warning for that specific block of code. The `#pragma warning(push)` preserves the existing state before `#pragma warning(disable: 4789)` changes it. The `#pragma warning(pop)` restores the pushed state, and removes the effects of the `#pragma warning(disable:4789)`. For more information about the C++ preprocessor directive `#pragma`, see [`warning`](../../preprocessor/warning.md) and [Pragma Directives and the `__Pragma` Keyword](../../preprocessor/pragma-directives-and-the-pragma-keyword.md).
39+
40+
The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error.
3941

4042
## Examples
4143

docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: Compiler warning (level 2) C4146"
33
title: "Compiler warning (level 2) C4146"
4-
ms.date: 11/18/2021
4+
ms.date: 08/30/2022
55
f1_keywords: ["C4146"]
66
helpviewer_keywords: ["C4146"]
77
---
@@ -15,7 +15,7 @@ Unsigned types can hold only non-negative values, so unary minus (negation) usua
1515

1616
When you express a negative integer literal, the **`-`** in front of the value is parsed as a [unary negation](../../cpp/unary-plus-and-negation-operators-plus-and.md) operator. The compiler applies the operator after it parses the numeric value. If the numeric value fits in the range of an unsigned integer type, but not the corresponding signed integer type, the compiler interprets the value as unsigned. An unsigned value is unchanged by the unary negation operator.
1717

18-
This warning often occurs when you try to express the minimum **`int`** value, -2147483648, or the minimum **`long long`** value, -9223372036854775808. These values can't be written as -2147483648 or -9223372036854775808ll, respectively. That's because the compiler processes the expression in two stages: first, it parses the numeric value, then it applies the negation operator. For example, when the compiler parses -2147483648, it follows these steps:
18+
This warning often occurs when you try to express the minimum **`int`** value, -2147483648, or the minimum **`long long`** value, -9223372036854775808. These values can't be written as -2147483648 or -9223372036854775808ll, respectively. The reason is because the compiler processes the expression in two stages: first, it parses the numeric value, then it applies the negation operator. For example, when the compiler parses -2147483648, it follows these steps:
1919

2020
1. The number 2147483648 is evaluated. Because it's greater than the maximum **`int`** value of 2147483647, but still fits in an **`unsigned int`**, the type of 2147483648 is **`unsigned int`**.
2121

@@ -25,6 +25,8 @@ The unsigned type of the result can cause unexpected behavior. If the result is
2525

2626
You can avoid C4146 by using `INT_MIN` or `LLONG_MIN` from *`<limits.h>`* or the C++ equivalent, *`<climits>`*. These values have signed types.
2727

28+
The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error.
29+
2830
## Example
2931

3032
The following sample demonstrates the unexpected behavior that can happen when the compiler generates warning C4146:

docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,21 @@
11
---
22
description: "Learn more about: Compiler Warning (level 2) C4308"
33
title: "Compiler Warning (level 2) C4308"
4-
ms.date: "11/04/2016"
4+
ms.date: 08/30/2022
55
f1_keywords: ["C4308"]
66
helpviewer_keywords: ["C4308"]
77
ms.assetid: d4e5c53c-71b2-4bbc-8a7c-3a2a3180d9d9
88
---
99
# Compiler Warning (level 2) C4308
1010

11-
negative integral constant converted to unsigned type
11+
> negative integral constant converted to unsigned type
12+
13+
## Remarks
1214

1315
An expression converts a negative integer constant to an unsigned type. The result of the expression is probably meaningless.
1416

17+
The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error.
18+
1519
## Example
1620

1721
```cpp

docs/error-messages/compiler-warnings/compiler-warning-level-3-c4995.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,24 @@
11
---
22
description: "Learn more about: Compiler Warning (level 3) C4995"
33
title: "Compiler Warning (level 3) C4995"
4-
ms.date: "11/04/2016"
4+
ms.date: 08/30/2022
55
f1_keywords: ["C4995"]
66
helpviewer_keywords: ["C4995"]
77
ms.assetid: c6b61755-4730-4947-ad4d-d1c2bc82585a
88
---
99
# Compiler Warning (level 3) C4995
1010

11-
'function': name was marked as #pragma deprecated
11+
> '*function*': name was marked as `#pragma deprecated`
1212
13-
The compiler encountered a function that was marked with pragma [deprecated](../../preprocessor/deprecated-c-cpp.md). The function may no longer be supported in a future release. You can turn this warning off with the [warning](../../preprocessor/warning.md) pragma (example below).
13+
## Remarks
14+
15+
The compiler encountered a function that was marked with [`#pragma deprecated`](../../preprocessor/deprecated-c-cpp.md). The function may no longer be supported in a future release. You can turn off this warning by using [`#pragma warning`](../../preprocessor/warning.md).
16+
17+
The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error.
1418

1519
## Example
1620

17-
The following sample generates C4995:
21+
The following sample generates C4995. Uncomment the `#pragma warning` line to disable the warning.
1822

1923
```cpp
2024
// C4995.cpp

0 commit comments

Comments
 (0)