edits

TylerMSFT · TylerMSFT · commit 2f48292d1218 · 2025-03-24T16:54:00.000-07:00
diff --git a/docs/build/reference/assemblylinkresource-link-to-dotnet-framework-resource.md b/docs/build/reference/assemblylinkresource-link-to-dotnet-framework-resource.md
@@ -13,9 +13,9 @@ Create a link to a .NET Framework resource in the output file.
 
 > **`/ASSEMBLYLINKRESOURCE:`*`filename`***
 
-## Arguments
+## Argument
 
-*`filename`*
+*`filename`*\
 The .NET Framework resource file to link from the assembly. Must not exceed `MAX_PATH` (260) characters.
 
 ## Remarks
diff --git a/docs/build/reference/idlout-name-midl-output-files.md b/docs/build/reference/idlout-name-midl-output-files.md
@@ -7,21 +7,21 @@ helpviewer_keywords: ["MIDL, output file names", ".idl files, path", "MIDL", "/I
 ---
 # /IDLOUT (Name MIDL Output Files)
 
-```cmd
-/IDLOUT:[path\]filename
-```
+## Syntax
 
-## Parameters
+> /IDLOUT:[path\]filename
+
+## Argument
 
 *`path`*\
-An absolute or relative path specification. By specifying a path, you affect only the location of an .idl file; all other files are placed in the project directory.
+An absolute or relative path specification. By specifying a path, you affect only the location of an `.idl` file; all other files are placed in the project directory.
 
 *`filename`*\
-Specifies the name of the .idl file created by the MIDL compiler. No file extension is assumed; specify *filename*.idl if you want an .idl extension. The path plus filename must not exceed `MAX_PATH` (260) characters.
+Specifies the name of the `.idl` file created by the MIDL compiler. No file extension is assumed; specify *`filename.idl` if you want an `.idl` extension. The path plus filename must not exceed `MAX_PATH` (260) characters.
 
 ## Remarks
 
-The `/IDLOUT` option specifies the name and extension of the .idl file.
+The `/IDLOUT` option specifies the name and extension of the `.idl `file.
 
 The MIDL compiler is called by the MSVC linker when linking projects that have the [`module`](../../windows/attributes/module-cpp.md) attribute.
 
@@ -39,9 +39,7 @@ If you specify neither `/IDLOUT` nor `/TLBOUT`, the linker will create vc70.tlb,
 ### To set this linker option in the Visual Studio development environment
 
 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
-
 1. Select the **Configuration Properties** > **Linker** > **Embedded IDL** property page.
-
 1. Modify the **Merge IDL Base File Name** property.
 
 ### To set this linker option programmatically
diff --git a/docs/build/reference/implib-name-import-library.md b/docs/build/reference/implib-name-import-library.md
@@ -1,35 +1,35 @@
 ---
 description: "Learn more about: /IMPLIB (Name Import Library)"
 title: "/IMPLIB (Name Import Library)"
-ms.date: "11/04/2016"
+ms.date: 03/24/2025
 f1_keywords: ["/implib", "VC.Project.VCLinkerTool.ImportLIbrary"]
 helpviewer_keywords: ["IMPLIB linker option", "/IMPLIB linker option", "-IMPLIB linker option", "import libraries, overriding default name"]
 ---
 # `/IMPLIB` (Name Import Library)
 
+## Syntax
+
 > /IMPLIB:*filename*
 
-## Parameters
+## Argument
 
 *`filename`*\
 A user-specified name for the import library. It replaces the default name. Must not exceed `MAX_PATH` (260) characters.
 
 ## Remarks
 
-The `/IMPLIB` option overrides the default name for the import library that LINK creates when it builds a program that contains exports. The default name is formed from the base name of the main output file and the extension .lib. A program contains exports if one or more of the following are specified:
+The `/IMPLIB` option overrides the default name for the import library that LINK creates when it builds a program that contains exports. The default name is formed from the base name of the main output file and the extension `.lib`. A program contains exports if one or more of the following are specified:
 
 - The [__declspec(dllexport)](../../cpp/dllexport-dllimport.md) keyword in the source code
 - [EXPORTS](exports.md) statement in a .def file
 - An [/EXPORT](export-exports-a-function.md) specification in a LINK command
 
-LINK ignores `/IMPLIB` when an import library is not being created. If no exports are specified, LINK does not create an import library. If an export file is used in the build, LINK assumes that an import library already exists and does not create one. For information on import libraries and export files, see [LIB Reference](lib-reference.md).
+LINK ignores `/IMPLIB` when an import library isn't being created. If no exports are specified, LINK doesn't create an import library. If an export file is used in the build, LINK assumes that an import library already exists and doesn't create one. For information on import libraries and export files, see [LIB Reference](lib-reference.md).
 
 ### To set this linker option in the Visual Studio development environment
 
 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
-
 1. Select the **Configuration Properties** > **Linker** > **Advanced** property page.
-
 1. Modify the **Import Library** property.
 
 ### To set this linker option programmatically
diff --git a/docs/build/reference/keyfile-specify-key-or-key-pair-to-sign-an-assembly.md b/docs/build/reference/keyfile-specify-key-or-key-pair-to-sign-an-assembly.md
@@ -7,7 +7,7 @@ helpviewer_keywords: ["/KEYFILE linker option", "-KEYFILE linker option", "KEYFI
 ---
 # /KEYFILE (Specify Key or Key Pair to Sign an Assembly)
 
-```cmd
+```
 /KEYFILE:filename
 ```
 
diff --git a/docs/build/reference/libpath-additional-libpath.md b/docs/build/reference/libpath-additional-libpath.md
@@ -7,25 +7,23 @@ helpviewer_keywords: ["LIBPATH linker option", "/LIBPATH linker option", "Additi
 ---
 # `/LIBPATH` (Additional Libpath)
 
-```cmd
-/LIBPATH:dir
-```
+## Syntax
 
-## Parameters
+> /LIBPATH:dir
+
+## Argument
 
 *`dir`*\
-Specifies a path that the linker will search before it searches the path specified in the LIB environment option. Must not exceed `MAX_PATH` (260) characters.
+Specifies a path that the linker searches before it searches the path specified in the `LIB` environment option. Must not exceed `MAX_PATH` (260) characters.
 
 ## Remarks
 
-Use the `/LIBPATH` option to override the environment library path. The linker will first search in the path specified by this option, and then search in the path specified in the LIB environment variable. You can specify only one directory for each `/LIBPATH` option you enter. If you want to specify more than one directory, you must specify multiple `/LIBPATH` options. The linker will then search the specified directories in order.
+Use the `/LIBPATH` option to override the environment library path. The linker first searches in the path specified by this option, and then searches in the path specified in the `LIB` environment variable. You can specify only one directory for each `/LIBPATH` option you enter. To specify more than one directory, specify multiple `/LIBPATH` options. The linker searches the specified directories in order.
 
 ### To set this linker option in the Visual Studio development environment
 
 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
-
 1. Select the **Configuration Properties** > **Linker** > **General** property page.
-
 1. Modify the **Additional Library Directories** property.
 
 ### To set this linker option programmatically
diff --git a/docs/build/reference/link-repro-full-path-rsp.md b/docs/build/reference/link-repro-full-path-rsp.md
@@ -7,17 +7,20 @@ helpviewer_keywords: ["/LINKREPROFULLPATHRSP linker option", "-LINKREPROFULLPATH
 ---
 # `/LINKREPROFULLPATHRSP` (Generate file containing absolute paths of linked files)
 
-Generates a response file (.RSP) containing the absolute paths of all the files the linker took as input.
+Generates a response file (`.RSP`) containing the absolute paths of all the files the linker took as input.
 
 This flag was introduced in Visual Studio 2022 version 17.11.
 
 ## Syntax
 
-> **`/LINKREPROFULLPATHRSP:filename`**
+> **/LINKREPROFULLPATHRSP:filename**
 
-## Remarks
+## Argument
+
+*`filename`*\
+Specifies the name of the response file to create. Must not exceed `MAX_PATH` (260) characters.
 
-The *`filename`* argument specifies the name of the response file to create. Must not exceed `MAX_PATH` (260) characters.
+## Remarks
 
 Rather than generate a full link repro like `/LINKREPRO`, which copies all the files to a directory and creates a response file with relative paths to that directory, this option writes the names of the files used during linking to the specified file.
 
diff --git a/docs/build/reference/linkrepro.md b/docs/build/reference/linkrepro.md
@@ -15,8 +15,8 @@ Tells the linker or library tool to generate a link repro in a specified directo
 
 ### Arguments
 
-**/LINKREPRO:**_directory-name_\
-The user-specified directory to store the link repro in. Directory names that include spaces must be enclosed in double quotes. The *`_directory-name_`* must not exceed `MAX_PATH` (260) characters.
+**_directory-name_\
+The user-specified directory to store the link repro in. Directory names that include spaces must be enclosed in double quotes. Must not exceed `MAX_PATH` (260) characters.
 
 ## Remarks
 
diff --git a/docs/build/reference/manifestfile-name-manifest-file.md b/docs/build/reference/manifestfile-name-manifest-file.md
@@ -7,9 +7,14 @@ helpviewer_keywords: ["MANIFESTFILE linker option", "-MANIFESTFILE linker option
 ---
 # /MANIFESTFILE (Name Manifest File)
 
-```cmd
-/MANIFESTFILE:filename
-```
+## Syntax
+
+> /MANIFESTFILE:filename
+
+## Argument
+
+`filename`\
+The name of the manifest file.
 
 ## Remarks
 
diff --git a/docs/build/reference/manifestinput-specify-manifest-input.md b/docs/build/reference/manifestinput-specify-manifest-input.md
@@ -10,7 +10,7 @@ Specifies a manifest input file to include in the manifest that's embedded in th
 
 ## Syntax
 
-> **`/MANIFESTINPUT:`***`filename`*
+> **/MANIFESTINPUT:*filename*
 
 ### Parameters
 
diff --git a/docs/build/reference/map-generate-mapfile.md b/docs/build/reference/map-generate-mapfile.md
@@ -7,11 +7,11 @@ helpviewer_keywords: ["mapfiles, creating linker", "generate mapfile linker opti
 ---
 # /MAP (Generate Mapfile)
 
-```cmd 
-/MAP[:filename]
-```
+## Syntax
 
-## Arguments
+> /MAP[:filename]
+
+## Argument
 
 *`filename`*\
 A user-specified name for the mapfile. It replaces the default name. Must not exceed `MAX_PATH` (260) characters.
diff --git a/docs/build/reference/out-output-file-name.md b/docs/build/reference/out-output-file-name.md
@@ -7,9 +7,7 @@ helpviewer_keywords: ["output files, name linker option", "-OUT linker option",
 ---
 # /OUT (Output File Name)
 
-```cmd
-/OUT:filename
-```
+> /OUT:filename
 
 ## Arguments
 
diff --git a/docs/build/reference/pdb-use-program-database.md b/docs/build/reference/pdb-use-program-database.md
@@ -7,9 +7,11 @@ helpviewer_keywords: ["-PDB linker option", "/PDB linker option", "PDB linker op
 ---
 # /PDB (Use Program Database)
 
-```cmd
-/PDB:filename
-```
+Specify the name of the program database (PDB) file that the linker creates.
+
+## Syntax
+
+> /PDB:filename
 
 ## Arguments
 
@@ -29,9 +31,7 @@ For more information, see [.pdb Files as Linker Input](dot-pdb-files-as-linker-i
 ### To set this linker option in the Visual Studio development environment
 
 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
-
 1. Select the **Configuration Properties** > **Linker** > **Debug** property page.
-
 1. Modify the **Generate Program Database File** property.
 
 ### To set this linker option programmatically
diff --git a/docs/build/reference/pdbaltpath-use-alternate-pdb-path.md b/docs/build/reference/pdbaltpath-use-alternate-pdb-path.md
@@ -7,9 +7,11 @@ helpviewer_keywords: [".pdb files, path", "PDBALTPATH dumpbin option", "-PDBALTP
 ---
 # /PDBALTPATH (Use Alternate PDB Path)
 
-```cmd
-/PDBALTPATH:pdb_file_name
-```
+Provide an alternate location for the Program Database (`.pdb`) file in a compiled binary file.
+
+## Syntax
+
+> /PDBALTPATH:pdb_file_name
 
 ## Arguments
 
@@ -20,7 +22,7 @@ The path and file name for the `.pdb` file. The *`pdb_file_name`* must not excee
 
 Use this option to provide an alternate location for the Program Database (`.pdb`) file in a compiled binary file. Normally, the linker records the location of the `.pdb` file in the binaries that it produces. You can use this option to provide a different path and file name for the `.pdb` file. The information provided with `/PDBALTPATH` does not change the location or name of the actual `.pdb` file; it changes the information that the linker writes in the binary file. This enables you to provide a path that is independent of the file structure of the build computer. Two common uses for this option are to provide a network path or a file that has no path information.
 
-The value of *`pdb_file_name`* can be an arbitrary string, an environment variable, or `%_PDB%`. The linker will expand an environment variable, such as `%SystemRoot%`, to its value. The linker defines the environment variables `%_PDB%` and **%_EXT%**. `%_PDB%` expands to the file name of the actual `.pdb` file without any path information and `%_EXT%` is the extension of the generated executable.
+The value of *`pdb_file_name`* can be an arbitrary string, an environment variable, or `%_PDB%`. The linker will expand an environment variable, such as `%SystemRoot%`, to its value. The linker defines the environment variables `%_PDB%` and `%_EXT%`. `%_PDB%` expands to the file name of the actual `.pdb` file without any path information and `%_EXT%` is the extension of the generated executable.
 
 ## See also
 
diff --git a/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md b/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md
@@ -20,7 +20,7 @@ Specifies the name of the `.pgd` file that is used to hold information about the
 
 ## Remarks
 
-When using the deprecated [`/LTCG:PGINSTRUMENT`](ltcg-link-time-code-generation.md) option, use **`/PGD`** to specify a nondefault name or location for the .pgd file. If you do not specify **`/PGD`**, the `.pgd` file base name is the same as the output file (`.exe` or `.dll`) base name and is created in the same directory from which the link was invoked.
+When using the deprecated [`/LTCG:PGINSTRUMENT`](ltcg-link-time-code-generation.md) option, use **`/PGD`** to specify a nondefault name or location for the `.pgd` file. If you don't specify **`/PGD`**, the `.pgd` file base name is the same as the output file (`.exe` or `.dll`) base name and is created in the same directory from which the link was invoked.
 
 When using the deprecated **`/LTCG:PGOPTIMIZE`** option, use the **`/PGD`** option to specify the name of the `.pgd` file to use to create the optimized image. The *`filename`* argument should match the *`filename`* specified to **`/LTCG:PGINSTRUMENT`**.
 
