Skip to content

Commit 139fb52

Browse files
TylerMSFTTylerMSFT
authored andcommitted
tech feedback
1 parent 6c54399 commit 139fb52

File tree

2 files changed

+4
-4
lines changed

2 files changed

+4
-4
lines changed

docs/build-insights/tutorials/build-insights-function-view.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Set the optimization level to maximum optimizations:
4444

4545
- In the **Solution Explorer**, right-click the project name and select **Properties**.
4646
- In the project properties, navigate to **C/C++** > **Optimization**.
47-
- Set the **Optimization** dropdown to **Maximum Optimization (Favor Speed) (/O2)**.
47+
- Set the **Optimization** dropdown to **Maximum Optimization (Favor Speed) ([`/O2`](../../build/reference/ob-inline-function-expansion.md))**.
4848

4949
:::image type="content" source="./media/max-optimization-setting.png" alt-text="Screenshot showing the project property pages dialog. The settings are open to Configuration Properties > C/C++ > Optimization. The Optimization dropdown is set to Maximum Optimization (Favor Speed) (/O2)":::
5050

@@ -60,13 +60,13 @@ When the build finishes, an Event Trace Log (ETL) file opens. It's saved in the
6060

6161
## Function view
6262

63-
In the window for the ETL file, choose the **Functions** tab. It shows the functions that were compiled and the time it took to compile each function. If the amount of code generated for a function is negligible, it won't appear in the list to avoid degrading build event collection performance.
63+
In the window for the ETL file, choose the **Functions** tab. It shows the functions that were compiled and the time it took to generate the code for each function. If the amount of code generated for a function is negligible, it won't appear in the list to avoid degrading build event collection performance.
6464

6565
:::image type="complex" source="./media/functions-view-before-fix.png" alt-text="Screenshot of the Build Insights Functions view file.":::
6666
In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon.:::
6767
:::image-end:::
6868

69-
The **Time [sec, %]** column shows how long it took to compile each function in [wall clock time](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). Wall clock time aggregates the time it takes to compile a function across multiple compiler threads. It may only take a second to compile a function by your watch, but if the work to compile that function during that second was split across 3 threads, then the wall clock time is 3 seconds.
69+
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). Wall clock responsibility time aggregates the time it takes to compile a function across multiple compiler threads. It may only take a second to compile a function by your watch, but if the work to compile that function during that second was split across 3 threads, then the reported time is 3 seconds.
7070

7171
The **Forceinline Size** column shows roughly how many instructions were generated for the function. Click the chevron before the function name to see the individual inlined functions that were expanded in that function how roughly how many instructions were generated for each.
7272

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 time](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 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 wall clock 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 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.
6464

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

0 commit comments

Comments
 (0)