Merge pull request #2271 from mikeblome/mb-resource-props

GitHubber17 · web-flow · commit ae3abedf87b8 · 2019-08-29T14:07:52.000-07:00
updates for resources prop page
diff --git a/docs/build/reference/c-cpp-build-tools.md b/docs/build/reference/c-cpp-build-tools.md
@@ -1,6 +1,6 @@
 ---
 title: "Additional MSVC Build Tools"
-ms.date: "05/06/2019"
+ms.date: "08/28/2019"
 f1_keywords: ["c.build"]
 helpviewer_keywords: ["builds [C++], C/C++ tools", "tools [C++], build"]
 ms.assetid: 48d9daf4-6bbf-473a-8ce2-bf2923b69f80
@@ -9,7 +9,6 @@ ms.assetid: 48d9daf4-6bbf-473a-8ce2-bf2923b69f80
 
 Visual Studio provides the following command-line utilities for viewing or manipulating build output:
 
-
 - [LIB.EXE](lib-reference.md) is used to create and manage a library of Common Object File Format (COFF) object files. It can also be used to create export files and import libraries to reference exported definitions.
 
 - [EDITBIN.EXE](editbin-reference.md) is used to modify COFF binary files.
@@ -20,10 +19,12 @@ Visual Studio provides the following command-line utilities for viewing or manip
 
 - [ERRLOOK](value-edit-control.md), the Error Lookup utility, retrieves a system error message or module error message based on the value entered.
 
-- [XDCMake](xdcmake-reference.md). A toolfor processing source code files that contain documentation comments marked up with XML tags.
+- [XDCMake](xdcmake-reference.md). A tool for processing source code files that contain documentation comments marked up with XML tags.
 
 - [BSCMAKE.EXE](bscmake-reference.md) (provided for backward compatibility only) builds a browse information file (.bsc) that contains information about the symbols (classes, functions, data, macros, and types) in your program. You view this information in browse windows within the development environment. (A .bsc file can also be built in the development environment.)
 
+The Windows SDK also has several build tools, including [RC.EXE](/windows/win32/menurc/resource-compiler), which the C++ compiler invokes to compile native Windows resources such as dialogs, property pages, bitmaps, string tables and so on.
+
 ## See also
 
 [C/C++ Building Reference](c-cpp-building-reference.md)<br/>
diff --git a/docs/build/reference/managed-resources-property-page.md b/docs/build/reference/managed-resources-property-page.md
@@ -1,15 +1,13 @@
 ---
 title: "Managed Resources Property Page"
-ms.date: "11/04/2016"
+ms.date: "08/28/2019"
 f1_keywords: ["VC.Project.VCManagedResourceCompilerTool.ResourceFileName", "VC.Project.VCManagedResourceCompilerTool.OutputFileName", "VC.Project.VCManagedResourceCompilerTool.DefaultLocalizedResources"]
 helpviewer_keywords: ["Managed Resources property page"]
 ms.assetid: 80b80384-ee55-494d-9f0e-907bb98cfc19
 ---
 # Managed Resources Property Page
 
-Enables settings for the resource compiler.
-
-The **Managed Resources** property page contains the following properties:
+The **Managed Resources** property page exposes the following properties for the managed resource compiler [resgen.exe](/dotnet/framework/tools/resgen-exe-resource-file-generator) when using .NET resources in C++/CLI programs:
 
 - **Resource Logical Name**
 
diff --git a/docs/build/reference/media/example-prop-page.png b/docs/build/reference/media/example-prop-page.png
diff --git a/docs/build/reference/property-pages-visual-cpp.md b/docs/build/reference/property-pages-visual-cpp.md
@@ -1,12 +1,16 @@
 ---
-title: "C++ project property page reference - Visual Studio"
-ms.date: "07/24/2019"
+title: "Windows C++ project property page reference - Visual Studio"
+ms.date: "08/28/2019"
 helpviewer_keywords: ["project-file macro", "project properties [C++], default values", "user-defined values", "project properties [C++], setting", "macros, project-file", "property pages, project settings", "C++ projects, properties", "build macro", "user-defined macros"]
 ms.assetid: 13ffe3ea-1bc3-4bee-be5e-053a8a99cce4
 ---
-# C++ project property page reference
+# Windows C++ project property page reference
 
-In Visual Studio, you specify compiler and linker options, file paths, and other build settings through the property pages for the project. To open the **Property Pages**, choose  **Project** > **Properties** from the main menu, or right-click on the project node in **Solution Explorer** and choose **Properties**. For more information about project properties, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
+In Visual Studio, you specify compiler and linker options, file paths, and other build settings through the property pages for the project. The properties and property pages that are available depend on the project type. For example, a makefile project has an NMake property page, which is not present in an MFC or Win32 console project. To open the **Property Pages**, choose  **Project** > **Properties** from the main menu, or right-click on the project node in **Solution Explorer** and choose **Properties**. Individual files also have property pages that enable you to set compile and build options for just that file. The following image shows the property pages for an MFC project.
+
+![Property Pages for C++ project](media/example-prop-page.png)
+
+This section provides a quick reference for the property pages themselves. The options and settings exposed in the property pages are documented more completely in their own topics and are linked from the property page topics. For more information about project properties, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
 
 For property pages in Linux projects, see [Linux C++ Property Page Reference](../../linux/prop-pages-linux.md).
 
@@ -33,4 +37,5 @@ For property pages in Linux projects, see [Linux C++ Property Page Reference](..
 ## See also
 
 [How to: Create and Remove Project Dependencies](/visualstudio/ide/how-to-create-and-remove-project-dependencies)<br/>
-[How to: Create and Edit Configurations](/visualstudio/ide/how-to-create-and-edit-configurations)
+[How to: Create and Edit Configurations](/visualstudio/ide/how-to-create-and-edit-configurations)<br/>
+[Linux C++ Property Page Reference](../../linux/prop-pages-linux.md)
diff --git a/docs/build/reference/resources-property-pages.md b/docs/build/reference/resources-property-pages.md
@@ -1,18 +1,63 @@
 ---
-title: "Resources Property Pages"
-ms.date: "11/04/2016"
-f1_keywords: ["VC.Project.VCResourceCompilerTool.ShowProgress", "VC.Project.VCResourceCompilerTool.AdditionalIncludeDirectories", "VC.Project.VCResourceCompilerTool.PreprocessorDefinitions", "VC.Project.VCResourceCompilerTool.OVERWRITEStandardIncludePath", "VC.Project.VCResourceCompilerTool.Culture", "VC.Project.VCResourceCompilerTool.ResourceOutputFileName"]
-helpviewer_keywords: ["Resources property pages"]
+title: "Resources"
+ms.date: "08/28/2019"
+ms.topic: "article"
 ms.assetid: dade2f6b-c51f-4c33-9023-41956ae4b5f6
+f1_keywords:
+  - VC.Project.VCResourceCompilerTool.PreprocessorDefinitions
+  - VC.Project.VCResourceCompilerTool.UndefineProcessorDefinitions
+  - VC.Project.VCResourceCompilerTool.Culture
+  - VC.Project.VCResourceCompilerTool.AdditionalIncludeDirectories
+  - VC.Project.VCResourceCompilerTool.IgnoreStandardIncludePath
+  - VC.Project.VCResourceCompilerTool.ShowProgress
+  - VC.Project.VCResourceCompilerTool.SuppressStartupBanner
+  - VC.Project.VCResourceCompilerTool.ResourceOutputFileName
+  - VC.Project.VCResourceCompilerTool.NullTerminateStrings
+  - vc.project.AdditionalOptionsPage
 ---
-# Resources Property Pages
 
-For more information on using the resource compiler, see [Using RC (The RC Command Line)](/windows/win32/menurc/using-rc-the-rc-command-line-).
+# Resources property page
 
-For information on how to access the **Resources** property pages, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
+For native Windows desktop programs, the build invokes the [Resource Compiler (rc.exe)](/windows/win32/menurc/resource-compiler) to add images, string tables, and *.res* files to the binary. The properties exposed in this property page are passed to the Resource Compiler, not to the C++ compiler or the linker. For more information on the properties listed here and how they map to RC command-line options, see [Using RC (The RC Command Line)](/windows/win32/menurc/using-rc-the-rc-command-line-). For information on how to access the **Resources** property pages, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). To programmatically access these properties, see <xref:Microsoft.VisualStudio.VCProjectEngine.VCResourceCompilerTool>.
 
-To programmatically access these properties, see <xref:Microsoft.VisualStudio.VCProjectEngine.VCResourceCompilerTool>.
+Properties for .NET resources in C++/CLI applications are exposed in the [Managed Resources Property Page](managed-resources-property-page.md).
+
+## Preprocessor Definitions
+
+Specifies one or more defines for the resource compiler. (/d[macro])
+
+## Undefine Preprocessor Definitions
+
+Undefine a symbol. (/u)
+
+## Culture
+
+Lists the culture (such as US English or Italian) used in the resources. (/l [num])
+
+## Additional Include Directories
+
+Specifies one or more directories to add to the include path; use semi-colon delimiter if more than one. (/I[path])
+
+## Ignore Standard Include Paths
+
+Prevents the resource compiler from searching for include files in directories specified in the INCLUDE environment variables. (/X)
+
+## Show Progress
+
+Send progress messages to output window. (/v)
+
+## Suppress Startup Banner
+
+Suppress the display of the startup banner and information message (/nologo)
+
+## Resource File Name
+
+Specifies the name of the resource file (/fo[file])
+
+## Null Terminate Strings 
+
+Append null's to all strings in the string tables. (/n)
 
 ## See also
 
-[C++ project property page reference](property-pages-visual-cpp.md)
+[C++ project property page reference](property-pages-visual-cpp.md)
