Skip to content

Commit 1efb76d

Browse files
committed
Clarify CBC / compiler macro usage
Signed-off-by: Michał Górny <mgorny@quansight.com>
1 parent 0a2e185 commit 1efb76d

File tree

1 file changed

+8
-12
lines changed

1 file changed

+8
-12
lines changed

docs/maintainer/infrastructure.md

Lines changed: 8 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -560,15 +560,11 @@ cxx_compiler_version:
560560
- 21
561561
```
562562

563-
Alternatively, the specific compiler name can be used as an argument to
564-
the `{{ compiler(...) }}` macro, e.g.:
565-
566-
```yaml
567-
requirements:
568-
build:
569-
- {{ compiler('clang') }}
570-
- {{ stdlib('c') }}
571-
```
563+
Technically, the `{{ compiler(...) }}` macro may accept arbitrary compiler names
564+
as an argument. However, this only works as an incident of the current implementation.
565+
Names other than the listed in this document or the
566+
[conda-forge/conda-forge-pinning-feedstock](https://github.com/conda-forge/conda-forge-pinning-feedstock)
567+
repository should not be used.
572568

573569
### Installing standard compilers manually
574570

@@ -639,15 +635,15 @@ maximum version supported by nvcc (which is also reflected in the global pinning
639635

640636
The `clang` compiler package installs two frontends, and conda-forge
641637
provides separate activation scripts for Windows, for each of them. Therefore,
642-
the following arguments can be used in `recipe/conda_build_config.yaml`
643-
or passed to the `{{ compiler(...) }}` macro:
638+
the following arguments can be used in `recipe/conda_build_config.yaml`:
644639

645640
- `clang` to use the `clang` frontend using GCC argument syntax
646641
- `clang-cl` to use the `clang-cl` frontend with MSVC argument syntax
647642

648643
#### MinGW-based compiler stack for Windows
649644

650-
There exists an alternative, MinGW-based, compiler stack on Windows:
645+
There exists an alternative, MinGW-based, compiler stack on Windows. To use it,
646+
the following arguments can be passed to the `{[ compiler(...) }}` macro:
651647

652648
- `m2w64_c` for the C compiler
653649
- `m2w64_cxx` for the C++ compiler

0 commit comments

Comments
 (0)