On Mon, Jun 25, 2012 at 12:55 AM,  <no-re...@cfengine.com> wrote:
> Forum: CFEngine Help
> Subject: Re: It is possible to uses a slist variable in the inputs directive ?
> Author: davidlee
> Link to topic: https://cfengine.com/forum/read.php?3,26281,26299#msg-26299
>
> Where, please, does the ref. manual describe this quoting/non-quoting?

1.5 Syntax, identifiers and names

The CFEngine 3 language has a few simple rules:
CFEngine built-in words, and identifiers of your choosing (the names
of variables, bundles, body templates and classes) may only contain
the usual alphanumeric and underscore characters (‘a-zA-Z0-9_’).
All other `literal' data must be quoted.
...

CFEngine uses many `constraint expressions' as part of the body of a
promise. These take the form: left-hand-side (CFEngine word) ‘=>’
right-hand-side (user defined data). This can take several forms:
     cfengine_word => user_defined_template(parameters)
                      user_defined_template
                      builtin_function()
                      "quoted literal scalar"
                      { list }

As you can see from the preceeding paragraph, scalar values are
quoted, lists are not.




> I get the feeling that $(foo) has to be quoted every time, without exception.

That's right.

> But if I say @(bar), it seems that quoting is optional.  When such mentions 
> of @(bar) happen to occur in the ref. manual, the cases seem arbitrary and 
> confused.
>
> When should, and should not, mentions of lists of quoted?

Per the reference manual, as quoted above, mentions of lists are not quoted.

I am sorry your documentation bugs have not been acknowledged yet,
bugs in the documentation can really frustrate new users and barrier
adoption.

Yours truly,
Aleksey
_______________________________________________
Help-cfengine mailing list
Help-cfengine@cfengine.org
https://cfengine.org/mailman/listinfo/help-cfengine

Reply via email to