-
Notifications
You must be signed in to change notification settings - Fork 351
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Clarify documentation for enable
pseudo-variable
#5659
base: master
Are you sure you want to change the base?
Conversation
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.
efff965
to
0b84e2e
Compare
- <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) are installed |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- <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) are installed | |
- <a id="pkgvar-enable">`enable`</a>: | |
takes the value "enable" or "disable" depending on whether the package is | |
installed. Used with the combination operator `+`, | |
`name1+name2+name3:enable` is syntactic sugar for | |
`name1+name2+name3:installed?enable:disable`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Used with combination operator `+`,
+ Used with the combination operator `+`,
test in #5642 updated |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Proposed a rewording. The combination part is a specific note on enabled
variable usage with combination; It should be put after the definition.
The documentation for variables says that for boolean variables the form
name1+name2+name3:var
is equivalent toname1:var & name2:var & name3:var
but it's possible to writename1+name2:enable
despiteenable
being the string "enable" or "disable". This change clarifies thatenable
isn't really a variable but syntactic sugar instead.