From e29fdc738a706629530e2f2f8e97fcf44163fba4 Mon Sep 17 00:00:00 2001 From: Steven White <31261191+stevewhims@users.noreply.github.com> Date: Tue, 29 Mar 2022 19:27:18 -0700 Subject: [PATCH] polish (#2412) --- windows-apps-src/cpp-and-winrt-apis/index.md | 2 +- windows-apps-src/cpp-and-winrt-apis/macros.md | 13 +++++++------ 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/windows-apps-src/cpp-and-winrt-apis/index.md b/windows-apps-src/cpp-and-winrt-apis/index.md index 2d726396f5..f3bbb23126 100644 --- a/windows-apps-src/cpp-and-winrt-apis/index.md +++ b/windows-apps-src/cpp-and-winrt-apis/index.md @@ -80,7 +80,7 @@ Also see [Where can I find C++/WinRT sample apps?](./faq.yml#where-can-i-find-c- | [Windows Runtime components with C++/WinRT](../winrt-components/create-a-windows-runtime-component-in-cppwinrt.md) | This topic shows how to use C++/WinRT to create and consume a Windows Runtime component—a component that's callable from a Universal Windows app built using any Windows Runtime language. | | [Authoring a C# Windows Runtime component for use from a C++/WinRT app](../cpp-and-winrt-apis/use-csharp-component-from-cpp-winrt.md) | This topic walks you through the process of adding a simple C# component to your C++/WinRT project. | | [Visual Studio native debug visualization (natvis) for C++/WinRT](./natvis.md) | The [C++/WinRT Visual Studio Extension (VSIX)](https://marketplace.visualstudio.com/items?itemName=CppWinRTTeam.cppwinrt101804264) gives you Visual Studio native debug visualization (natvis) of C++/WinRT projected types. This provides you an experience similar to C# debugging. | -| [Configuration macros](./macros.md) | Descriptions of the C++/WinRT configuration macros. | +| [Configuration macros](./macros.md) | This topic describes the C++/WinRT configuration macros. | | [C++/WinRT naming conventions](./naming.md) | This topic explains naming conventions that C++/WinRT has established. | ### Topics about the C++ language diff --git a/windows-apps-src/cpp-and-winrt-apis/macros.md b/windows-apps-src/cpp-and-winrt-apis/macros.md index 6a2c475e6b..cc6f27add1 100644 --- a/windows-apps-src/cpp-and-winrt-apis/macros.md +++ b/windows-apps-src/cpp-and-winrt-apis/macros.md @@ -1,6 +1,6 @@ --- title: C++/WinRT configuration macros -description: Descriptions of the C++/WinRT configuration macros. +description: This topic describes the C++/WinRT configuration macros. ms.date: 03/29/2022 ms.topic: article keywords: windows 10, uwp, standard, c++, cpp, winrt, projection, configuration, macros @@ -8,7 +8,8 @@ ms.localizationpriority: medium --- # C++/WinRT configuration macros -Unless otherwise noted, these rules apply to C++/WinRT configuration macros: + +This topic describes the C++/WinRT configuration macros. Unless otherwise noted, these rules apply to all of the C++/WinRT configuration macros: * All files that are linked together to form a single module (`.exe` or `.dll`) must have identical macro settings. That includes static libraries. * All macro settings must be complete before including any C++/WinRT header file. @@ -33,12 +34,12 @@ These macros allow you to customize assertion handling. **WINRT_ASSERT** doesn't If you don't customize these macros, and **_DEBUG** is defined, then C++/WinRT makes them equivalent to **_ASSERTE**. -If you don't customize these macros, and **_DEBUG** is not defined, then C++/WinRT defines **WINRT_ASSERT** to discard the expression unevaluated, and **WINRT_VERIFY** to discard the expression after evaluating it. +If you don't customize these macros, and **_DEBUG** is not defined, then C++/WinRT defines **WINRT_ASSERT** to discard the expression unevaluated, and defines **WINRT_VERIFY** to discard the expression after evaluating it. ## WINRT_NO_MAKE_DETECTION -If defined, disables the default C++/WinRT diagnostic that detects that you constructed an implementation class without using [**winrt::make**](/uwp/cpp-ref-for-winrt/make). +If defined, disables the default C++/WinRT diagnostic that detects that you mistakenly constructed an implementation class without using [**winrt::make**](/uwp/cpp-ref-for-winrt/make). -We strongly recommended that you not define this symbol, because it masks a common source of programming errors. +We strongly recommended that you don't define this symbol, because doing so masks a common source of programming errors. ## WINRT_DIAGNOSTICS If defined, enables internal statistics to track various operations: @@ -46,7 +47,7 @@ If defined, enables internal statistics to track various operations: * The number of times each factory was requested (and whether the factory is agile). ## WINRT_NATVIS -If defined, includes helper functions to assist in native debug visualizations in Visual Studio. The code is not used at runtime; it exists only for debugging. +If defined, includes helper functions to assist in native debug visualizations in Visual Studio. The code isn't used at runtime; it exists only for debugging. If you don't customize this macro, then visualization support functions are enabled if **_DEBUG** is defined. For more details, see [Visual Studio native debug visualization (natvis) for C++/WinRT](natvis.md).