diff options
| author | Brad King <brad.king@kitware.com> | 2020-05-22 14:34:53 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2020-05-22 14:35:10 (GMT) |
| commit | 62816ff88c6d1bd8d1c00de5ed448ee915d69e00 (patch) | |
| tree | 6f1eb5d7c8b7deee02da84d309b446d5f6f38db5 /Help/prop_sf | |
| parent | 1b0049680b09872f01f714c8dcb1ed3c5c21da25 (diff) | |
| parent | 3888de23daca814d66a40642d3e369a5c4747131 (diff) | |
| download | CMake-62816ff88c6d1bd8d1c00de5ed448ee915d69e00.zip CMake-62816ff88c6d1bd8d1c00de5ed448ee915d69e00.tar.gz CMake-62816ff88c6d1bd8d1c00de5ed448ee915d69e00.tar.bz2 | |
Merge topic 'fortran-preprocess-property'
3888de23da Ninja: Skip Fortran preprocessing if Fortran_PREPROCESS is OFF
66c4e87282 Ninja: Add helper functions to generate Fortran build
5cca1ec893 Ninja: Add helper functions to generate Fortran preprocess rule
b0a6161190 Fortran: Add Fortran_PREPROCESS property
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !4659
Diffstat (limited to 'Help/prop_sf')
| -rw-r--r-- | Help/prop_sf/Fortran_FORMAT.rst | 10 | ||||
| -rw-r--r-- | Help/prop_sf/Fortran_PREPROCESS.rst | 17 |
2 files changed, 23 insertions, 4 deletions
diff --git a/Help/prop_sf/Fortran_FORMAT.rst b/Help/prop_sf/Fortran_FORMAT.rst index 1cbbf48..ef33926 100644 --- a/Help/prop_sf/Fortran_FORMAT.rst +++ b/Help/prop_sf/Fortran_FORMAT.rst @@ -4,7 +4,9 @@ Fortran_FORMAT Set to ``FIXED`` or ``FREE`` to indicate the Fortran source layout. This property tells CMake whether a given Fortran source file uses -fixed-format or free-format. CMake will pass the corresponding format -flag to the compiler. Consider using the target-wide -:prop_tgt:`Fortran_FORMAT` property if all source files in a target -share the same format. +fixed-format or free-format. CMake will pass the corresponding format flag +to the compiler. Consider using the target-wide :prop_tgt:`Fortran_FORMAT` +property if all source files in a target share the same format. + +.. note:: For some compilers, ``NAG``, ``PGI`` and ``Solaris Studio``, + setting this to ``OFF`` will have no effect. diff --git a/Help/prop_sf/Fortran_PREPROCESS.rst b/Help/prop_sf/Fortran_PREPROCESS.rst new file mode 100644 index 0000000..25ea827 --- /dev/null +++ b/Help/prop_sf/Fortran_PREPROCESS.rst @@ -0,0 +1,17 @@ +Fortran_PREPROCESS +------------------ + +Control whether the Fortran source file should be unconditionally preprocessed. + +If unset or empty, rely on the compiler to determine whether the file +should be preprocessed. If explicitly set to ``OFF`` then the file +does not need to be preprocessed. If explicitly set to ``ON``, then +the file does need to be preprocessed as part of the compilation step. + +When using the :generator:`Ninja` generator, all source files are +first preprocessed in order to generate module dependency +information. Setting this property to ``OFF`` will make ``Ninja`` +skip this step. + +Consider using the target-wide :prop_tgt:`Fortran_PREPROCESS` property +if all source files in a target need to be preprocessed. |