[gentoo-pms] Somewhat contradictory wording on global scope commands

[gentoo-pms] Somewhat contradictory wording on global scope commands

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 1439 bytes --]

PMS section 11.3 "Available Commands"
https://projects.gentoo.org/pms/6/pms.html#x1-12600011.3 says:

| This section documents the commands available to an ebuild. Unless
| otherwise specified, they may be aliases, shell functions, or
| executables in the ebuild's PATH.
|
| When an ebuild is being sourced for metadata querying rather than
| for a build (that is to say, when none of the src_ or pkg_ functions
| are to be called), no external command may be executed. The package
| manager may take steps to enforce this.

So ebuilds must not execute external commands in global scope.

However, in section 11.3.3 "Ebuild-specific commands" we have:

| The following commands will always be available in the ebuild
| environment, provided by the package manager.

"Always" means that they are available in global scope too?

| Except where otherwise noted, they may be internal (shell functions
| or aliases) or external commands available in PATH; where this is
| not specified, ebuilds may not rely upon either behaviour.

If they can be external commands, then by 11.3 ebuilds must not call
them in global scope, and the PM may even enforce this?

All in all, this is somewhat contradictory, and I wonder if we
shouldn't say in 11.3.3 instead that ebuild must not call any of these
commands in global scope, unless this is explicitly permitted.

(The next question is of course which commands qualify for global
scope usage?)

Ulrich

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]