Skip to content

Commit 94c0ed1

Browse files
Update docs/build-insights/tutorials/build-insights-included-files-view.md
Co-authored-by: Nelson Daniel Troncoso <[email protected]>
1 parent 725368a commit 94c0ed1

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

docs/build-insights/tutorials/build-insights-included-files-view.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ This view shows the time spent processing `#include` files.
6060
In the file path column, several files with a fire icon are highlighted because they take over 10% of the build time to parse. winrtHeaders.h is the biggest one at 8.581 seconds or 52.3% of the 16.404 second build time.
6161
:::image-end:::
6262

63-
In the **File Path** column, some files have a fire icon next to them to indicate that they take up 10% or more of the build time. The **Time [sec, %]** column shows the time in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism) spent parsing the header file and what percentage of the overall time it took. Wall clock responsibility time aggregates the time it takes to parse the header file across multiple compiler threads. It may only take a second to parse a header file by your watch, but if the work to parse that header during that second was split across 3 threads, then the reported time is 3 seconds.
63+
In the **File Path** column, some files have a fire icon next to them to indicate that they take up 10% or more of the build time. The **Time [sec, %]** column shows how long it took to compile each function in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time it takes to parse files based on their use of parallel threads. For example, if two files are being parsed simultaneously by two different threads within a one-second period, each file's WCTR would be recorded as 0.5 seconds. This reflects each file's proportional share of the total compilation time, taking into account the resources each consumed during parallel execution. Thus, WCTR provides a better measure of the impact each file has on the overall build time in environments where multiple compilation activities occur simultaneously.
6464

6565
The **Parse Count** column shows how many time the header file was parsed.
6666

0 commit comments

Comments
 (0)