Skip to content

Commit

Permalink
Clarify documentation for enable pseudo-variable
Browse files Browse the repository at this point in the history
The documentation for variables says that for boolean variables the form
`name1+name2+name3:var` is equivalent to
`name1:var & name2:var & name3:var` but it's possible to write
`name1+name2:enable` despite `enable` being the string "enable" or
"disable". This change clarifies that `enable` isn't really a variable
but syntactic sugar instead.
  • Loading branch information
gridbugs committed Sep 11, 2023
1 parent db5774f commit efff965
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 3 deletions.
8 changes: 5 additions & 3 deletions doc/pages/Manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -492,9 +492,11 @@ the package being defined.
resolved direct dependencies of the package
- <a id="pkgvar-installed">`installed`</a>:
whether the package is installed
- <a id="pkgvar-enable">`enable`</a>:
takes the value "enable" or "disable" depending on whether the package is
installed
- <a id="pkgvar-enable">`enable`</a>: is not a variable.
`pkg1+pkg2+...+pkgN:enable` is syntactic sugar for
`pkg1+pkg2+...+pkgN:installed?enable:disable`. That is, it behaves like a
variable that takes the value "enable" or "disable" depending on whether the
package(s) is installed
- <a id="pkgvar-pinned">`pinned`</a>: whether the package is pinned
- <a id="pkgvar-dirs">`bin`, `sbin`, `lib`, `man`, `doc`, `share`, `etc`</a>:
the corresponding directories for this package (similar to
Expand Down
2 changes: 2 additions & 0 deletions master_changes.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,8 @@ users)

## Doc

* Clarify documentation for `enable` pseudo-variable

## Security fixes

# API updates
Expand Down

0 comments on commit efff965

Please sign in to comment.