[MacPorts] UsingTheRightCompiler modified

[MacPorts Wiki]

Page "UsingTheRightCompiler" was changed by jmroot
Diff URL: <https://trac.macports.org/wiki/UsingTheRightCompiler?action=diff&version=42>
Revision 42
Comment: explain compiler selection options better
Changes:
-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: UsingTheRightCompiler
=========================================================================
--- UsingTheRightCompiler (version: 41)
+++ UsingTheRightCompiler (version: 42)
@@ -50,11 +50,11 @@
 which sets all the related variables for you simultaneously.
 However, instead of overriding ${configure.compiler} manually,
 in most cases you should instead use some combination of the following keywords instead:
- - `compiler.blacklist` (prevent the named compiler from being used)
- - `compiler.whitelist` (only allow the named compiler to be used)
- - `compiler.fallback` (if all other compilers are blacklisted, allow the named compiler to be used)
-These keywords all modify the compiler fallback list,
-which can be found in the MacPorts sources:  [[browser:tags/release_2_3_1/base/src/port1.0/portconfigure.tcl#L426]]
+ - `compiler.blacklist` Prevent the named compilers from being used.
+ - `compiler.whitelist` Only allow the named compilers to be used. If set, `compiler.fallback` will be ignored. (Note that if the first entry in this list is a compiler provided by a port, it will always be used, so there is no point having further entries in that case. Multiple entries may be useful if the first ones are Xcode-provided compilers that may not be available on the system.)
+ - `compiler.fallback` List of compilers that may be used, in order of preference. The first entry in this list that is not in `compiler.blacklist` and is available (i.e. is either installed by Xcode on the current system or is provided by a port) will be chosen. The fallback list is chosen automatically based on the current OS and Xcode versions, and you should normally not need to modify it, though appending to it may occasionally be useful.
+These keywords all modify the selection of the default value of `configure.compiler`,
+which can be found in the MacPorts sources:  [https://github.com/macports/macports-base/blob/master/src/port1.0/portconfigure.tcl#L758]
 
 MacPorts knows about several compilers:
 
@@ -81,6 +81,7 @@
 ||=macports-clang-11               =|| Clang 11                       || MacPorts (clang-11)             ||
 ||=macports-clang-12               =|| Clang 12                       || MacPorts (clang-12)             ||
 ||=macports-clang-13               =|| Clang 13                       || Macports (clang-13)             ||
+||=macports-clang-14               =|| Clang 14                       || Macports (clang-14)             ||
 ||=macports-gcc                     =|| FSF GCC                         || MacPorts (port select)           ||
 ||=macports-gcc-4.3                 =|| FSF GCC 4.3                     || MacPorts (gcc43)                 ||
 ||=macports-gcc-4.4                 =|| FSF GCC 4.4                     || MacPorts (gcc44)                 ||
-------8<------8<------8<------8<------8<------8<------8<------8<--------

--
Page URL: <https://trac.macports.org/wiki/UsingTheRightCompiler>
MacPorts <https://www.macports.org/>
Ports system for macOS

This is an automated message. Someone added your email address to be
notified of changes on 'UsingTheRightCompiler' page.
If it was not you, please report to admin at macports.org.