Fixes per comments by Kevin, YongKang

Colin Robertson · Colin Robertson · commit f2cbb18dbd4b · 2019-09-26T11:00:32.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 use for generated link repro artifacts.|
+|[/LINKREPROTARGET](linkreprotarget.md)|Specifies a file name to filter generated link repro artifacts.|
 |[/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
@@ -20,13 +20,19 @@ The user-specified directory to store the link repro in. Directory names that in
 
 ## Remarks
 
+::: moniker range=">=vs-2019"
+
 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.
 
 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 set a link repro file name, see the [/LINKREPROTARGET](linkreprotarget.md) linker option. This option can be used to specify different names for different link repros. It's useful in complex builds that invoke the linker more than once.
+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.
 
 ### To set this linker option in the Visual Studio development environment
 
diff --git a/docs/build/reference/linkreprotarget.md b/docs/build/reference/linkreprotarget.md
@@ -7,7 +7,7 @@ helpviewer_keywords: ["LINKREPROTARGET linker option", "/LINKREPROTARGET linker
 ---
 # /LINKREPROTARGET (Link repro file name)
 
-Tells the linker to generate a link repro that has a specified file name.
+Tells the linker to generate a link repro filtered by the specified file name.
 
 ## Syntax
 
@@ -16,15 +16,23 @@ Tells the linker to generate a link repro that has a specified file name.
 ### Arguments
 
 **/LINKREPROTARGET:**_file-name_\
-The user-specified file name to store the link repro in. File names that include spaces must be enclosed in double quotes.
+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.
 
 ## Remarks
 
-The **/LINKREPROTARGET** linker option is used to specify a file name for a *link repro*. 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 different name for each link repro.
+::: moniker range=">=vs-2019"
+
+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.
 
 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).
 
-To specify a **/LINKREPROTARGET** linker option, the **/LINKREPRO** and  [/OUT](out-output-file-name.md) linker options must also be set.
+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.
 
 ### To set this linker option in the Visual Studio development environment
 
diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md
@@ -312,7 +312,7 @@ Finally, attach the preprocessed repro files (*filename*.i and *modulename*.i) a
 
 ### Link repros
 
-A *link repro* is the linker-generated contents of a directory specified either by the **link\_repro** environment variable, or as an argument to the [/LINKREPRO](../build/reference/linkrepro.md) linker option. It contains build artifacts that collectively demonstrate a problem that occurs at link time. Examples include a backend crash involving Link-Time Code Generation (LTCG), or a linker crash. These build artifacts are the ones needed as linker input so the problem can be reproduced. A link repro can be created easily by using this environment variable. It enables the linker's built-in repro generation capability.
+A *link repro* is the linker-generated contents of a directory, specified either by the **link\_repro** environment variable, or as an argument to the [/LINKREPRO](../build/reference/linkrepro.md) linker option. It contains build artifacts that collectively demonstrate a problem that occurs at link time. Examples include a backend crash involving Link-Time Code Generation (LTCG), or a linker crash. These build artifacts are the ones needed as linker input so the problem can be reproduced. A link repro can be created easily by using this environment variable. It enables the linker's built-in repro generation capability.
 
 #### To generate a link repro using the link_repro environment variable
 
@@ -336,7 +336,7 @@ A *link repro* is the linker-generated contents of a directory specified either
 
 Finally, package the repro by compressing the entire linkrepro directory into a .zip file or similar, and attach it to your report.
 
-The **/LINKREPRO** linker option has the same effect as the **link\_repro** environment variable. You can use the [/LINKREPROTARGET](../build/reference/linkreprotarget.md) option to specify the name to use for the generated link repro. To use **/LINKREPROTARGET**, you must also specify the **/OUT** linker option.
+The **/LINKREPRO** linker option has the same effect as the **link\_repro** environment variable. You can use the [/LINKREPROTARGET](../build/reference/linkreprotarget.md) option to specify the name to filter on for the generated link repro. To use **/LINKREPROTARGET**, you must also specify the **/OUT** linker option.
 
 #### To generate a link repro using the /LINKREPRO option
 
