flang/docs/OpenACC.md

   1 <!--===- docs/Extensions.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 # OpenACC in Flang
  10
  11 ```{contents}
  12 ---
  13 local:
  14 ---
  15 ```
  16
  17 ## Intentional deviation from the specification
  18 * The end directive for combined construct can omit the `loop` keyword.
  19 * An `!$acc routine` with no parallelism clause is treated as if the `seq`
  20   clause was present.
  21 * `!$acc end loop` does not trigger a parsing error and is just ignored.
  22 * The restriction on `!$acc data` required clauses is emitted as a portability
  23   warning instead of an error as other compiler accepts it.
  24 * The `if` clause accepts scalar integer expression in addition to scalar
  25   logical expression.
  26 * `!$acc routine` directive can be placed at the top level.
  27 * `!$acc cache` directive accepts scalar variable.
  28
  29 ## Remarks about incompatibilities with other implementations
  30 * Array element references in the data clauses are equivalent to array sections
  31   consisting of this single element, i.e. `copyin(a(n))` is equivalent to
  32   `copyin(a(n:n))`.  Some other implementations have treated it as
  33   `copyin(a(:n))`, which does not correspond to OpenACC spec – Flang does not
  34   support this interpretation of an array element reference.