flang/docs/Directives.md

   1 <!--===- docs/Directives.md
   2
   3    Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
   4    See https://llvm.org/LICENSE.txt for license information.
   5    SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
   6
   7 -->
   8
   9 # Compiler directives supported by Flang
  10
  11 A list of non-standard directives supported by Flang
  12
  13 * `!dir$ fixed` and `!dir$ free` select Fortran source forms.  Their effect
  14   persists to the end of the current source file.
  15 * `!dir$ ignore_tkr [[(TKRDMAC)] dummy-arg-name]...` in an interface definition
  16   disables some semantic checks at call sites for the actual arguments that
  17   correspond to some named dummy arguments (or all of them, by default).
  18   The directive allow actual arguments that would otherwise be diagnosed
  19   as incompatible in type (T), kind (K), rank (R), CUDA device (D), or
  20   managed (M) status.  The letter (A) is a shorthand for all of these,
  21   and is the default when no letters appear.  The letter (C) is a legacy
  22   no-op.  For example, if one wanted to call a "set all bytes to zero"
  23   utility that could be applied to arrays of any type or rank:
  24 ```
  25   interface
  26     subroutine clear(arr,bytes)
  27 !dir$ ignore_tkr arr
  28       integer(1), intent(out) :: arr(bytes)
  29     end
  30   end interface
  31 ```