offtarget 0.1.0__py3-none-any.whl

offload/__init__.py

@@ -0,0 +1,10 @@
+"""Known OpenMP and OpenACC offload compiler problems: look up support, search issues."""
+
+try:
+    from offload._version import __version__   # written by hatch-vcs at build time (the git tag)
+except ImportError:                             # a checkout that was not built
+    from importlib.metadata import PackageNotFoundError, version
+    try:
+        __version__ = version("offtarget")
+    except PackageNotFoundError:
+        __version__ = "0+unknown"

offload/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from offload.cli import main
+
+sys.exit(main())

offload/_bundle.py

@@ -0,0 +1,74 @@
+"""The data an installed offload carries (offload/_root), copied from the repository at build time."""
+import json
+import re
+import shutil
+import tempfile
+from pathlib import Path
+
+from offload.engine.root import ROOT
+
+MANIFEST = ROOT / "tools" / "repo" / "bundle_manifest.txt"
+SITE_DATA = ("issues.json", "search.json", "canuse", "compilers")
+
+
+def manifest() -> list[str]:
+    return [l.strip() for l in MANIFEST.read_text().splitlines() if l.strip() and not l.startswith("#")]
+
+
+def _manifest_files(root: Path) -> set[Path]:
+    out = set()
+    for pat in manifest():
+        hits = root.glob(pat[:-3] + "/**/*") if pat.endswith("/**") else root.glob(pat)
+        out |= {p for p in hits if p.is_file() and "__pycache__" not in p.parts
+                and not p.is_relative_to(root / "data" / "findings" / "proposed")}   # unreviewed proposals
+    return out
+
+
+_SITE_PATH = re.compile(r"/(?:p/(?:lustre\d|vast\d)|nethome|fastscratch)/[A-Za-z0-9_]+")
+
+
+def _anonymise(path: Path) -> None:
+    """The catalogs name the maintainers' install directories; an installed copy gets a neutral prefix."""
+    if path.suffix not in (".yaml", ".yml", ".json", ".txt"):
+        return
+    try:
+        text = path.read_text()
+    except UnicodeDecodeError:
+        return
+    new = _SITE_PATH.sub("/path/to", text)
+    if new != text:
+        path.write_text(new)
+
+
+def collect(dest: Path) -> list[Path]:
+    """Copy the manifest files and the site data into `dest`."""
+    dest = Path(dest)
+    written = []
+    for src in sorted(_manifest_files(ROOT)):
+        target = dest / src.relative_to(ROOT)
+        target.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(src, target)
+        _anonymise(target)
+        written.append(target)
+    return written + collect_data(dest)
+
+
+def collect_data(dest: Path) -> list[Path]:
+    """Write <dest>/data: the site's issue and can-use JSON (not the per-issue pages) and the can-use columns."""
+    from offload.engine.site import columns
+    from offload.engine.site import data as D
+    dest = Path(dest)
+    written = []
+    with tempfile.TemporaryDirectory() as tmp:
+        D.build(Path(tmp))
+        for name in SITE_DATA:
+            src = Path(tmp) / "data" / name
+            for f in ([src] if src.is_file() else sorted(src.rglob("*"))):
+                if f.is_file():
+                    target = dest / "data" / f.relative_to(Path(tmp) / "data")
+                    target.parent.mkdir(parents=True, exist_ok=True)
+                    shutil.copy2(f, target)
+                    written.append(target)
+    cols = dest / "data" / "canuse" / "columns.json"
+    cols.write_text(json.dumps(columns.canuse_columns(), separators=(",", ":")))
+    return written + [cols]

offload/_root/catalog/acc/claims.yaml

@@ -0,0 +1,197 @@
+# Vendor claims about OpenACC support (none recorded; ingested from HPE intro_openacc(7) of each CCE release, the CCE 19.0.0
+# release notes and the OLCF Frontier user guide).
+#
+# Same schema as catalog/omp/claims.yaml (`source` names a document of
+# catalog/vendor_claims.yaml; `tools/derive/claims.py ingest` records a claim for
+# each CCE toolchain whose edition contains the quote and writes
+# catalog/vendor_claims_generic.yaml). The catalog has one OpenACC version,
+# 3.4 (catalog version 34). The OpenACC 2.0 atom list below is this
+# project's reading of OpenACC 2.0 (directives and clauses that exist in
+# 2.0; the 2.5-3.4 additions are listed separately by the vendor).
+# `status: provisional`.
+
+claims:
+  - source: hpe-cce-intro-openacc
+    general: true
+    versions: [34]
+    claim: supported
+    spec_version: "2.0"
+    quote: "CCE supports full OpenACC 2.0 and partial OpenACC 2.x/3.x for Fortran (OpenACC is not supported for C and C++)."
+    note: "Release-level: applied to the atoms that exist in OpenACC 2.0."
+    language: Fortran
+    atoms: &acc20
+      - acc.directive.parallel
+      - acc.directive.kernels
+      - acc.directive.data
+      - acc.directive.enter_data
+      - acc.directive.exit_data
+      - acc.directive.host_data
+      - acc.directive.loop
+      - acc.directive.parallel_loop
+      - acc.directive.kernels_loop
+      - acc.directive.cache
+      - acc.directive.atomic
+      - acc.directive.declare
+      - acc.directive.update
+      - acc.directive.wait
+      - acc.directive.routine
+      - acc.clause.if
+      - acc.clause.async
+      - acc.clause.async.async_argument
+      - acc.clause.wait
+      - acc.clause.num_gangs
+      - acc.clause.num_workers
+      - acc.clause.vector_length
+      - acc.clause.device_type
+      - acc.clause.reduction
+      - acc.clause.reduction.plus
+      - acc.clause.reduction.times
+      - acc.clause.reduction.max
+      - acc.clause.reduction.min
+      - acc.clause.reduction.iand
+      - acc.clause.reduction.ior
+      - acc.clause.reduction.ieor
+      - acc.clause.reduction.and
+      - acc.clause.reduction.or
+      - acc.clause.reduction.eqv
+      - acc.clause.reduction.neqv
+      - acc.clause.copy
+      - acc.clause.copyin
+      - acc.clause.copyout
+      - acc.clause.create
+      - acc.clause.present
+      - acc.clause.deviceptr
+      - acc.clause.private
+      - acc.clause.firstprivate
+      - acc.clause.default
+      - acc.clause.default.none
+      - acc.clause.collapse
+      - acc.clause.gang
+      - acc.clause.gang.num
+      - acc.clause.gang.static
+      - acc.clause.worker
+      - acc.clause.worker.num
+      - acc.clause.vector
+      - acc.clause.vector.length
+      - acc.clause.seq
+      - acc.clause.auto
+      - acc.clause.tile
+      - acc.clause.independent
+      - acc.clause.use_device
+      - acc.clause.host
+      - acc.clause.device
+      - acc.clause.device_resident
+      - acc.clause.link
+      - acc.clause.bind
+      - acc.clause.nohost
+      - acc.clause.delete
+      - acc.clause.read
+      - acc.clause.write
+      - acc.clause.update
+      - acc.clause.capture
+  - source: olcf-frontier-guide
+    general: true
+    versions: [34]
+    claim: supported
+    spec_version: "2.0"
+    quote: "Full support for OpenACC 2.0"
+    note: "Site documentation (Frontier, Cray cce, Fortran, -h acc): same release-level claim."
+    language: Fortran
+    atoms: *acc20
+  - source: hpe-cce-intro-openacc
+    claim: supported
+    quote: "The following accelerator directives are supported in the current release : ATOMIC, CACHE, DATA, ENTER DATA, EXIT DATA, DECLARE, HOST_DATA, KERNELS, KERNELS LOOP, LOOP, PARALLEL, PARALLEL LOOP, Serial, ROUTINE, UPDATE, and WAIT."
+    language: Fortran
+    atoms: [acc.directive.atomic, acc.directive.cache, acc.directive.data, acc.directive.enter_data, acc.directive.exit_data, acc.directive.declare, acc.directive.host_data, acc.directive.kernels, acc.directive.kernels_loop, acc.directive.loop, acc.directive.parallel, acc.directive.parallel_loop, acc.directive.serial, acc.directive.routine, acc.directive.update, acc.directive.wait]
+  - source: hpe-cce-intro-openacc
+    claim: supported
+    spec_version: "2.x/3.x"
+    quote: "The following OpenACC 2.x/3.x features are supported: ... Attach/detach behavior and clauses"
+    language: Fortran
+    atoms: [acc.clause.attach, acc.clause.detach]
+  - source: hpe-cce-intro-openacc
+    claim: supported
+    spec_version: "2.x/3.x"
+    quote: "The following OpenACC 2.x/3.x features are supported: ... default(present) clause"
+    language: Fortran
+    atoms: [acc.clause.default.present]
+  - source: hpe-cce-intro-openacc
+    claim: supported
+    spec_version: "2.x/3.x"
+    quote: "The following OpenACC 2.x/3.x features are supported: ... if_present clause on acc update"
+    language: Fortran
+    atoms: [acc.clause.if_present]
+  - source: hpe-cce-intro-openacc
+    claim: supported
+    spec_version: "2.x/3.x"
+    quote: "The following OpenACC 2.x/3.x features are supported: ... finalize clause on exit data"
+    language: Fortran
+    atoms: [acc.clause.finalize]
+  - source: hpe-cce-intro-openacc
+    claim: supported
+    spec_version: "2.x/3.x"
+    quote: "The following OpenACC 2.x/3.x features are supported: ... no_create clause on structured data and compute constructs"
+    language: Fortran
+    atoms: [acc.clause.no_create]
+  - source: hpe-cce-intro-openacc
+    claim: supported
+    spec_version: "2.x/3.x"
+    quote: "The following OpenACC 2.x/3.x features are supported: ... serial directive"
+    language: Fortran
+    atoms: [acc.directive.serial]
+  - source: hpe-cce-intro-openacc
+    claim: supported
+    spec_version: "2.x/3.x"
+    quote: "The following OpenACC 2.x/3.x features are supported: ... acc init, acc set and acc shutdown directive"
+    language: Fortran
+    atoms: [acc.directive.init, acc.directive.set, acc.directive.shutdown]
+  - source: hpe-cce-release-notes
+    claim: supported
+    quote: "Added the following OpenACC features: ... Support init, shutdown, and set directives"
+    language: Fortran
+    atoms: [acc.directive.init, acc.directive.set, acc.directive.shutdown]
+  - source: hpe-cce-release-notes
+    claim: supported
+    quote: "Added the following OpenACC features: ... Support auto loop clause"
+    language: Fortran
+    atoms: [acc.clause.auto]
+
+# --- NVIDIA HPC SDK 25.11 (nvhpc) -----------------------------------------
+# HPC Compilers User's Guide (25.11 and 26.9), section 6.1.3 OpenACC Support: "most
+# features of OpenACC 2.7" (release-level: the OpenACC 2.0 atoms above and
+# the 2.5/2.6 additions this project reads as part of 2.7: init, set,
+# shutdown, if_present, finalize, default(present) (2.5), serial, attach,
+# detach (2.6)), with the listed 2.7 features not supported (specific
+# claims, which win over the release-level one).
+  - source: nvidia-hpc-ug-openacc
+    toolchains: [nvhpc, nvhpc269]
+    general: true
+    versions: [34]
+    claim: supported
+    spec_version: "2.7"
+    quote: "The NVIDIA HPC Compilers implement most features of OpenACC 2.7 as defined in The OpenACC Application Programming Interface, Version 2.7, November 2018"
+    note: "HPC Compilers User's Guide (25.11 and 26.9), section 6.1.3 OpenACC Support. Release-level: applied to the atoms that exist in OpenACC 2.7 (the 2.0 list and the 2.5/2.6 additions named in the header)."
+    language: Fortran and C/C++
+    version_note: "NVIDIA HPC SDK 25.11 and 26.9 (each claim recorded for a release whose guide has the quote)"
+    status: provisional
+    atoms: [acc.directive.parallel, acc.directive.kernels, acc.directive.data, acc.directive.enter_data, acc.directive.exit_data, acc.directive.host_data, acc.directive.loop, acc.directive.parallel_loop, acc.directive.kernels_loop, acc.directive.cache, acc.directive.atomic, acc.directive.declare, acc.directive.update, acc.directive.wait, acc.directive.routine, acc.clause.if, acc.clause.async, acc.clause.async.async_argument, acc.clause.wait, acc.clause.num_gangs, acc.clause.num_workers, acc.clause.vector_length, acc.clause.device_type, acc.clause.reduction, acc.clause.reduction.plus, acc.clause.reduction.times, acc.clause.reduction.max, acc.clause.reduction.min, acc.clause.reduction.iand, acc.clause.reduction.ior, acc.clause.reduction.ieor, acc.clause.reduction.and, acc.clause.reduction.or, acc.clause.reduction.eqv, acc.clause.reduction.neqv, acc.clause.copy, acc.clause.copyin, acc.clause.copyout, acc.clause.create, acc.clause.present, acc.clause.deviceptr, acc.clause.private, acc.clause.firstprivate, acc.clause.default, acc.clause.default.none, acc.clause.collapse, acc.clause.gang, acc.clause.gang.num, acc.clause.gang.static, acc.clause.worker, acc.clause.worker.num, acc.clause.vector, acc.clause.vector.length, acc.clause.seq, acc.clause.auto, acc.clause.tile, acc.clause.independent, acc.clause.use_device, acc.clause.host, acc.clause.device, acc.clause.device_resident, acc.clause.bind, acc.clause.nohost, acc.clause.delete, acc.clause.read, acc.clause.write, acc.clause.update, acc.clause.capture, acc.directive.init, acc.directive.set, acc.directive.shutdown, acc.clause.if_present, acc.clause.finalize, acc.clause.default.present, acc.directive.serial, acc.directive.serial_loop, acc.clause.attach, acc.clause.detach]
+  - source: nvidia-hpc-ug-openacc
+    toolchains: [nvhpc, nvhpc269]
+    versions: [34]
+    claim: unsupported
+    quote: "declare link"
+    note: "HPC Compilers User's Guide (25.11 and 26.9), section 6.1.3: one of 'the following OpenACC 2.7 features are not supported'."
+    language: Fortran and C/C++
+    version_note: "NVIDIA HPC SDK 25.11 and 26.9 (each claim recorded for a release whose guide has the quote)"
+    status: provisional
+    atoms: [acc.clause.link]
+  - source: nvidia-hpc-ug-openacc
+    toolchains: [nvhpc, nvhpc269]
+    versions: [34]
+    claim: unsupported
+    quote: "The self clause"
+    note: "HPC Compilers User's Guide (25.11 and 26.9), section 6.1.3: one of 'the following OpenACC 2.7 features are not supported' (the 2.7 self clause on compute constructs)."
+    language: Fortran and C/C++
+    version_note: "NVIDIA HPC SDK 25.11 and 26.9 (each claim recorded for a release whose guide has the quote)"
+    status: provisional
+    atoms: [acc.clause.self]

offload/_root/catalog/acc/clauses.yaml

@@ -0,0 +1,391 @@
+# Clause argument grammar for the OpenACC slice (OpenACC 3.4, free-form
+# Fortran).
+#
+# Same notation as catalog/omp/clauses.yaml (read by offload/engine/catalog.py
+# load_grammar and offload/engine/grammar.py); `since` is the catalog version 34
+# (OpenACC 3.4, the only OpenACC version in the catalog) and every citation
+# is "OpenACC 3.4 §<sec>, p.<n>": the clause's section and the printed page
+# where it starts (spec/openacc/openacc-3.4.pdf, read with
+# offload.engine.spec_text sections("acc3.4")). Atoms are acc.clause.<name>[.<f>].
+#
+# Additional modifier-class flag:
+#   out_of_slice: true  the keywords parse but give no slice atom. The data
+#                       clause modifiers (always, alwaysin, alwaysout,
+#                       capture, readonly, zero; 3.4 §2.7.4, p.52) are left
+#                       out of this slice (an earlier brief
+#                       said they are not in 3.4; they are), so programs using them still parse.
+#
+# Every entry is `status: provisional` until the project owner reviews it.
+
+clauses:
+  async:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.16.1, p.99"
+        syntax: "none | expr@async_argument"
+
+  attach:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.13, p.59"
+        syntax: "list"
+
+  auto:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.9.7, p.69"
+        syntax: "none"
+
+  bind:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.15.1, p.91"
+        syntax: "expr"
+
+  capture:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.12, p.77"
+        syntax: "none"
+
+  collapse:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.9.1, p.65"
+        syntax: "[enum[force] ':'] expr"
+
+  copy:
+    status: provisional
+    notes: "present_or_copy and pcopy are alternate names (3.4 §2.7.7, p.54); the skeleton lists them as spellings of copy."
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.7, p.54"
+        syntax: "[modifiers[data-clause-modifier] ':'] list"
+        modifiers:
+          data-clause-modifier: {keywords: [always, alwaysin, alwaysout, capture], out_of_slice: true}
+
+  copyin:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.8, p.55"
+        syntax: "[modifiers[data-clause-modifier] ':'] list"
+        modifiers:
+          data-clause-modifier: {keywords: [always, alwaysin, readonly, capture], out_of_slice: true}
+
+  copyout:
+    status: provisional
+    notes: "The modifier list of 3.4 §2.7.9 reads 'always, alwaysin or zero'; alwaysout (§2.7.4) is accepted too."
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.9, p.56"
+        syntax: "[modifiers[data-clause-modifier] ':'] list"
+        modifiers:
+          data-clause-modifier: {keywords: [always, alwaysin, alwaysout, zero, capture], out_of_slice: true}
+
+  create:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.10, p.57"
+        syntax: "[modifiers[data-clause-modifier] ':'] list"
+        modifiers:
+          data-clause-modifier: {keywords: [zero, capture], out_of_slice: true}
+
+  default:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.5.16, p.40"
+        syntax: "enum[none, present]"
+
+  default_async:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.14.3, p.87"
+        syntax: "expr"
+
+  delete:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.12, p.58"
+        syntax: "list"
+
+  detach:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.14, p.59"
+        syntax: "list"
+
+  device:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.14.4, p.88"
+        syntax: "list"
+
+  device_num:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.14.1, p.84"
+        syntax: "expr"
+
+  device_resident:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.13.1, p.82"
+        syntax: "list"
+
+  device_type:
+    status: provisional
+    notes: "device_type( * ) or a device-type-list of implementation-defined architecture names; dtype is an alternate name (3.4 §2.4, p.32)."
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.4, p.31"
+        syntax: "expr_list"
+
+  deviceptr:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.5, p.53"
+        syntax: "list"
+
+  finalize:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.6.6, p.45"
+        syntax: "none"
+
+  firstprivate:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.5.14, p.38"
+        syntax: "list"
+
+  gang:
+    status: provisional
+    notes: "gang-arg-list: at most one num, one dim and one static argument (3.4 §2.9, p.64); the alternatives below are the single arguments and static with num or dim, in either order. On routine only dim (3.4 §2.15.1, p.91)."
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.9.2, p.66"
+        syntax: "none | expr@num | enum[num] ':' expr | enum[dim] ':' expr | enum[static] ':' expr | expr@num ',' enum[static] ':' expr | enum[num] ':' expr ',' enum[static] ':' expr | enum[static] ':' expr ',' enum[num] ':' expr | enum[static] ':' expr ',' expr@num | enum[dim] ':' expr ',' enum[static] ':' expr | enum[static] ':' expr ',' enum[dim] ':' expr"
+      - since: 34
+        directives: [routine]
+        citation: "OpenACC 3.4 §2.15.1, p.91"
+        syntax: "none | enum[dim] ':' expr"
+
+  host:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.14.4, p.88"
+        syntax: "list"
+
+  if:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.5.6, p.37"
+        syntax: "expr"
+
+  if_present:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.14.4, p.88"
+        syntax: "none"
+
+  independent:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.9.6, p.69"
+        syntax: "none"
+
+  link:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.13.3, p.84"
+        syntax: "list"
+
+  no_create:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.11, p.57"
+        syntax: "list"
+
+  nohost:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.15.1, p.91"
+        syntax: "none"
+
+  num_gangs:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.5.10, p.37"
+        syntax: "expr_list"
+
+  num_workers:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.5.11, p.38"
+        syntax: "expr"
+
+  present:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.7.6, p.53"
+        syntax: "list"
+
+  private:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.5.13, p.38"
+        syntax: "list"
+      - since: 34
+        directives: [loop]
+        citation: "OpenACC 3.4 §2.9.10, p.70"
+        syntax: "list"
+
+  read:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.12, p.77"
+        syntax: "none"
+
+  reduction:
+    status: provisional
+    notes: "Fortran reduction operators: 3.4 §2.5.15, p.39 (table). The C operators of the same table (+ * max min & | ^ && ||) give the same atoms as their Fortran counterparts (offload.engine.catalog._OPS); .eqv. and .neqv. are Fortran only."
+    forms:
+      - since: 34
+        langs: [f90]
+        citation: "OpenACC 3.4 §2.5.15, p.39"
+        syntax: "modifiers[reduction-operator] ':' list"
+        modifiers:
+          reduction-operator: {keywords: ['+', '*', max, min, iand, ior, ieor, '.and.', '.or.', '.eqv.', '.neqv.'], one_of: true, required: true, ultimate: true}
+      - since: 34
+        langs: [f90]
+        directives: [loop]
+        citation: "OpenACC 3.4 §2.9.11, p.71"
+        syntax: "modifiers[reduction-operator] ':' list"
+        modifiers:
+          reduction-operator: {keywords: ['+', '*', max, min, iand, ior, ieor, '.and.', '.or.', '.eqv.', '.neqv.'], one_of: true, required: true, ultimate: true}
+      - since: 34
+        langs: [c]
+        citation: "OpenACC 3.4 §2.5.15, p.39"
+        syntax: "modifiers[reduction-operator] ':' list"
+        modifiers:
+          reduction-operator: {keywords: ['+', '*', max, min, '&', '|', '^', '&&', '||'], one_of: true, required: true, ultimate: true}
+      - since: 34
+        langs: [c]
+        directives: [loop]
+        citation: "OpenACC 3.4 §2.9.11, p.71"
+        syntax: "modifiers[reduction-operator] ':' list"
+        modifiers:
+          reduction-operator: {keywords: ['+', '*', max, min, '&', '|', '^', '&&', '||'], one_of: true, required: true, ultimate: true}
+
+  self:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.5.7, p.37"
+        syntax: "none | expr@condition"
+      - since: 34
+        directives: [update]
+        citation: "OpenACC 3.4 §2.14.4, p.88"
+        syntax: "list"
+
+  seq:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.9.5, p.68"
+        syntax: "none"
+
+  tile:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.9.8, p.69"
+        syntax: "expr_list"
+
+  update:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.12, p.77"
+        syntax: "none"
+
+  use_device:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.8.1, p.63"
+        syntax: "list"
+
+  vector:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.9.4, p.68"
+        syntax: "none | enum[length] ':' expr | expr@length"
+      - since: 34
+        directives: [routine]
+        citation: "OpenACC 3.4 §2.15.1, p.91"
+        syntax: "none"
+
+  vector_length:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.5.12, p.38"
+        syntax: "expr"
+
+  wait:
+    status: provisional
+    notes: "wait-argument: [devnum : int-expr :] [queues :] async-argument-list (3.4 §2.16, p.98)."
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.16.2, p.100"
+        syntax: "none | [enum[devnum] ':' expr ':'] [enum[queues] ':'] expr_list"
+
+  worker:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.9.3, p.68"
+        syntax: "none | enum[num] ':' expr | expr@num"
+      - since: 34
+        directives: [routine]
+        citation: "OpenACC 3.4 §2.15.1, p.91"
+        syntax: "none"
+
+  write:
+    status: provisional
+    forms:
+      - since: 34
+        citation: "OpenACC 3.4 §2.12, p.77"
+        syntax: "none"