Skip to content

Commit 9ee0c86

Browse files
author
mikeblome
committed
fixed more titles and moved build system changes topic into porting folder
1 parent d0e4bc8 commit 9ee0c86

File tree

325 files changed

+677
-598
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

325 files changed

+677
-598
lines changed

docs/build/TOC.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# [Building C/C++ Projects](building-c-cpp-programs.md)
22
# [Visual Studio Projects - C++](creating-and-managing-visual-cpp-projects.md)
3-
## [Set compiler and build properties](working-with-project-properties.md)
3+
## [Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md)
44
### [Share or reuse Visual Studio project settings](create-reusable-property-configurations.md)
55
### [Project property inheritance](project-property-inheritance.md)
66
### [Modify properties and targets without changing the project file](modify-project-properties-without-changing-project-file.md)
@@ -85,7 +85,7 @@
8585
#### [Exporting and Importing Using AFX_EXT_CLASS](exporting-and-importing-using-afx-ext-class.md)
8686
#### [Exporting C++ Functions for Use in C-Language Executables](exporting-cpp-functions-for-use-in-c-language-executables.md)
8787
#### [Exporting C Functions for Use in C or C++ Language Executables](exporting-c-functions-for-use-in-c-or-cpp-language-executables.md)
88-
#### [Determining Which Exporting Method to Use](determining-which-exporting-method-to-use.md)
88+
#### [Determine Which Exporting Method to Use](determining-which-exporting-method-to-use.md)
8989
#### [Exporting Functions from a DLL by Ordinal Rather Than by Name](exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md)
9090
### [Mutual Imports](mutual-imports.md)
9191
### [Importing and Exporting Inline Functions](importing-and-exporting-inline-functions.md)

docs/build/adding-references-in-visual-cpp-projects.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -157,5 +157,5 @@ The following properties are found on COM and .NET assembly references, and cann
157157

158158
## See Also
159159

160-
[Property Pages](reference/property-pages-visual-cpp.md)<br>
161-
[Set compiler and build properties](working-with-project-properties.md)
160+
[C++ project property page reference](reference/property-pages-visual-cpp.md)<br>
161+
[Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md)

docs/build/building-c-cpp-programs.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ Note that here the compiler (cl.exe) automatically invokes the C++ preprocessor
3535

3636
Most real-world programs use some kind of *build system* to manage complexities of compiling multiple source files for multiple configurations (i.e. debug vs. release), multiple platforms (x86, x64, ARM, and so on), custom build steps, and even multiple executables that must be compiled in a certain order. You make settings in a build configuration file(s), and the build system accepts that file as input before it invoke the compiler. The set of source code files and build configuration files needed to build an executable file is called a *project*.
3737

38-
The following list shows various options for building C++ projects in Visual Studio:
38+
The following list shows various options for Visual Studio Projects - C++:
3939

4040
- create a Visual Studio project by using the Visual Studio IDE and configure it by using property pages. Visual Studio projects produce programs that run on Windows. For an overview, see [Compiling and Building](/visualstudio/ide/compiling-and-building-in-visual-studio) in the Visual Studio documentation.
4141

@@ -74,7 +74,7 @@ How to create, debug and deploy C/C++ DLLs (shared libraries) in Visual Studio.
7474
[Building C/C++ Isolated Applications and Side-by-side Assemblies](building-c-cpp-isolated-applications-and-side-by-side-assemblies.md)
7575
Describes the deployment model for Windows Desktop applications, based on the idea of isolated applications and side-by-side assemblies.
7676

77-
[Configure Visual C++ for 64-bit, x64 targets](configuring-programs-for-64-bit-visual-cpp.md)
77+
[Configure C++ projects for 64-bit, x64 targets](configuring-programs-for-64-bit-visual-cpp.md)
7878
How to target 64-bit x64 hardware with the MSVC build tools.
7979

8080
[Configure Visual C++ for ARM processors](configuring-programs-for-arm-processors-visual-cpp.md)

docs/build/building-on-the-command-line.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ If you've installed the [Build Tools for Visual Studio 2017](https://go.microsof
4444

4545
An even faster way to open a developer command prompt window is to enter *developer command prompt* in the desktop search box, then choose the desired result.
4646

47-
## <a name="developer_command_prompt_file_locations"></a>Developer command file locations
47+
## <a name="developer_command_file_locations"></a> Developer command file locations
4848

4949
If you prefer to set the build architecture environment in an existing command prompt window, you can use one of the command files (batch files) created by the installer to set the required environment. We only recommend you do this in a new command prompt window, and we do not recommend you later switch environments in the same command window. The location of these files depends on the version of Visual Studio you have installed, and on location and naming choices you made during installation. For Visual Studio 2017, the typical installation location on a 64-bit computer is in \Program Files (x86)\Microsoft Visual Studio\2017\\*edition*, where *edition* may be Community, Professional, Enterprise, BuildTools, or another name you supplied. For Visual Studio 2015, the typical installation location is in \Program Files (x86)\Microsoft Visual Studio 14.0.
5050

docs/build/calling-dll-functions-from-visual-basic-applications.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ For DLLs to be called by programs written in Visual Basic, the alias technique s
5353

5454
- [Exporting C++ functions for use in C-language executables](exporting-cpp-functions-for-use-in-c-language-executables.md)
5555

56-
- [Determining which exporting method to use](determining-which-exporting-method-to-use.md)
56+
- [Determine which exporting method to use](determining-which-exporting-method-to-use.md)
5757

5858
- [Decorated names](reference/decorated-names.md)
5959

docs/build/cmake-tools-for-visual-cpp.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: "CMake Projects in Visual C++"
2+
title: "CMake Projects in Visual Studio"
33
ms.date: "10/18/2018"
4-
helpviewer_keywords: ["CMake in Visual C++"]
4+
helpviewer_keywords: ["CMake in Visual Studio"]
55
ms.assetid: 444d50df-215e-4d31-933a-b41841f186f8
66
---
7-
# CMake projects in Visual C++
7+
# CMake projects in Visual Studio
88

99
This article assumes that you are familiar with CMake, a cross-platform, open-source tool for defining build processes that run on multiple platforms.
1010

docs/build/common-visual-cpp-64-bit-migration-issues.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,5 +32,5 @@ For more information, see:
3232

3333
## See Also
3434

35-
[Configure Visual C++ for 64-bit, x64 targets](configuring-programs-for-64-bit-visual-cpp.md)<br/>
35+
[Configure C++ projects for 64-bit, x64 targets](configuring-programs-for-64-bit-visual-cpp.md)<br/>
3636
[Visual C++ Porting and Upgrading Guide](../porting/visual-cpp-porting-and-upgrading-guide.md)

docs/build/configuring-programs-for-64-bit-visual-cpp.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: "Configure Visual C++ for 64-bit, x64 targets"
2+
title: "Configure C++ projects for 64-bit, x64 targets"
33
ms.date: "11/04/2016"
44
helpviewer_keywords: ["64-bit compiler [C++], options", "64-bit compiler [C++]", "64-bit programming [C++], about 64-bit programming", "programming [C++], 64-bit", "Visual C++, 64-bit hardware"]
55
ms.assetid: cb99f72b-8c74-48f4-846a-8921b37b97e9
66
---
7-
# Configure Visual C++ for 64-bit, x64 targets
7+
# Configure C++ projects for 64-bit, x64 targets
88

99
This section contains topics about targeting 64-bit x64 hardware with the Visual C++ build tools.
1010

docs/build/creating-and-managing-visual-cpp-projects.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ To add third-party libraries, use the [vcpkg](../vcpkg.md) package manager. Run
3333

3434
## Set compiler options and other build properties
3535

36-
To configure build settings for a project, right-click on the project in **Solution Explorer** and choose **Properties**. For more information, see [Set compiler and build properties](working-with-project-properties.md).
36+
To configure build settings for a project, right-click on the project in **Solution Explorer** and choose **Properties**. For more information, see [Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md).
3737

3838
## Compile and run
3939

@@ -47,7 +47,7 @@ In the Error List, you can press **F1** on a highlighted error to go to its docu
4747

4848
## In This Section
4949

50-
[Set compiler and build properties](working-with-project-properties.md)<br/>
50+
[Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md)<br/>
5151
How to use Property Pages and Property Sheets to specify your project settings.
5252

5353
[Reference libraries and components at build time](adding-references-in-visual-cpp-projects.md)<br/>

docs/build/creating-precompiled-header-files.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.assetid: e2cdb404-a517-4189-9771-c869c660cb1b
99

1010
When you create a new project in Visual Studio, a *precompiled header file* named "pch.h" is added to the project. (In earlier versions of Visual Studio, the file was called "stdafx.h".) The purpose of the file is to speed up the build process. Any stable header files, for example Standard Library headers such as `<vector>`, should be included here. The precompiled header is compiled only when it, or any files it includes, are modified. If you only make changes in your project source code, the build will skip compilation for the precompiled header.
1111

12-
The compiler options for precompiled headers are [/Y](y-precompiled-headers.md). In the project propery pages, the options are located under **Configuration Properties > C/C++ > Precompiled Headers**. You can choose to not use precompiled headers, and you can specify the header file name and the name and path of the output file.
12+
The compiler options for precompiled headers are [/Y](reference/y-precompiled-headers.md). In the project propery pages, the options are located under **Configuration Properties > C/C++ > Precompiled Headers**. You can choose to not use precompiled headers, and you can specify the header file name and the name and path of the output file.
1313

1414
## Custom precompiled code
1515

@@ -38,7 +38,7 @@ Precompiling requires planning, but it offers significantly faster compilations
3838

3939
Precompile code when you know that your source files use common sets of header files but don't include them in the same order, or when you want to include source code in your precompilation.
4040

41-
The precompiled-header options are [/Yc (Create Precompiled Header File)](yc-create-precompiled-header-file.md) and [/Yu (Use Precompiled Header File)](yu-use-precompiled-header-file.md). Use **/Yc** to create a precompiled header. When used with the optional [hdrstop](../../preprocessor/hdrstop.md) pragma, **/Yc** lets you precompile both header files and source code. Select **/Yu** to use an existing precompiled header in the existing compilation. You can also use **/Fp** with the **/Yc** and **/Yu** options to provide an alternative name for the precompiled header.
41+
The precompiled-header options are [/Yc (Create Precompiled Header File)](reference/yc-create-precompiled-header-file.md) and [/Yu (Use Precompiled Header File)](reference/yu-use-precompiled-header-file.md). Use **/Yc** to create a precompiled header. When used with the optional [hdrstop](../preprocessor/hdrstop.md) pragma, **/Yc** lets you precompile both header files and source code. Select **/Yu** to use an existing precompiled header in the existing compilation. You can also use **/Fp** with the **/Yc** and **/Yu** options to provide an alternative name for the precompiled header.
4242

4343
The compiler option reference topics for **/Yu** and **/Yc** discuss how to access this functionality in the development environment.
4444

@@ -48,7 +48,7 @@ Because PCH files contain information about the machine environment as well as m
4848

4949
## Consistency Rules for Per-File Use of Precompiled Headers
5050

51-
The [/Yu](yu-use-precompiled-header-file.md) compiler option lets you specify which PCH file to use.
51+
The [/Yu](reference/yu-use-precompiled-header-file.md) compiler option lets you specify which PCH file to use.
5252

5353
When you use a PCH file, the compiler assumes the same compilation environment — one that uses consistent compiler options, pragmas, and so on — that was in effect when you created the PCH file, unless you specify otherwise. If the compiler detects an inconsistency, it issues a warning and identifies the inconsistency where possible. Such warnings do not necessarily indicate a problem with the PCH file; they simply warn you of possible conflicts. Consistency requirements for PCH files are described in the following sections.
5454

@@ -120,7 +120,7 @@ This table lists compiler options that might trigger an inconsistency warning wh
120120
121121
## Using Precompiled Headers in a Project
122122

123-
Previous sections present an overview of precompiled headers: /Yc and /Yu, the /Fp option, and the [hdrstop](../../preprocessor/hdrstop.md) pragma. This section describes a method for using the manual precompiled-header options in a project; it ends with an example makefile and the code that it manages.
123+
Previous sections present an overview of precompiled headers: /Yc and /Yu, the /Fp option, and the [hdrstop](../preprocessor/hdrstop.md) pragma. This section describes a method for using the manual precompiled-header options in a project; it ends with an example makefile and the code that it manages.
124124

125125
For another approach to using the manual precompiled-header options in a project, study one of the makefiles located in the MFC\SRC directory that is created during the default setup of Visual C++. These makefiles take a similar approach to the one presented in this section but make greater use of Microsoft Program Maintenance Utility (NMAKE) macros, and offer greater control of the build process.
126126

@@ -139,7 +139,7 @@ Beginning at the top of the diagram, both STABLEHDRS and BOUNDRY are NMAKE macro
139139

140140
only if the precompiled header file (STABLE.pch) does not exist or if you make changes to the files listed in the two macros. In either case, the precompiled header file will contain code only from the files listed in the STABLEHDRS macro. List the last file you want precompiled in the BOUNDRY macro.
141141

142-
The files you list in these macros can be either header files or C or C++ source files. (A single PCH file cannot be used with both C and C++ modules.) Note that you can use the **hdrstop** macro to stop precompilation at some point within the BOUNDRY file. See [hdrstop](../../preprocessor/hdrstop.md) for more information.
142+
The files you list in these macros can be either header files or C or C++ source files. (A single PCH file cannot be used with both C and C++ modules.) Note that you can use the **hdrstop** macro to stop precompilation at some point within the BOUNDRY file. See [hdrstop](../preprocessor/hdrstop.md) for more information.
143143

144144
Continuing down the diagram, APPLIB.obj represents the support code used in your final application. It is created from APPLIB.cpp, the files listed in the UNSTABLEHDRS macro, and precompiled code from the precompiled header.
145145

@@ -210,7 +210,7 @@ NMAKE
210210
NMAKE DEBUG=0
211211
```
212212

213-
For more information on makefiles, see [NMAKE Reference](nmake-reference.md). Also see [MSVC Compiler Options](compiler-options.md) and the [MSVC Linker Options](linker-options.md).
213+
For more information on makefiles, see [NMAKE Reference](reference/nmake-reference.md). Also see [MSVC Compiler Options](reference/compiler-options.md) and the [MSVC Linker Options](reference/linker-options.md).
214214

215215
## Example Code for PCH
216216

@@ -298,5 +298,5 @@ int main( void )
298298

299299
## See Also
300300

301-
[C/C++ Building Reference](c-cpp-building-reference.md)<br/>
302-
[MSVC Compiler Options](compiler-options.md)
301+
[C/C++ Building Reference](reference/c-cpp-building-reference.md)<br/>
302+
[MSVC Compiler Options](reference/compiler-options.md)

0 commit comments

Comments
 (0)