Fix issues raised in #2272

Author: Colin Robertson

docs/preprocessor/comment-c-cpp.md

@@ -21,12 +21,6 @@ The *comment-type* is one of the predefined identifiers, described below, that s
 
 Places the name and version number of the compiler in the object file. This comment record is ignored by the linker. If you supply a *comment-string* parameter for this record type, the compiler generates a warning.
 
-### exestr
-
-Places *comment-string* in the object file. At link time this string is placed in the executable file. The string is not loaded into memory when the executable file is loaded; however, it can be found with a program that finds printable strings in files. One use for this comment-record type is to embed a version number or similar information in an executable file.
-
-`exestr` is deprecated and will be removed in a future release; the linker does not process the comment record.
-
 ### lib
 
 Places a library-search record in the object file. This comment type must be accompanied by a *comment-string* parameter containing the name (and possibly the path) of the library that you want the linker to search. The library name follows the default library-search records in the object file; the linker searches for this library just as if you had named it on the command line provided that the library is not specified with [/nodefaultlib](../build/reference/nodefaultlib-ignore-libraries.md). You can place multiple library-search records in the same source file; each record appears in the object file in the same order in which it is encountered in the source file.

docs/preprocessor/compiler-warnings-that-are-off-by-default.md

@@ -1,5 +1,5 @@
 ---
-title: "Compiler Warnings That Are Off by Default"
+title: "Compiler warnings that are off by default"
 ms.date: "08/29/2019"
 helpviewer_keywords: ["warnings, compiler", "cl.exe compiler, setting options"]
 ms.assetid: 69809cfb-a38a-4035-b154-283a61938df8

docs/preprocessor/component.md

@@ -60,11 +60,11 @@ To prevent the preprocessor from expanding *name* (such as expanding NULL to 0),
 #pragma component(browser, off, references, "NULL")
 ```
 
-### Minimal Rebuild
+### Minimal rebuild
 
 The deprecated [/Gm (Enable Minimal Rebuild)](../build/reference/gm-enable-minimal-rebuild.md) feature requires the compiler to create and store C++ class dependency information, which takes disk space. To save disk space, you can use `#pragma component( minrebuild, off )` whenever you don't need to collect dependency information, for instance, in unchanging header files. Insert `#pragma component( minrebuild, on )` after unchanging classes to turn dependency collection back on.
 
-### Reduce Type Information
+### Reduce type information
 
 The `mintypeinfo` option reduces the debugging information for the region specified. The volume of this information is considerable, impacting .pdb and .obj files. You cannot debug classes and structures in the mintypeinfo region. Use of the mintypeinfo option can be helpful to avoid the following warning:
 

docs/preprocessor/embedded-idl.md

@@ -33,8 +33,6 @@ Type information imported from *type-library* isn't present in the IDL generated
 #import "\school\bin\importlib.tlb" embedded_idl("no_emitidl")
 ```
 
-## Remarks
-
 **END C++ Specific**
 
 ## See also

docs/preprocessor/hash-import-directive-cpp.md

@@ -64,7 +64,7 @@ One or more [#import attributes](#_predir_the_23import_directive_import_attribut
 
 ## Remarks
 
-## <a name="_predir_the_23import_directive_searchorderforfilename"></a> Search order for filename
+### <a name="_predir_the_23import_directive_searchorderforfilename"></a> Search order for filename
 
 *filename* is optionally preceded by a directory specification. The file name must name an existing file. The difference between the two syntax forms is the order in which the preprocessor searches for the type library files when the path is incompletely specified.
 
@@ -73,7 +73,7 @@ One or more [#import attributes](#_predir_the_23import_directive_import_attribut
 |Quoted form|Instructs the preprocessor to look for type library files first in the directory of the file that contains the **#import** statement, and then in the directories of whatever files include (`#include`) that file. The preprocessor then searches along the paths shown below.|
 |Angle-bracket form|Instructs the preprocessor to search for type library files along the following paths:<br /><br /> 1.  The `PATH` environment variable path list<br />2.  The `LIB` environment variable path list<br />3.  The path specified by the [/I](../build/reference/i-additional-include-directories.md) compiler option, except it the compiler is searching for a type library that was referenced from another type library with the [no_registry](../preprocessor/no-registry.md) attribute.|
 
-## <a name="_predir_the_23import_directive_specifyingthelocalizationidandversionnumber"></a> Specify the localization ID and version number
+### <a name="_predir_the_23import_directive_specifyingthelocalizationidandversionnumber"></a> Specify the localization ID and version number
 
 When you specify a progid, you can also specify the localization ID and version number of the progid. For example:
 
@@ -91,7 +91,7 @@ If you don't specify a localization ID, a progid is chosen according to the foll
 
 - If you don't specify a version number, the most recent version is used.
 
-##  <a name="_predir_the_23import_directive_header_files_created_by_import"></a> Header files created by import
+###  <a name="_predir_the_23import_directive_header_files_created_by_import"></a> Header files created by import
 
 **#import** creates two header files that reconstruct the type library contents in C++ source code. The primary header file is similar to the one produced by the Microsoft Interface Definition Language (MIDL) compiler, but with additional compiler-generated code and data. The [primary header file](#_predir_the_primary_type_library_header_file) has the same base name as the type library, plus a .TLH extension. The secondary header file has the same base name as the type library, with a .TLI extension. It contains the implementations for compiler-generated member functions, and is included (`#include`) in the primary header file.
 
@@ -163,7 +163,7 @@ The actual filename in the **#import** comment is the full path of the cross-ref
 
 To resolve dependency errors, determine which of the dependency comments aren't otherwise provided for by system headers, and then provide an **#import** directive at some point before the **#import** directive of the dependent type library.
 
-## <a name="_predir_the_23import_directive_import_attributes"></a> #import attributes
+### <a name="_predir_the_23import_directive_import_attributes"></a> #import attributes
 
 **#import** can optionally include one or more attributes. These attributes tell the compiler to modify the contents of the type-library headers. A backslash (**\\**) symbol can be used to include additional lines in a single **#import** statement. For example:
 

docs/preprocessor/named-guids.md

@@ -15,8 +15,6 @@ Tells the compiler to define and initialize GUID variables in the old style, of
 
 > **#import** *type-library* **named_guids**
 
-## Remarks
-
 **END C++ Specific**
 
 ## See also

docs/preprocessor/no-search-namespace.md

@@ -15,8 +15,6 @@ Has the same functionality as the [no_namespace](../preprocessor/no-namespace.md
 
 > **#import** *type-library* **no_search_namespace**
 
-## Remarks
-
 **END C++ Specific**
 
 ## See also

docs/preprocessor/pointers-to-members.md

@@ -44,7 +44,7 @@ The *most-general-representation* argument specifies the smallest pointer repres
 #pragma pointers_to_members( full_generality, single_inheritance )
 ```
 
-## END C++ Specific
+**END C++ Specific**
 
 ## See also
 

docs/preprocessor/pragma-directives-and-the-pragma-keyword.md

@@ -36,13 +36,12 @@ The Microsoft C and C++ compilers recognize the following pragmas:
 |[function](../preprocessor/function-c-cpp.md)|[hdrstop](../preprocessor/hdrstop.md)|[include_alias](../preprocessor/include-alias.md)|
 |[init_seg](../preprocessor/init-seg.md) <sup>1</sup>|[inline_depth](../preprocessor/inline-depth.md)|[inline_recursion](../preprocessor/inline-recursion.md)|
 |[intrinsic](../preprocessor/intrinsic.md)|[loop](../preprocessor/loop.md) <sup>1</sup>|[make_public](../preprocessor/make-public.md)|
-|[managed](../preprocessor/managed-unmanaged.md)|[message](../preprocessor/message.md)||
-|[omp](../preprocessor/omp.md)|[once](../preprocessor/once.md)||
-|[optimize](../preprocessor/optimize.md)|[pack](../preprocessor/pack.md)|[pointers_to_members](../preprocessor/pointers-to-members.md) <sup>1</sup>|
-|[pop_macro](../preprocessor/pop-macro.md)|[push_macro](../preprocessor/push-macro.md)|[region, endregion](../preprocessor/region-endregion.md)|
-|[runtime_checks](../preprocessor/runtime-checks.md)|[section](../preprocessor/section.md)|[setlocale](../preprocessor/setlocale.md)|
-|[strict_gs_check](../preprocessor/strict-gs-check.md)|[unmanaged](../preprocessor/managed-unmanaged.md)|[vtordisp](../preprocessor/vtordisp.md) <sup>1</sup>|
-|[warning](../preprocessor/warning.md)|||
+|[managed](../preprocessor/managed-unmanaged.md)|[message](../preprocessor/message.md)|[omp](../preprocessor/omp.md)|
+|[once](../preprocessor/once.md)|[optimize](../preprocessor/optimize.md)|[pack](../preprocessor/pack.md)|
+|[pointers_to_members](../preprocessor/pointers-to-members.md) <sup>1</sup>|[pop_macro](../preprocessor/pop-macro.md)|[push_macro](../preprocessor/push-macro.md)|
+|[region, endregion](../preprocessor/region-endregion.md)|[runtime_checks](../preprocessor/runtime-checks.md)|[section](../preprocessor/section.md)|
+|[setlocale](../preprocessor/setlocale.md)|[strict_gs_check](../preprocessor/strict-gs-check.md)|[unmanaged](../preprocessor/managed-unmanaged.md)|
+|[vtordisp](../preprocessor/vtordisp.md) <sup>1</sup>|[warning](../preprocessor/warning.md)||
 
 <sup>1</sup> Supported only by the C++ compiler.