Skip to content

Commit da1b2f3

Browse files
CopilotTylerMSFT
andcommitted
Improve clarity and remove redundancy in module trace guidance
Co-authored-by: TylerMSFT <[email protected]>
1 parent 6cd5f31 commit da1b2f3

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -315,12 +315,12 @@ Finally, attach the preprocessed repro files (*filename*.i and *modulename*.i) a
315315

316316
When issues involve C++ modules, providing a module trace file along with the preprocessed repro improves diagnostic quality and reduces turnaround time. A module trace file records detailed information about module operations during compilation.
317317

318-
1. In the developer command prompt console window, enter the command **cl /d1module:enableLogging** *trace.json* *arguments* *filename.cpp*. The *trace.json* is the desired output file name for the module trace. The *arguments* are the compilation arguments, and *filename.cpp* is the source file that reproduces the problem.
318+
1. In the developer command prompt console window, enter the command **cl /d1module:enableLogging** *trace.json* *arguments* *filename.cpp*. For *trace.json*, specify the desired output file name for the module trace. For *arguments*, use the compilation arguments. For *filename.cpp*, specify the source file that reproduces the problem.
319319

320320
> [!IMPORTANT]
321321
> You must compile exactly one source file to collect a module trace. Don't use the **/MP** (multi-processor compilation) option or invoke the compiler with multiple source files. Using **/MP** or multi-source invocations can cause the trace to represent only the last compiled file or be incomplete.
322322
323-
1. If multiple translation units are involved in the problem, run separate single-file invocations to collect a trace for each relevant file. Focus on the specific file that reproduces the problem, and optionally collect one trace per relevant file.
323+
1. If multiple translation units are involved in the problem, run separate single-file invocations to collect a trace for the specific file that reproduces the problem. You can collect traces for additional relevant files if needed.
324324

325325
Finally, attach the generated *trace.json* file along with the preprocessed repro to your report.
326326

0 commit comments

Comments
 (0)