Skip to content

Commit 5118d54

Browse files
Taojunshencolin-homeopbld16opbld15opbld17
authored
9/2/2022 AM Publish (#4499)
* 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 * Address cpp-docs 4129 * Typo issues * Wordsmithing ltcgout 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 8a62525 commit 5118d54

File tree

5 files changed

+59
-8
lines changed

5 files changed

+59
-8
lines changed

docs/build/reference/advanced-property-page.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Use the Advanced property page in Visual Studio 2019 to set various properties for C++ projects."
33
title: "Advanced Property Page (Project)"
4-
ms.date: 11/22/2021
4+
ms.date: 08/31/2022
55
f1_keywords: ["VC.Project.VCConfiguration.TargetExt", "VC.Project.VCConfiguration.DeleteExtensionsOnClean", "VC.Project.VCConfiguration.BuildLogFile", "VC.Project.VCConfiguration.PreferredToolArchitecture", "VC.Project.VCConfiguration.UseDebugLibraries", "VC.Project.VCConfiguration.EnableUnitySupport", "VC.Project.VCConfiguration.CopyLocalDeploymentContent", "VC.Project.VCConfiguration.CopyLocalProjectReference", "VC.Project.VCConfiguration.CopyLocalDebugSymbols", "VC.Project.VCConfiguration.CopyCppRuntimeToOutputDir", "VC.Project.VCConfiguration.useOfMfc", "VC.Project.VCConfiguration.CharacterSet", "VC.Project.VCConfiguration.WholeProgramOptimization", "VC.Project.VCConfiguration.VCToolsVersion", "VC.Project.VCConfiguration.LLVMToolsVersion", "VC.Project.VCConfiguration.ManagedExtensions", "VC.Project.TargetFrameworkVersion", "VC.Project.VCConfiguration.EnableManagedIncrementalBuild", "VC.Project.VCConfiguration.ManagedAssembly"]
66
---
77
# Advanced Property Page
@@ -50,7 +50,7 @@ Specifies whether to use the x86 or x64 build tools.
5050

5151
### Use Debug Libraries
5252

53-
Specifies whether to create a Debug or Release build.
53+
Specifies whether to create a Debug or Release build. Despite the name, **Use Debug Libraries** is a build system-specific property that is effectively shorthand for "Make a Debug build" or "Make a Release build". It sets several compiler and linker properties for Debug or Release builds, including the library settings. You can use it to create Debug or Release configurations for a new platform or in a new template. We don't recommend you change this property in an existing configuration. Use the individual compiler and linker properties instead.
5454

5555
### Enable Unity (JUMBO) build
5656

docs/build/reference/ltcg-link-time-code-generation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "/LTCG (Link-time code generation)"
33
description: "The MSVC linker option /LTCG enables link-time code generation for whole-program optimization."
4-
ms.date: 07/08/2020
4+
ms.date: 08/31/2022
55
f1_keywords: ["VC.Project.VCLinkerTool.LinkTimeCodeGeneration", "VC.Project.VCCLWCECompilerTool.WholeProgramOptimization", "/ltcg", "VC.Project.VCCLCompilerTool.WholeProgramOptimization"]
66
helpviewer_keywords: ["link-time code generation in C++ linker", "/LTCG linker option", "-LTCG linker option", "LTCG linker option"]
77
ms.assetid: 788c6f52-fdb8-40c2-90af-4026ea2cf2e2
@@ -76,7 +76,7 @@ The rest of this article discusses the link-time code generation done by **`/LTC
7676

7777
The linker invokes link-time code generation if it's passed a module that was compiled by using **`/GL`** or an MSIL module (see [`.netmodule` Files as Linker Input](netmodule-files-as-linker-input.md)). If you don't explicitly specify **`/LTCG`** when you pass **`/GL`** or MSIL modules to the linker, the linker eventually detects this situation and restarts the link by using **`/LTCG`**. Explicitly specify **`/LTCG`** when you pass **`/GL`** and MSIL modules to the linker for the fastest possible build performance.
7878

79-
For even faster performance, use **`/LTCG:INCREMENTAL`**. This option tells the linker to reoptimize only the files affected by a source file change, instead of the entire project. This option can significantly reduce the link time required. This option isn't the same option as [incremental linking](incremental-link-incrementally.md).
79+
For even faster performance, use **`/LTCG:INCREMENTAL`**. This option tells the linker to reoptimize only the files affected by a source file change, instead of the entire project. This option can significantly reduce the link time required. This option isn't the same option as [incremental linking](incremental-link-incrementally.md). If you remove the **`/LTCG:INCREMENTAL`** option, also remove any [`/LTCGOUT`](./ltcgout.md) option to improve build times and disk utilization.
8080

8181
**`/LTCG`** isn't valid for use with [`/INCREMENTAL`](incremental-link-incrementally.md).
8282

@@ -101,7 +101,7 @@ Using **`/LTCG`** and **`/O2`** causes double-alignment optimization.
101101

102102
If **`/LTCG`** and **`/O1`** are specified, double alignment isn't performed. If most of the functions in an application are compiled for speed, with a few functions compiled for size (for example, by using the [`optimize`](../../preprocessor/optimize.md) pragma), the compiler double-aligns the functions that are optimized for size if they call functions that require double alignment.
103103

104-
If the compiler can identify all of the call sites of a function, the compiler ignores explicit calling-convention modifiers on a function and tries to optimize the function's calling convention:
104+
If the compiler can identify all of the call sites of a function, the compiler ignores explicit calling-convention modifiers, and tries to optimize the function's calling convention:
105105

106106
- pass parameters in registers
107107

docs/build/reference/ltcgout.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: "/LTCGOUT (Name LTCG incremental object file)"
3+
description: "The MSVC linker option /LTCGOUT names the incremental link-time code generation object file."
4+
ms.date: 08/31/2022
5+
f1_keywords: ["VC.Project.VCLinkerTool.LinkTimeCodeGenerationObjectFile", "/ltcgout", "ltcgout"]
6+
helpviewer_keywords: ["Name link-time code generation file in C++ linker", "/LTCGOUT linker option", "-LTCGOUT linker option", "LTCGOUT linker option"]
7+
---
8+
# `/LTCGOUT` (Name LTCG incremental object file)
9+
10+
The **`/LTCGOUT`** linker option tells the linker where to put the intermediate *`.iobj`* object file for incremental link-time code generation (**`/LTCG:INCREMENTAL`**).
11+
12+
## Syntax
13+
14+
> **`/LTCGOUT:`**\[*`pathname`*]
15+
16+
### Arguments
17+
18+
*`pathname`*\
19+
The optional destination directory and filename for the generated *`.iobj`* file. If the **`/LTCGOUT`** option isn't specified when **`/LTCG:INCREMENTAL`** is used, the filename is created by appending *`.iobj`* to the target base filename. If the **`/LTCGOUT`** option is specified with an empty *`pathname`* when **`/LTCG:INCREMENTAL`** isn't used, no *`.iobj`* file is generated.
20+
21+
## Remarks
22+
23+
The **`/LTCGOUT`** linker option tells the linker the path and filename to use for the intermediate *`.iobj`* object file when you specify [`/LTCG:INCREMENTAL`](./ltcg-link-time-code-generation.md). If you remove the **`/LTCG:INCREMENTAL`** option from your project, you should also remove any **`/LTCGOUT`** option.
24+
25+
### To set this compiler option in the Visual Studio development environment
26+
27+
1. Open the project **Property Pages** dialog box. For more information, see [Set compiler and build properties](../working-with-project-properties.md).
28+
29+
1. Select the **Configuration Properties** > **Linker** > **Optimization** property page.
30+
31+
1. Modify the **Link Time Code Generation Object File** property. The option isn't set if this property is empty.
32+
33+
### To set this compiler option programmatically
34+
35+
- See <xref:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.AdditionalOptions%2A>.
36+
37+
## See also
38+
39+
[MSVC linker reference](linking.md)\
40+
[MSVC linker options](linker-options.md)

docs/build/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -989,6 +989,8 @@ items:
989989
href: ../build/reference/linkreprotarget.md
990990
- name: /LTCG (Link-time code generation)
991991
href: ../build/reference/ltcg-link-time-code-generation.md
992+
- name: /LTCGOUT (Name LTCG .iobj file)
993+
href: ../build/reference/ltcgout.md
992994
- name: /MACHINE (Specify target platform)
993995
href: ../build/reference/machine-specify-target-platform.md
994996
- name: /MANIFEST (Create side-by-side assembly manifest)
Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,21 @@
11
---
22
description: "Learn more about: Linker Tools Error LNK1248"
33
title: "Linker Tools Error LNK1248"
4-
ms.date: "12/28/2017"
4+
ms.date: 08/31/2022
55
f1_keywords: ["LNK1248"]
66
helpviewer_keywords: ["LNK1248"]
77
---
88
# Linker Tools Error LNK1248
99

10-
> image size ('*size*') exceeds maximum allowable size (80000000)
10+
> image size ('*output_size*') exceeds maximum allowable size (*maximum_size*)
1111
12-
The linker determined that the size of the output file will exceed the largest possible size for a 32-bit program image. You may want to make your program into multiple DLLs.
12+
## Remarks
13+
14+
The linker determined that the size of an output file will exceed the largest possible size for a 32-bit program image or object file (PE or COFF file).
15+
16+
To resolve this issue if the file is an executable or DLL, you may want to refactor your program to move some functionality into a separate DLL. If the file is an object file, you may want to refactor your source file into multiple translation units. If the file is a *`.iobj`* file created by [`/LTCGOUT` (Name LTCG incremental object file)](../../build/reference/ltcgout.md) and you aren't using **`/LTCG:INCREMENTAL`**, then remove the **`/LTCGOUT`** option. If you're using **`/LTCG:INCREMENTAL`**, then consider refactoring your executable to reduce the size of the component that causes the error.
17+
18+
## See also
19+
20+
[`/GL` (Whole Program Optimization)](../../build/reference/gl-whole-program-optimization.md)\
21+
[`/LTCG` (Link-time code generation)](../../build/reference/ltcg-link-time-code-generation.md)

0 commit comments

Comments
 (0)