summaryrefslogtreecommitdiff
path: root/Help/prop_tgt/Fortran_PREPROCESS.rst
diff options
context:
space:
mode:
authorPeter Hill <zed.three@gmail.com>2020-04-24 11:52:41 +0100
committerBrad King <brad.king@kitware.com>2020-05-21 11:44:14 -0400
commitb0a6161190f8a85a5771fc96d5d745b0be2b07e5 (patch)
treed5fc83aa6c54f699239e4c5739eb4218e83dc720 /Help/prop_tgt/Fortran_PREPROCESS.rst
parentd3d53eefeeea5d3cf853f4591e318f3e4998bec0 (diff)
downloadcmake-b0a6161190f8a85a5771fc96d5d745b0be2b07e5.tar.gz
Fortran: Add Fortran_PREPROCESS property
Issue: #18870
Diffstat (limited to 'Help/prop_tgt/Fortran_PREPROCESS.rst')
-rw-r--r--Help/prop_tgt/Fortran_PREPROCESS.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/Help/prop_tgt/Fortran_PREPROCESS.rst b/Help/prop_tgt/Fortran_PREPROCESS.rst
new file mode 100644
index 0000000000..069d04ab51
--- /dev/null
+++ b/Help/prop_tgt/Fortran_PREPROCESS.rst
@@ -0,0 +1,18 @@
+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.
+
+Use the source-specific :prop_sf:`Fortran_PREPROCESS` property if a single
+file needs to be preprocessed. If the variable
+:variable:`CMAKE_Fortran_PREPROCESS` is set when a target is created its
+value is used to initialize this property.
+
+.. note:: For some compilers, ``NAG``, ``PGI`` and ``Solaris Studio``,
+ setting this to ``OFF`` will have no effect.