Skip to content

Commit 7153464

Browse files
authored
Merge pull request #2076 from corob-msft/cr-fix-1061
Address 1061 missing break tags
2 parents 4ac2e06 + ee210ff commit 7153464

File tree

1 file changed

+16
-16
lines changed

1 file changed

+16
-16
lines changed
Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,54 +1,54 @@
11
---
2-
title: "CL Environment Variables"
3-
ms.date: "05/06/2019"
2+
title: "CL environment variables"
3+
ms.date: "06/06/2019"
44
f1_keywords: ["cl"]
55
helpviewer_keywords: ["INCLUDE environment variable", "cl.exe compiler, environment variables", "LIBPATH environment variable", "environment variables, CL compiler"]
66
ms.assetid: 2606585b-a681-42ee-986e-1c9a2da32108
77
---
8-
# CL Environment Variables
8+
# CL environment variables
99

1010
The CL tool uses the following environment variables:
1111

12-
- CL and \_CL\_, if defined. The CL tool prepends the options and arguments defined in the CL environment variable to the command line arguments, and appends the options and arguments defined in \_CL\_, before processing.
12+
- CL and \_CL_, if defined. The CL tool prepends the options and arguments defined in the CL environment variable to the command-line arguments, and appends the options and arguments defined in \_CL_, before processing.
1313

1414
- INCLUDE, which must point to the \include subdirectory of your Visual Studio installation.
1515

16-
- LIBPATH, which specifies directories to search for metadata files referenced with [#using](../../preprocessor/hash-using-directive-cpp.md). See `#using` for more information on LIBPATH.
16+
- LIBPATH, which specifies directories to search for metadata files referenced with [#using](../../preprocessor/hash-using-directive-cpp.md). For more information on LIBPATH, see [#using](../../preprocessor/hash-using-directive-cpp.md).
1717

18-
You can set the CL or \_CL\_ environment variable using the following syntax:
18+
You can set the CL or \_CL_ environment variable using the following syntax:
1919

20-
> SET CL=[ [*option*] ... [*file*] ...] [/link *link-opt* ...]
20+
> SET CL=[ [*option*] ... [*file*] ...] [/link *link-opt* ...] \
2121
> SET \_CL\_=[ [*option*] ... [*file*] ...] [/link *link-opt* ...]
2222
23-
For details on the arguments to the CL and \_CL\_ environment variables, see [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md).
23+
For details on the arguments to the CL and \_CL_ environment variables, see [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md).
2424

25-
You can use these environment variables to define the files and options you use most often and use the command line to define specific files and options for specific purposes. The CL and \_CL\_ environment variables are limited to 1024 characters (the command-line input limit).
25+
You can use these environment variables to define the files and options you use most often. Then use the command line to give more files and options to CL for specific purposes. The CL and \_CL_ environment variables are limited to 1024 characters (the command-line input limit).
2626

27-
You cannot use the /D option to define a symbol that uses an equal sign (=). You can substitute the number sign (#) for an equal sign. In this way, you can use the CL or \_CL\_ environment variables to define preprocessor constants with explicit values—for example, `/DDEBUG#1` to define `DEBUG=1`.
27+
You can't use the [/D](d-preprocessor-definitions.md) option to define a symbol that uses an equal sign (**=**). Instead, you can use the number sign (**#**) for an equal sign. In this way, you can use the CL or \_CL_ environment variables to define preprocessor constants with explicit values—for example, `/DDEBUG#1` to define `DEBUG=1`.
2828

2929
For related information, see [Set Environment Variables](../setting-the-path-and-environment-variables-for-command-line-builds.md).
3030

3131
## Examples
3232

33-
The following is an example of setting the CL environment variable:
33+
The following command is an example of setting the CL environment variable:
3434

3535
> SET CL=/Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE.OBJ
3636
37-
When this environment variable is set, if you enter `CL INPUT.C` at the command line, this is the effective command:
37+
When the CL environment variable is set, if you enter `CL INPUT.C` at the command line, the effective command becomes:
3838

3939
> CL /Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE.OBJ INPUT.C
4040
4141
The following example causes a plain CL command to compile the source files FILE1.c and FILE2.c, and then link the object files FILE1.obj, FILE2.obj, and FILE3.obj:
4242

43-
> SET CL=FILE1.C FILE2.C
44-
> SET \_CL\_=FILE3.OBJ
43+
> SET CL=FILE1.C FILE2.C \
44+
> SET \_CL_=FILE3.OBJ \
4545
> CL
4646
47-
This has the same effect as the following command line:
47+
These environment variables make the call to CL have the same effect as the following command line:
4848

4949
> CL FILE1.C FILE2.C FILE3.OBJ
5050
5151
## See also
5252

53-
[Setting Compiler Options](compiler-command-line-syntax.md)<br/>
53+
[Setting Compiler Options](compiler-command-line-syntax.md) \
5454
[MSVC Compiler Options](compiler-options.md)

0 commit comments

Comments
 (0)