Merge pull request #2067 from MicrosoftDocs/master

6/3/2019 AM Publish

Author: Taojunshen

docs/build/reference/fp-name-dot-pch-file.md

@@ -1,11 +1,12 @@
 ---
-title: "/Fp (Name .Pch File)"
-ms.date: "11/04/2016"
+title: "/Fp (Name .pch file)"
+description: "Use the /Fp compiler option to specify the precompiled header file name."
+ms.date: "05/31/2019"
 f1_keywords: ["VC.Project.VCCLCompilerTool.PrecompiledHeaderFile", "/fp", "VC.Project.VCCLWCECompilerTool.PrecompiledHeaderFile"]
 helpviewer_keywords: ["Fp compiler option [C++]", "-Fp compiler option [C++]", "naming precompiler header files", "PCH files, naming", "names [C++], PCH", ".pch files, naming", "precompiled header files, naming", "/Fp compiler option [C++]"]
 ms.assetid: 0fcd9cbd-e09f-44d3-9715-b41efb5d0be2
 ---
-# /Fp (Name .Pch File)
+# /Fp (Name .pch file)
 
 Provides a path name for a precompiled header instead of using the default path name.
 
@@ -15,39 +16,33 @@ Provides a path name for a precompiled header instead of using the default path
 
 ## Remarks
 
-Use this option with [/Yc (Create Precompiled Header File)](yc-create-precompiled-header-file.md) or [/Yu (Use Precompiled Header File)](yu-use-precompiled-header-file.md) to provide a path name for a precompiled header instead of using the default path name. You can also use **/Fp** with **/Yc** to specify the use of a precompiled header file that differs from the **/Yc**<em>filename</em> argument and from the base name of the source file.
+Use the **/Fp** option with [/Yc (Create Precompiled Header File)](yc-create-precompiled-header-file.md) or [/Yu (Use Precompiled Header File)](yu-use-precompiled-header-file.md) to specify the path and file name for the precompiled header (PCH) file. By default, the **/Yc** option creates a PCH file name by using the base name of the source file and a *pch* extension.
 
-If you do not specify an extension as part of the path name, an extension of .pch is assumed. If you specify a directory without a file name, the default file name is VC*x*0.pch, where *x* is the major version of Visual C++ in use.
-
-You can also use the **/Fp** option with **/Yu**.
+If you don't specify an extension as part of the *pathname*, an extension of *pch* is assumed. When you specify a directory name by use of a slash (**/**) at the end of *pathname*, the default file name is vc*version*0.pch, where *version* is the major version of the Visual Studio toolset. This directory must exist, or error C1083 is generated.
 
 ### To set this compiler option in the Visual Studio development environment
 
 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
 
-1. Click the **C/C++** folder.
-
-1. Click the **Precompiled Headers** property page.
+1. Open the **Configuration Properties** > **C/C++** > **Precompiled Headers** property page.
 
-1. Modify the **Precompiled Header File** property.
+1. Modify the **Precompiled Header Output File** property.
 
 ### To set this compiler option programmatically
 
-- See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.PrecompiledHeaderFile%2A>.
+- See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AdditionalOptions%2A>.
 
-## Example
+## Examples
 
-If you want to create a precompiled header file for a debugging version of your program and you are compiling both header files and source code, you can specify a command such as:
+To create a separate named version of the precompiled header file for the debug build of your program, you can specify a command such as:
 
-```
+```CMD
 CL /DDEBUG /Zi /Yc /FpDPROG.PCH PROG.CPP
 ```
 
-## Example
+The following command specifies the use of a precompiled header file named MYPCH.pch. The compiler precompiles the source code in PROG.cpp through the end of MYAPP.h, and puts the precompiled code in MYPCH.pch. It then uses the content of MYPCH.pch and compiles the rest of PROG.cpp to create an .obj file. The output of this example is a file named PROG.exe.
 
-The following command specifies the use of a precompiled header file named MYPCH.pch. The compiler assumes that the source code in PROG.cpp has been precompiled through MYAPP.h and that the precompiled code resides in MYPCH.pch. It uses the content of MYPCH.pch and compiles the rest of PROG.cpp to create an .obj file. The output of this example is a file named PROG.exe.
-
-```
+```CMD
 CL /YuMYAPP.H /FpMYPCH.PCH PROG.CPP
 ```