Conversation
doc/man7/property.pod
Outdated
| "no". | ||
| the local clause overrides the context clause. | ||
|
|
||
| =head2 Override |
There was a problem hiding this comment.
The term "Override" does not fit anymore, use "Removal" or "Property Removal" instead?
Or maybe just remove the =head2 Override heading, making lines 136ff a second paragraph under =head2 Global and Local?
There was a problem hiding this comment.
I've taken the second option.
|
|
||
| It is possible for a local property query to override a clause in the context | ||
| It is possible for a local property query to remove a clause in the context | ||
| property query by preceeding the property name with a '-'. |
There was a problem hiding this comment.
(An alternative would be to use the tilde instead of the minus sign for removal: ~prop instead of -prop)
There was a problem hiding this comment.
~ would be a good =false equivalent at some stage in the future. (alternatively !)
\ is one of the common symbols used for set removal/subtraction in mathematics. (- is the other one which is the symbol being replaced). Perhaps even / to save backslash for future use.
Thoughts anyone?
There was a problem hiding this comment.
Well, I can live with the minus sign. The tilde was just a thought.
But you are right ?~prop looks much better than ?!prop, so let's better reserve the tilde for the unary negation operator. :-)
There was a problem hiding this comment.
The more syntax you have now, "for convenience" the more you limit the future, having to work around things. Almost all uses will be "fips=yes" or "dont care about fips" Support that, only that, in this release.
There was a problem hiding this comment.
It is fairly minimal at present. The only extra being the "optional" operator.
|
|
||
| It is possible for a local property query to override a clause in the context | ||
| It is possible for a local property query to remove a clause in the context | ||
| property query by preceeding the property name with a '-'. |
There was a problem hiding this comment.
Well, I can live with the minus sign. The tilde was just a thought.
But you are right ?~prop looks much better than ?!prop, so let's better reserve the tilde for the unary negation operator. :-)
|
If you squash the commit (which I assume you will), could you replace the term "doc-nits" in the commit message by something different? Because for me, a "doc-nit" is something that makes the Maybe something like: |
Reviewed-by: Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com> (Merged from #9090)
|
Merged thanks. Until 3.0 is actually released, the property definition and query syntaxes aren't fixed. There is still time to discuss |
|
Apologies for forgetting to close this. |
Addresses comments in #9042