More updates per YongKang

Colin Robertson · Colin Robertson · commit b35ecad65d6f · 2019-09-27T15:52:37.000-07:00
diff --git a/docs/build/reference/linker-options.md b/docs/build/reference/linker-options.md
@@ -77,7 +77,7 @@ You can use the [comment](../../preprocessor/comment-c-cpp.md) pragma to specify
 |[/LARGEADDRESSAWARE](largeaddressaware-handle-large-addresses.md)|Tells the compiler that the application supports addresses larger than two gigabytes|
 |[/LIBPATH](libpath-additional-libpath.md)|Specifies a path to search before the environmental library path.|
 |[/LINKREPRO](linkrepro.md)|Specifies a path to generate link repro artifacts in.|
-|[/LINKREPROTARGET](linkreprotarget.md)|Specifies a file name to filter generated link repro artifacts.|
+|[/LINKREPROTARGET](linkreprotarget.md)|Generates a link repro only when producing the specified target.|
 |[/LTCG](ltcg-link-time-code-generation.md)|Specifies link-time code generation.|
 |[/MACHINE](machine-specify-target-platform.md)|Specifies the target platform.|
 |[/MANIFEST](manifest-create-side-by-side-assembly-manifest.md)|Creates a side-by-side manifest file and optionally embeds it in the binary.|
diff --git a/docs/build/reference/linkrepro.md b/docs/build/reference/linkrepro.md
@@ -1,13 +1,13 @@
 ---
 title: "/LINKREPRO (Link repro directory name)"
-description: Linker option to set the directory for a link repro file.
+description: Linker or library tool option to set the directory for a link repro.
 ms.date: "09/24/2019"
 f1_keywords: ["/LINKREPRO"]
 helpviewer_keywords: ["LINKREPRO linker option", "/LINKREPRO linker option", "-LINKREPRO linker option", "linker repro reporting"]
 ---
 # /LINKREPRO (Link repro directory name)
 
-Tells the linker to generate a link repro in a specified directory.
+Tells the linker or library tool to generate a link repro in a specified directory.
 
 ## Syntax
 
@@ -20,19 +20,11 @@ The user-specified directory to store the link repro in. Directory names that in
 
 ## Remarks
 
-::: moniker range=">=vs-2019"
+The **/LINKREPRO** option is used to create a *link repro*. It's a set of build artifacts that allow Microsoft to reproduce a problem that occurs at link time, or during library operations. It's useful for problems such as a backend crash involving Link-Time Code Generation (LTCG), an LNK1000 linker error, or a linker crash. The tool produces a link repro when you specify the **/LINKREPRO** linker option, or when you set the `link_repro` environment variable in your command-line build environment. For more information, see the [Link repros](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md#link-repros) section of [How to report a problem with the Microsoft C++ toolset](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md).
 
-The **/LINKREPRO** linker option is used to create a *link repro*. It's a set of build artifacts that allow Microsoft to reproduce a problem that occurs at link time. It's useful for problems such as a backend crash involving Link-Time Code Generation (LTCG), an LNK1000 linker error, or a linker crash. The linker produces a link repro when you specify the **/LINKREPRO** linker option, or when you set the `link_repro` environment variable in your command-line build environment.
+Both the **/LINKREPRO** linker option and the `link_repro` environment variable require you to specify an output directory for the link repro. On the command line or in the IDE, specify the directory by using a **/LINKREPRO:**_directory-name_ option. The _directory-name_ you specify may be an absolute or relative path, but the directory must exist. The command-line option overrides any directory value set in the `link_repro` environment variable.
 
-Create a link repro to get support for an LTCG crash, a linker crash, or an internal error that happens at link time. For more information, see the [Link repros](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md#link-repros) section of [How to report a problem with the Microsoft C++ toolset](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md).
-
-Both the **/LINKREPRO** linker option and the `link_repro` environment variable require you to specify an output directory for the link repro. On the command line or in the IDE, specify the directory by using a **/LINKREPRO:**_directory-name_ option. The _directory-name_ you specify may be an absolute or relative path, but the directory must exist. The command-line option overrides any directory value set in the `link_repro` environment variable. You must also specify the [/OUT](out-output-file-name.md) linker option when you use the **/LINKREPRO** option.
-
-For information on how to filter link repro generation on a file name, see the [/LINKREPROTARGET](linkreprotarget.md) linker option. This option can be used to specify a specific target to generate a link repro for. It's useful in complex builds that invoke the linker more than once.
-
-::: moniker-end
-
-The **/LINKREPRO** option is available starting in Visual Studio 2019 version 16.1.
+For information on how to limit link repro generation to a specific target file name, see the [/LINKREPROTARGET](linkreprotarget.md) option. This option can be used to specify a specific target to generate a link repro for. It's useful in complex builds that invoke the linker or library tool more than once.
 
 ### To set this linker option in the Visual Studio development environment
 
@@ -42,6 +34,8 @@ The **/LINKREPRO** option is available starting in Visual Studio 2019 version 16
 
 1. Enter the **/LINKREPRO:**_directory-name_ option in the **Additional Options** box. The _directory-name_ value you specify must exist. Choose **OK** to apply the change.
 
+Once you've generated the link repro, open this property page again to remove the **/LINKREPRO** option from your builds.
+
 ### To set this linker option programmatically
 
 - See <xref:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.AdditionalOptions%2A>.
diff --git a/docs/build/reference/linkreprotarget.md b/docs/build/reference/linkreprotarget.md
@@ -1,13 +1,13 @@
 ---
 title: "/LINKREPROTARGET (Link repro file name)"
-description: Linker option to set the directory for a link repro file.
+description: Linker or library tool option to set a target file name for a link repro.
 ms.date: "09/24/2019"
 f1_keywords: ["/LINKREPROTARGET"]
 helpviewer_keywords: ["LINKREPROTARGET linker option", "/LINKREPROTARGET linker option", "-LINKREPROTARGET linker option", "linker repro reporting"]
 ---
 # /LINKREPROTARGET (Link repro file name)
 
-Tells the linker to generate a link repro filtered by the specified file name.
+Tells the linker or library tool to generate a link repro only when the target has the specified file name.
 
 ## Syntax
 
@@ -16,23 +16,17 @@ Tells the linker to generate a link repro filtered by the specified file name.
 ### Arguments
 
 **/LINKREPROTARGET:**_file-name_\
-The user-specified file name to generate the link repro for. File names that include spaces must be enclosed in double quotes. The file name should include the base name and the extension, but not the path.
+The target file name to filter on. A link repro is only generated when the named file is the output target. File names that include spaces must be enclosed in double quotes. The file name should include the base name and the extension, but not the path.
 
 ## Remarks
 
-::: moniker range=">=vs-2019"
+The **/LINKREPROTARGET** option is used to specify a target file name to generate a *link repro* for. A link repro is a set of build artifacts that allow Microsoft to reproduce a problem that occurs at link time, or during library operations. The linker or library tool produces a link repro when you specify the [/LINKREPRO](linkrepro.md) option, or when you set the `link_repro` environment variable in your command-line build environment.
 
-The **/LINKREPROTARGET** linker option is used to specify a file name to filter *link repro* generation. A link repro is a set of build artifacts that allow Microsoft to reproduce a problem that occurs at link time. The linker produces a link repro when you specify the [/LINKREPRO](linkrepro.md) linker option, or when you set the `link_repro` environment variable in your command-line build environment.
-
-The **/LINKREPROTARGET** linker option is useful in complex builds that invoke the linker more than once. It lets you specify a specific target for the link repro, such as *problem.dll*. This lets you generate the link repro only when you link a specific file.
+The **/LINKREPROTARGET** option is useful in complex builds that invoke the linker or library tool more than once. It lets you specify a specific target for the link repro, such as *problem.dll*. It lets you generate the link repro only when the tool produces a specific file.
 
 For more information about how and when to create a link repro, see the [Link repros](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md#link-repros) section of [How to report a problem with the Microsoft C++ toolset](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md).
 
-The **/LINKREPRO** and  [/OUT](out-output-file-name.md) linker options must be set for the **/LINKREPROTARGET** option to have any effect.
-
-::: moniker-end
-
-The **/LINKREPROTARGET** option is available starting in Visual Studio 2019 version 16.1.
+The **/LINKREPRO** and  [/OUT](out-output-file-name.md) options must be set for the **/LINKREPROTARGET** option to have any effect.
 
 ### To set this linker option in the Visual Studio development environment
 
diff --git a/docs/build/reference/running-lib.md b/docs/build/reference/running-lib.md
@@ -38,16 +38,10 @@ If lib.exe fails at runtime, you can use **/ERRORREPORT** to send information to
 
 For more information about **/ERRORREPORT**, see [/errorReport (Report Internal Compiler Errors)](errorreport-report-internal-compiler-errors.md).
 
-::: moniker range=">=vs-2019"
-
 > **/LINKREPRO:**_directory-path_ \
 > **/LINKREPROTARGET:**_filename_
 
-To help Microsoft diagnose lib.exe crashes and internal errors, you can use the **/LINKREPRO** option. It works the same way as the [/LINKREPRO](linkrepro.md) linker option. The [/LINKREPROTARGET](linkreprotarget.md) option can be used with the **/LINKREPRO** option. It filters on a _filename_, to only generate repro artifacts when lib.exe is used on that file. For more information, see [How to report a problem with the Microsoft C++ toolset](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md).
-
-The **/LINKREPRO** and **/LINKREPROTARGET** options are available starting in Visual Studio 2019 version 16.1.
-
-::: moniker-end
+To help Microsoft diagnose lib.exe crashes and internal errors, you can use the [/LINKREPRO](linkrepro.md) option. It generates a *link repro*, a set of build artifacts that allow Microsoft to reproduce a problem that occurs during library operations. The [/LINKREPROTARGET](linkreprotarget.md) option can be used with the **/LINKREPRO** option. It only generates link repro artifacts when lib.exe produces the specified file. For more information, see [How to report a problem with the Microsoft C++ toolset](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md).
 
 > **/LTCG**
 
