Issue #22528 has been updated by Nick Fagerlund.
Thinking more on it: "Since" is irrelevant, and the modified "since" you propose is still not quite sufficient, even if you insert the activation condition into the tag. It could be made to work, but only if you type the exact same comment perfectly for every function it applies to -- that's a reasonable restriction for two-word tags, less reasonable for natural language like your example. To recap, I want to spatially isolate any functions that aren't applicable unless experimental features are enabled. I also want to ensure that these isolated functions are grouped by required feature. To do this, I need an indication of: * The fact that the function is not available in vanilla configurations. * The exact feature(s) required to use the function. Note that the version in which the feature arrived is not really relevant -- that information is already provided by the archived set of function references. We don't need to duplicate it in each version's function reference. So, I need something like "requires" more than I need something like "since." ---------------------------------------- Bug #22528: Functions that require the future parser should be concretely identifiable https://projects.puppetlabs.com/issues/22528#change-98575 * Author: Nick Fagerlund * Status: Accepted * Priority: Normal * Assignee: * Category: * Target version: * Affected Puppet version: * Keywords: * Branch: ---------------------------------------- Take a look at the function reference: http://docs.puppetlabs.com/references/3.latest/function.html There are a bunch of functions in there that will just plain explode on a stock Puppet 3.x install. (each, collect, etc.) This is because there's no indication in these functions' code that they require the future parser. We need an indication of this built into the function API, not only for the sake of documentation but also to improve error handling, etc. -- You have received this notification because you have either subscribed to it, or are involved in it. To change your notification preferences, please click here: http://projects.puppetlabs.com/my/account -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/puppet-bugs. For more options, visit https://groups.google.com/groups/opt_out.
