Skip to content

Commit d2b1b57

Browse files
TaojunshenMugBergerFriesbradlitterellopbld17colin-home
authored
9/28/2022 AM Publish (#4550)
* Updated C6101 Mirror of my public PR. Added an example. Added proper spacing between headers and code blocks, matched formatting to my other PRs * Updated C6101 Minor changes in response to Acrolinx report * Updated C6101 More Acrolinx changes, split a run-on sentence * Updated C26495 Matched formatting to my other PRs. Added more information to the example. * Updated C26495 Fixed spelling error * Updated C6101 Updated to the latest format * Updated C6101 Single backticks and InOut->Inout * Updated C26495 Updated to the new format NOTE: This warning has no code analysis name. Per @MichaelSquires instructions, I omitted the usual keywords and 'Code analysis name:' section to match * Update compiler-warning-level-4-c4464.md @corob-msft proposal. I don't warrant it shouldn't be worded in a better way. * Update compiler-warning-level-4-c4464.md typo fix * fix: delete unnecessary asterisk followup fix of MicrosoftDocs#4136 * optimize prime test * Update floating-point-support.md Explain what "ulp" stands for * Updates for cpp-docs 4161 * Update integritycheck-require-signature-check.md * alt-text * Update abstract-cpp-component-extensions.md * Add syntax highlighting to atl-mfc-shared * Updated C26495 Added code analysis ID * alt-text updates * customer fix * minor updates * Incorporate changes in rewrite Updates for style and clarity. Also give it an Acrolinx pass. * Clarify version support * Tweak language for minimum support * Add code style, comment @MugBergerFries It's a good idea to use code styling for mentions of variable or class names (especially when they're easily confused generic names like "value"). I also added a comment to the fixed code sample to amplify the change and what it was doing. * acrolinx * cleanup pass * [BULK] DocuTune - Rebranding * alt-text updates * update alt-text * Fix Supported SSH algorithms * Update README.md * Address cpp-docs 4149 __umulh on ARM64 * Add slashes per cpp-docs 4150 * update alt-text code and removed 'experimental' from images * Update clang-support-msbuild.md Updated for better visibility of LLVMToolsVersion property. Note the text was also misleading because it kind of implies that LLVMToolsVersion supports side-by-side version of clang/LLVM in the same `LLVMInstallDir`, but that's not how clang/LLVM works. If you want to select a different version, you need to point it to a different path. * test fix * test fix * test fix * alt-text updates plus acrolinx * acrolinx * Split props file and IDE sections When both path and version are merged in the .props file discussion, a division between the .props approach and the IDE approach seems more natural than repeating the same content twice. * Update to add /std requirement * Test of build checks features * Update cpp-linter-overview.md * Provide F1 links to articles for VS linker properties (#4529) * Update F1 links for Linker Properties * F1 Project: Linker Properties part 1 * Finish Linker properties F1 links * Fix typo * Fix acrolinx related issues * Update dot-xmm.md Fixed overzealous replacement * [BULK UPDATE] DocuTune - Rebranding * Fix missing semicolon * Update files per cpp-docs 4181 * Add /ILK option per cpp-docs 4194 * Update per cpp-docs 4193 * Address cpp-docs 4186 code labels * template function -> function template * Acrolinx fixes. * Tweak language for 4178 update * Updates to main and wmain signatures * Acrolinx and style updates per review * Fix spelling, i18n, style, Acrolinx issues * Fix date. Co-authored-by: Samuel Berger <sjamesberger@gmail.com> Co-authored-by: Brad Litterell <49081806+bradlitterell@users.noreply.github.com> Co-authored-by: opbld17 <opbld17@microsoft.com> Co-authored-by: Colin Robertson <3836425+corob-msft@users.noreply.github.com> Co-authored-by: opbld16 <opbld16@microsoft.com> Co-authored-by: Kisaragi <48310258+KisaragiEffective@users.noreply.github.com> Co-authored-by: Courtney Wales <62625502+Court72@users.noreply.github.com> Co-authored-by: opbld15 <opbld15@microsoft.com> Co-authored-by: TylerMSFT <Tyler.Whitney@microsoft.com> Co-authored-by: Bryan Gold <101299717+19BMG00@users.noreply.github.com> Co-authored-by: Edward Breeveld <42862235+EddieBreeveld@users.noreply.github.com> Co-authored-by: Jeff Borsecnik <36546697+jborsecnik@users.noreply.github.com> Co-authored-by: jsuther1974 <jsuther@microsoft.com> Co-authored-by: Austin Morton <apmorton@users.noreply.github.com> Co-authored-by: Jak Koke <v-jokoke@microsoft.com> Co-authored-by: HO-COOH <42881734+HO-COOH@users.noreply.github.com> Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com> Co-authored-by: James Barnett <v-jabarnett@microsoft.com> Co-authored-by: Dennis Rea <v-denrea@microsoft.com> Co-authored-by: Alex Buck <abuck@microsoft.com> Co-authored-by: Tyler Whitney <tylerw6502@gmail.com> Co-authored-by: ragingo <save.the.world.crush@gmail.com> Co-authored-by: Feng Xu <fenxu@microsoft.com> Co-authored-by: Chuck Walbourn <walbourn@users.noreply.github.com> Co-authored-by: Colin Cooper <72402153+v-ccolin@users.noreply.github.com> Co-authored-by: Lychy <gatelych83@gmail.com> Co-authored-by: chausner <15180557+chausner@users.noreply.github.com> Co-authored-by: Stacyrch140 <102548089+Stacyrch140@users.noreply.github.com> Co-authored-by: Paula Miller <v-paulmi@microsoft.com>
1 parent f018c5c commit d2b1b57

File tree

49 files changed

+745
-685
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

49 files changed

+745
-685
lines changed

‎docs/assembler/masm/dot-xmm.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.assetid: db3062b6-8b2f-469b-aa02-df6571eab3ba
88
---
99
# .XMM (32-bit MASM)
1010

11-
Enables assembly of Internet Streaming SIMD Extension instructions. (32-bit MASM only.)
11+
Enables assembly of Streaming SIMD Extension instructions. (32-bit MASM only.)
1212

1313
## Syntax
1414

‎docs/atl/reference/ccomenum-class.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ The code shown below provides a reusable function for creating and initializing
7676

7777
[!code-cpp[NVC_ATL_COM#32](../../atl/codesnippet/cpp/ccomenum-class_1.h)]
7878

79-
This template function can be used to implement the `_NewEnum` property of a collection interface as shown below:
79+
This function template can be used to implement the `_NewEnum` property of a collection interface as shown below:
8080

8181
[!code-cpp[NVC_ATL_COM#33](../../atl/codesnippet/cpp/ccomenum-class_2.h)]
8282

‎docs/atl/reference/ccomenumonstl-class.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ The code shown below provides a generic function to handle the creation and init
8585

8686
[!code-cpp[NVC_ATL_COM#34](../../atl/codesnippet/cpp/ccomenumonstl-class_1.h)]
8787

88-
This template function can be used to implement the `_NewEnum` property of a collection interface as shown below:
88+
This function template can be used to implement the `_NewEnum` property of a collection interface as shown below:
8989

9090
[!code-cpp[NVC_ATL_COM#35](../../atl/codesnippet/cpp/ccomenumonstl-class_2.h)]
9191

‎docs/build/reference/atl-program-or-control-source-and-header-files.md‎

Lines changed: 50 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,60 @@
11
---
2-
description: "Learn more about: ATL Program or Control Source and Header Files"
3-
title: "ATL Program or Control Source and Header Files"
4-
ms.date: "11/04/2016"
2+
description: "Learn more about: ATL program or control source and header files"
3+
title: "ATL program or control source and header files"
4+
ms.date: 09/27/2022
55
helpviewer_keywords: ["file types [C++], ATL source and headers"]
66
ms.assetid: cb65372f-4880-4007-b582-a52eaa568fd1
77
---
8-
# ATL Program or Control Source and Header Files
8+
# ATL program or control source and header files
99

10-
The following files are created when you create an ATL project in Visual Studio, depending on the options you select for the project you create.
10+
The following files are created when you create an ATL project in Visual Studio, depending on the options you select for the project you create. The file names depend on the name you choose for your project, which we'll call *`ProjectName`*.
1111

12-
All of these files are located in the *Projname* directory, and in either the Header Files (.h files) folder or Source Files (.cpp files) folder in Solution Explorer.
12+
All of the files created by the project template are located in the *`ProjectName`* and *`ProjectNamePS`* project directories. In Solution Explorer, the *`ProjectName`* files are located in the **Generated Files**, **Header Files**, **Resource Files**, and **Source Files** folders. The *`ProjectNamePS`* files are in the **Generated Files** and **Source Files** folders. Not all files listed here are generated for every project type. Files in the **Generated Files** folder are generated automatically by the MIDL compiler; they shouldn't be edited directly.
1313

14-
|File name|Description|
15-
|---------------|-----------------|
16-
|*Projname*.h|The main include file containing the C++ interface definitions and GUID declarations of the items defined in ATLSample.idl. It is regenerated by MIDL during compilation.|
17-
|*Projname*.cpp|The main program source file. It contains the implementation of your DLL's exports for an in-process server and the implementation of `WinMain` for a local server. For a service, this additionally implements all the service management functions.|
18-
|Resource.h|The header file for the resource file.|
19-
|StdAfx.cpp|Includes the files StdAfx.h and Atlimpl.cpp.|
20-
|StdAfx.h|Includes the ATL header files.|
14+
::: moniker range=">=msvc-150"
15+
16+
| File name | Description |
17+
|--|--|
18+
| *`ProjectName_i.c`* | The generated source file containing the C++ IID and CLSID definitions and GUID declarations of the items defined in *`ProjectName.idl`*. Don't edit this file; it's regenerated by MIDL during compilation. Link this file with the server and any clients. |
19+
| *`ProjectName_i.h`* | The generated include file containing the C++ interface declarations and GUID declarations of the items defined in *`ProjectName.idl`*. Don't edit this file; it's regenerated by MIDL during compilation. Include this file in source files for the server and any clients. |
20+
| *`ProjectName.rc`* | The main program resource file. |
21+
| *`ProjectName.rgs`* | The main program registration file. |
22+
| *`ProjectName.cpp`* | The main program source file. In DLL projects, it contains the implementation of your DLL's exports for an in-process server. In EXE projects, it contains the implementation of `WinMain` for a local server. For a service, this file implements all the service management functions. |
23+
| *`ProjectName.def`* | In DLL projects, the definitions for your DLL's exports. |
24+
| *`ProjectName.idl`* | The IDL source for your project. The MIDL tool processes this file to produce the type library (*`.tlb`*) and marshaling code. |
25+
| *`framework.h`* | Sets preprocessor macros and includes the ATL header files, the *`targetver.h`* version support header, and the *`Resource.h`* resource file header. |
26+
| *`dllmain.h`* | In DLL projects, the header file for the module class. |
27+
| *`dllmain.cpp`* | In DLL projects, the source file for the `DllMain` function. |
28+
| *`Resource.h`* | The header file for the resource file. |
29+
| *`targetver.h`* | Includes *`SDKDDKVer.h`*. To build your application for a previous Windows platform, include *`WinSDKVer.h`* and set the `_WIN32_WINNT` macro to the platform you wish to support before including *`SDKDDKVer.h`*. |
30+
| *`pch.cpp`* | Includes the file *`pch.h`*. |
31+
| *`pch.h`* | Includes the *`framework.h`* header file. |
32+
33+
::: moniker-end
34+
35+
::: moniker range="msvc-140"
36+
37+
| File name | Description |
38+
|--|--|
39+
| *`ProjectName_i.c`* | The generated source file containing the C++ IID and CLSID definitions and GUID declarations of the items defined in *`ProjectName.idl`*. Don't edit this file; it's regenerated by MIDL during compilation. Link this file with the server and any clients. |
40+
| *`ProjectName_i.h`* | The generated include file containing the C++ interface declarations and GUID declarations of the items defined in *`ProjectName.idl`*. Don't edit this file; it's regenerated by MIDL during compilation. Include this file in source files for the server and any clients. |
41+
| *`ProjectName.rc`* | The main program resource file. |
42+
| *`ProjectName.rgs`* | The main program registration file. |
43+
| *`ProjectName.cpp`* | The main program source file. In DLL projects, it contains the implementation of your DLL's exports for an in-process server. In EXE projects, it contains the implementation of `WinMain` for a local server. For a service, this file implements all the service management functions. |
44+
| *`ProjectName.def`* | In DLL projects, the definitions for your DLL's exports. |
45+
| *`ProjectName.idl`* | The IDL source for your project. The MIDL tool processes this file to produce the type library (*`.tlb`*) and marshaling code. |
46+
| *`dllmain.h`* | In DLL projects, the header file for the module class. |
47+
| *`dllmain.cpp`* | In DLL projects, the source file for the `DllMain` function. |
48+
| *`resource.h`* | The header file for the resource file. |
49+
| *`targetver.h`* | Includes *`SDKDDKVer.h`*. To build your application for a previous Windows platform, include *`WinSDKVer.h`* and set the `_WIN32_WINNT` macro to the platform you wish to support before including *`SDKDDKVer.h`*. |
50+
| *`stdafx.cpp`* | Includes the file *`stdafx.h`*. |
51+
| *`stdafx.h`* | Sets preprocessor macros and includes the ATL header files, the *`targetver.h`* version support header, and the *`resource.h`* resource file header. |
52+
53+
::: moniker-end
2154

2255
## See also
2356

24-
[File Types Created for Visual Studio C++ projects](file-types-created-for-visual-cpp-projects.md)<br>
25-
[MFC Program or Control Source and Header Files](mfc-program-or-control-source-and-header-files.md)<br>
26-
[CLR Projects](files-created-for-clr-projects.md)
57+
[File types created for Visual Studio C++ projects](file-types-created-for-visual-cpp-projects.md)\
58+
[MFC program or control source and header files](mfc-program-or-control-source-and-header-files.md)\
59+
[Add ATL support to an existing MFC executable or DLL](../../mfc/reference/adding-atl-support-to-your-mfc-project.md)\
60+
[CLR projects](files-created-for-clr-projects.md)

‎docs/build/reference/linker-options.md‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: "MSVC Linker options"
33
description: "A list of the options supported by the Microsoft LINK linker."
4-
ms.date: 05/11/2022
4+
ms.date: 09/27/2022
55
f1_keywords: ["link"]
66
helpviewer_keywords: ["linker [C++]", "linker [C++], options listed", "libraries [C++], linking to COFF", "LINK tool [C++], linker options"]
77
ms.assetid: c1d51b8a-bd23-416d-81e4-900e02b2c129
88
---
99
# Linker options
1010

11-
LINK.exe links Common Object File Format (COFF) object files and libraries to create an executable (.exe) file or a dynamic-link library (DLL).
11+
LINK.exe links Common Object File Format (COFF) object files and libraries to create an executable (EXE) file or a dynamic-link library (DLL).
1212

1313
The following table lists options for LINK.exe. For more information about LINK, see:
1414

@@ -22,7 +22,7 @@ The following table lists options for LINK.exe. For more information about LINK,
2222

2323
On the command line, linker options aren't case-sensitive; for example, `/base` and `/BASE` mean the same thing. For details on how to specify each option on the command line or in Visual Studio, see the documentation for that option.
2424

25-
You can use the [comment](../../preprocessor/comment-c-cpp.md) pragma to specify some linker options.
25+
You can use the [`comment`](../../preprocessor/comment-c-cpp.md) pragma to specify some linker options.
2626

2727
## Linker options listed alphabetically
2828

@@ -43,7 +43,7 @@ You can use the [comment](../../preprocessor/comment-c-cpp.md) pragma to specify
4343
| [`/CLRIMAGETYPE`](clrimagetype-specify-type-of-clr-image.md) | Sets the type (IJW, pure, or safe) of a CLR image. |
4444
| [`/CLRSUPPORTLASTERROR`](clrsupportlasterror-preserve-last-error-code-for-pinvoke-calls.md) | Preserves the last error code of functions that are called through the P/Invoke mechanism. |
4545
| [`/CLRTHREADATTRIBUTE`](clrthreadattribute-set-clr-thread-attribute.md) | Specifies the threading attribute to apply to the entry point of your CLR program. |
46-
| [`/CLRUNMANAGEDCODECHECK`](clrunmanagedcodecheck-add-suppressunmanagedcodesecurityattribute.md) | Specifies whether the linker will apply the SuppressUnmanagedCodeSecurity attribute to linker-generated PInvoke stubs that call from managed code into native DLLs. |
46+
| [`/CLRUNMANAGEDCODECHECK`](clrunmanagedcodecheck-add-suppressunmanagedcodesecurityattribute.md) | Specifies whether the linker will apply the `SuppressUnmanagedCodeSecurity` attribute to linker-generated P/Invoke stubs that call from managed code into native DLLs. |
4747
| [`/DEBUG`](debug-generate-debug-info.md) | Creates debugging information. |
4848
| [`/DEBUGTYPE`](debugtype-debug-info-options.md) | Specifies which data to include in debugging information. |
4949
| [`/DEF`](def-specify-module-definition-file.md) | Passes a module-definition (.def) file to the linker. |
@@ -69,6 +69,7 @@ You can use the [comment](../../preprocessor/comment-c-cpp.md) pragma to specify
6969
| [`/IDLOUT`](idlout-name-midl-output-files.md) | Specifies the name of the *`.idl`* file and other MIDL output files. |
7070
| [`/IGNORE`](ignore-ignore-specific-warnings.md) | Suppresses output of specified linker warnings. |
7171
| [`/IGNOREIDL`](ignoreidl-don-t-process-attributes-into-midl.md) | Prevents the processing of attribute information into an *`.idl`* file. |
72+
| [`/ILK`](ilk-name-incremental-database-file.md) | Overrides the default incremental database file name. |
7273
| [`/IMPLIB`](implib-name-import-library.md) | Overrides the default import library name. |
7374
| [`/INCLUDE`](include-force-symbol-references.md) | Forces symbol references. |
7475
| [`/INCREMENTAL`](incremental-link-incrementally.md) | Controls incremental linking. |
@@ -126,7 +127,7 @@ You can use the [comment](../../preprocessor/comment-c-cpp.md) pragma to specify
126127
| [`/WINMDFILE`](winmdfile-specify-winmd-file.md) | Specifies the file name for the Windows Runtime Metadata (winmd) output file that's generated by the [`/WINMD`](winmd-generate-windows-metadata.md) linker option. |
127128
| [`/WINMDKEYFILE`](winmdkeyfile-specify-winmd-key-file.md) | Specifies a key or key pair to sign a Windows Runtime Metadata file. |
128129
| [`/WINMDKEYCONTAINER`](winmdkeycontainer-specify-key-container.md) | Specifies a key container to sign a Windows Metadata file. |
129-
| [`/WINMDDELAYSIGN`](winmddelaysign-partially-sign-a-winmd.md) | Partially signs a Windows Runtime Metadata (.winmd) file by placing the public key in the winmd file. |
130+
| [`/WINMDDELAYSIGN`](winmddelaysign-partially-sign-a-winmd.md) | Partially signs a Windows Runtime Metadata (*`.winmd`*) file by placing the public key in the winmd file. |
130131
| [`/WX`](wx-treat-linker-warnings-as-errors.md) | Treats linker warnings as errors. |
131132

132133
<sup>16.1</sup> This option is available starting in Visual Studio 2019 version 16.1.

0 commit comments

Comments
 (0)