SCons/Tool/f90.xml

   1 <?xml version="1.0"?>
   2 <!--
   3 Copyright The SCons Foundation
   4
   5 This file is processed by the bin/SConsDoc.py module.
   6 See its __doc__ string for a discussion of the format.
   7 -->
   8
   9 <!DOCTYPE sconsdoc [
  10 <!ENTITY % scons SYSTEM '../../doc/scons.mod'>
  11 %scons;
  12 <!ENTITY % builders-mod SYSTEM '../../doc/generated/builders.mod'>
  13 %builders-mod;
  14 <!ENTITY % functions-mod SYSTEM '../../doc/generated/functions.mod'>
  15 %functions-mod;
  16 <!ENTITY % tools-mod SYSTEM '../../doc/generated/tools.mod'>
  17 %tools-mod;
  18 <!ENTITY % variables-mod SYSTEM '../../doc/generated/variables.mod'>
  19 %variables-mod;
  20 ]>
  21
  22 <sconsdoc xmlns="http://www.scons.org/dbxsd/v1.0"
  23           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  24           xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0 http://www.scons.org/dbxsd/v1.0/scons.xsd">
  25
  26 <tool name="f90">
  27 <summary>
  28 <para>
  29 Set construction variables for generic POSIX Fortran 90 compilers.
  30 </para>
  31 </summary>
  32 <sets>
  33 <item>F90</item>
  34 <item>F90FLAGS</item>
  35 <item>F90COM</item>
  36 <item>F90PPCOM</item>
  37 <item>SHF90</item>
  38 <item>SHF90FLAGS</item>
  39 <item>SHF90COM</item>
  40 <item>SHF90PPCOM</item>
  41 <item>_F90INCFLAGS</item>
  42 </sets>
  43 <uses>
  44 <item>F90COMSTR</item>
  45 <item>F90PPCOMSTR</item>
  46 <item>SHF90COMSTR</item>
  47 <item>SHF90PPCOMSTR</item>
  48 <item>FORTRANCOMMONFLAGS</item>
  49 </uses>
  50 </tool>
  51
  52 <cvar name="F90">
  53 <summary>
  54 <para>
  55 The Fortran 90 compiler.
  56 You should normally set the &cv-link-FORTRAN; variable,
  57 which specifies the default Fortran compiler
  58 for all Fortran versions.
  59 You only need to set &cv-link-F90; if you need to use a specific compiler
  60 or compiler version for Fortran 90 files.
  61 </para>
  62 </summary>
  63 </cvar>
  64
  65 <cvar name="F90COM">
  66 <summary>
  67 <para>
  68 The command line used to compile a Fortran 90 source file to an object file.
  69 You only need to set &cv-link-F90COM; if you need to use a specific
  70 command line for Fortran 90 files.
  71 You should normally set the &cv-link-FORTRANCOM; variable,
  72 which specifies the default command line
  73 for all Fortran versions.
  74 </para>
  75 </summary>
  76 </cvar>
  77
  78 <cvar name="F90COMSTR">
  79 <summary>
  80 <para>
  81 If set, the string displayed when a Fortran 90 source file
  82 is compiled to an object file.
  83 If not set, then &cv-link-F90COM; or &cv-link-FORTRANCOM;
  84 (the command line) is displayed.
  85 </para>
  86 </summary>
  87 </cvar>
  88
  89 <cvar name="F90FILESUFFIXES">
  90 <summary>
  91 <para>
  92 The list of file extensions for which the F90 dialect will be used. By
  93 default, this is <literal>['.f90']</literal>
  94 </para>
  95 </summary>
  96 </cvar>
  97
  98 <cvar name="F90PPFILESUFFIXES">
  99 <summary>
 100 <para>
 101 The list of file extensions for which the compilation + preprocessor pass for
 102 F90 dialect will be used. By default, this is empty.
 103 </para>
 104 </summary>
 105 </cvar>
 106
 107 <cvar name="F90FLAGS">
 108 <summary>
 109 <para>
 110 General user-specified options that are passed to the Fortran 90 compiler.
 111 Note that this variable does
 112 <emphasis>not</emphasis>
 113 contain
 114 <option>-I</option>
 115 (or similar) include search path options
 116 that scons generates automatically from &cv-link-F90PATH;.
 117 See
 118 &cv-link-_F90INCFLAGS;
 119 below,
 120 for the variable that expands to those options.
 121 You only need to set &cv-link-F90FLAGS; if you need to define specific
 122 user options for Fortran 90 files.
 123 You should normally set the &cv-link-FORTRANFLAGS; variable,
 124 which specifies the user-specified options
 125 passed to the default Fortran compiler
 126 for all Fortran versions.
 127 </para>
 128 </summary>
 129 </cvar>
 130
 131 <cvar name="_F90INCFLAGS">
 132 <summary>
 133 <para>
 134 An automatically-generated construction variable
 135 containing the Fortran 90 compiler command-line options
 136 for specifying directories to be searched for include files.
 137 The value of &cv-link-_F90INCFLAGS; is created
 138 by appending &cv-link-INCPREFIX; and &cv-link-INCSUFFIX;
 139 to the beginning and end
 140 of each directory in &cv-link-F90PATH;.
 141 </para>
 142 </summary>
 143 </cvar>
 144
 145 <cvar name="F90PATH">
 146 <summary>
 147 <para>
 148 The list of directories that the Fortran 90 compiler will search for include
 149 directories. The implicit dependency scanner will search these
 150 directories for include files. Don't explicitly put include directory
 151 arguments in &cv-link-F90FLAGS; because the result will be non-portable
 152 and the directories will not be searched by the dependency scanner. Note:
 153 directory names in &cv-link-F90PATH; will be looked-up relative to the SConscript
 154 directory when they are used in a command. To force
 155 &scons;
 156 to look-up a directory relative to the root of the source tree use #:
 157 You only need to set &cv-link-F90PATH; if you need to define a specific
 158 include path for Fortran 90 files.
 159 You should normally set the &cv-link-FORTRANPATH; variable,
 160 which specifies the include path
 161 for the default Fortran compiler
 162 for all Fortran versions.
 163 </para>
 164
 165 <example_commands>
 166 env = Environment(F90PATH='#/include')
 167 </example_commands>
 168
 169 <para>
 170 The directory look-up can also be forced using the
 171 &Dir;()
 172 function:
 173 </para>
 174
 175 <example_commands>
 176 include = Dir('include')
 177 env = Environment(F90PATH=include)
 178 </example_commands>
 179
 180 <para>
 181 The directory list will be added to command lines
 182 through the automatically-generated
 183 &cv-link-_F90INCFLAGS;
 184 construction variable,
 185 which is constructed by
 186 appending the values of the
 187 &cv-link-INCPREFIX; and &cv-link-INCSUFFIX;
 188 construction variables
 189 to the beginning and end
 190 of each directory in &cv-link-F90PATH;.
 191 Any command lines you define that need
 192 the F90PATH directory list should
 193 include &cv-link-_F90INCFLAGS;:
 194 </para>
 195
 196 <example_commands>
 197 env = Environment(F90COM="my_compiler $_F90INCFLAGS -c -o $TARGET $SOURCE")
 198 </example_commands>
 199 </summary>
 200 </cvar>
 201
 202 <cvar name="F90PPCOM">
 203 <summary>
 204 <para>
 205 The command line used to compile a Fortran 90 source file to an object file
 206 after first running the file through the C preprocessor.
 207 Any options specified in the &cv-link-F90FLAGS; and &cv-link-CPPFLAGS; construction variables
 208 are included on this command line.
 209 You only need to set &cv-link-F90PPCOM; if you need to use a specific
 210 C-preprocessor command line for Fortran 90 files.
 211 You should normally set the &cv-link-FORTRANPPCOM; variable,
 212 which specifies the default C-preprocessor command line
 213 for all Fortran versions.
 214 </para>
 215 </summary>
 216 </cvar>
 217
 218 <cvar name="F90PPCOMSTR">
 219 <summary>
 220 <para>
 221 If set, the string displayed when a Fortran 90 source file
 222 is compiled after first running the file through the C preprocessor.
 223 If not set, then &cv-link-F90PPCOM; or &cv-link-FORTRANPPCOM;
 224 (the command line) is displayed.
 225 </para>
 226 </summary>
 227 </cvar>
 228
 229 <cvar name="SHF90">
 230 <summary>
 231 <para>
 232 The Fortran 90 compiler used for generating shared-library objects.
 233 You should normally set the &cv-link-SHFORTRAN; variable,
 234 which specifies the default Fortran compiler
 235 for all Fortran versions.
 236 You only need to set &cv-link-SHF90; if you need to use a specific compiler
 237 or compiler version for Fortran 90 files.
 238 </para>
 239 </summary>
 240 </cvar>
 241
 242 <cvar name="SHF90COM">
 243 <summary>
 244 <para>
 245 The command line used to compile a Fortran 90 source file
 246 to a shared-library object file.
 247 You only need to set &cv-link-SHF90COM; if you need to use a specific
 248 command line for Fortran 90 files.
 249 You should normally set the &cv-link-SHFORTRANCOM; variable,
 250 which specifies the default command line
 251 for all Fortran versions.
 252 </para>
 253 </summary>
 254 </cvar>
 255
 256 <cvar name="SHF90COMSTR">
 257 <summary>
 258 <para>
 259 If set, the string displayed when a Fortran 90 source file
 260 is compiled to a shared-library object file.
 261 If not set, then &cv-link-SHF90COM; or &cv-link-SHFORTRANCOM;
 262 (the command line) is displayed.
 263 </para>
 264 </summary>
 265 </cvar>
 266
 267 <cvar name="SHF90FLAGS">
 268 <summary>
 269 <para>
 270 Options that are passed to the Fortran 90 compiler
 271 to generated shared-library objects.
 272 You only need to set &cv-link-SHF90FLAGS; if you need to define specific
 273 user options for Fortran 90 files.
 274 You should normally set the &cv-link-FORTRANCOMMONFLAGS; variable,
 275 which specifies the user-specified options
 276 passed to the default Fortran compiler
 277 for all Fortran versions.
 278 </para>
 279 </summary>
 280 </cvar>
 281
 282 <cvar name="SHF90PPCOM">
 283 <summary>
 284 <para>
 285 The command line used to compile a Fortran 90 source file to a
 286 shared-library object file
 287 after first running the file through the C preprocessor.
 288 Any options specified in the &cv-link-SHF90FLAGS; and &cv-link-CPPFLAGS; construction variables
 289 are included on this command line.
 290 You only need to set &cv-link-SHF90PPCOM; if you need to use a specific
 291 C-preprocessor command line for Fortran 90 files.
 292 You should normally set the &cv-link-SHFORTRANPPCOM; variable,
 293 which specifies the default C-preprocessor command line
 294 for all Fortran versions.
 295 </para>
 296 </summary>
 297 </cvar>
 298
 299 <cvar name="SHF90PPCOMSTR">
 300 <summary>
 301 <para>
 302 If set, the string displayed when a Fortran 90 source file
 303 is compiled to a shared-library object file
 304 after first running the file through the C preprocessor.
 305 If not set, then &cv-link-SHF90PPCOM; or &cv-link-SHFORTRANPPCOM;
 306 (the command line) is displayed.
 307 </para>
 308 </summary>
 309 </cvar>
 310
 311 </sconsdoc>