kolan
/
CMake
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Merge topic 'doc-add_compile_options' 

352cbb6e Help: Reference add_compile_options from add_definitions (#15225)
a9f8c50a Help: Clarify add_compile_options documentation (#15225)
This commit is contained in:
Brad King 2014-10-30 14:11:57 -04:00 committed by CMake Topic Stage
parent b233a09f6e 352cbb6e36
commit 5e27e6f896
3 changed files with 17 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
Help/command/add_compile_options.rst
View File

@ -7,15 +7,16 @@ Adds options to the compilation of source files.
add_compile_options(<option> ...) add_compile_options(<option> ...)
Adds options to the compiler command line for sources in the current Adds options to the compiler command line for targets in the current
directory and below. This command can be used to add any options, but directory and below that are added after this command is invoked.
alternative commands exist to add preprocessor definitions See documentation of the :prop_dir:`directory <COMPILE_OPTIONS>` and
(:command:`target_compile_definitions` and :command:`add_definitions`) or
include directories (:command:`target_include_directories` and
:command:`include_directories`). See documentation of the
:prop_tgt:`directory <COMPILE_OPTIONS>` and
:prop_tgt:`target <COMPILE_OPTIONS>` ``COMPILE_OPTIONS`` properties. :prop_tgt:`target <COMPILE_OPTIONS>` ``COMPILE_OPTIONS`` properties.
This command can be used to add any options, but alternative commands
exist to add preprocessor definitions (:command:`target_compile_definitions`
and :command:`add_definitions`) or include directories
(:command:`target_include_directories` and :command:`include_directories`).
Arguments to ``add_compile_options`` may use "generator expressions" with Arguments to ``add_compile_options`` may use "generator expressions" with
the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)`
manual for available expressions. See the :manual:`cmake-buildsystem(7)` manual for available expressions. See the :manual:`cmake-buildsystem(7)`

10
Help/command/add_definitions.rst
View File

@ -7,10 +7,12 @@ Adds -D define flags to the compilation of source files.
add_definitions(-DFOO -DBAR ...) add_definitions(-DFOO -DBAR ...)
Adds definitions to the compiler command line for sources in the current Adds definitions to the compiler command line for targets in the current
directory and below. This command can be used to add any flags, but directory and below (whether added before or after this command is invoked).
it is intended to add preprocessor definitions. Flags This command can be used to add any flags, but it is intended to add
beginning in -D or /D that look like preprocessor definitions are preprocessor definitions (see the :command:`add_compile_options` command
to add other flags).
Flags beginning in -D or /D that look like preprocessor definitions are
automatically added to the :prop_dir:`COMPILE_DEFINITIONS` directory automatically added to the :prop_dir:`COMPILE_DEFINITIONS` directory
property for the current directory. Definitions with non-trivial values property for the current directory. Definitions with non-trivial values
may be left in the set of flags instead of being converted for reasons of may be left in the set of flags instead of being converted for reasons of

6
Help/prop_dir/COMPILE_OPTIONS.rst
View File

@ -6,9 +6,9 @@ List of options to pass to the compiler.
This property specifies the list of options given so far to the This property specifies the list of options given so far to the
:command:`add_compile_options` command. :command:`add_compile_options` command.
This property is used to populate the :prop_tgt:`COMPILE_OPTIONS` target This property is used to initialize the :prop_tgt:`COMPILE_OPTIONS` target
property, which is used by the generators to set the options for the property when a target is created, which is used by the generators to set
compiler. the options for the compiler.
Contents of ``COMPILE_OPTIONS`` may use "generator expressions" with the Contents of ``COMPILE_OPTIONS`` may use "generator expressions" with the
syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual