Err, I think google groups may have eaten my response. But THANK YOU, and
I'm adjusting the guide to patch all these holes as we speak.
On Friday, August 24, 2012 6:33:01 AM UTC-7, Henrik Lindberg wrote:
>
> EXCELLENT GUIDE !!!
> I which that had been available when I started on Geppetto :)
>
> Here are some things that I would like the documentation to clarify:
>
> - How do I create strings that span multiple lines? (Since there is no
> string concatenation operator 'x' + 'y' does not work). Can I write a
> string that continues on the next line? If so, is the newline included
> or not? Can I tell it to not include the newline? How is the line-break
> encoded - if it is CR-LF in the pp-file, does the string contain that at
> runtime?
>
> - Can I write more complex expressions in an interpolation? Can I do
> something like "The sum is ${$a + $b}", and if that is the case, is it
> possible to have any expression interpolated (including nested strings
> with interpolation)?
>
> - The compiler allows ${a} without double quotes - which is a string
> interpolation of $a. Which IIRC is slightly different than using $a
> directly (getting an empty string if $a is undefined). I don't recall
> seeing that in the documentation on the first read through.
>
> - IIRC, Use of numerical variables $0 - $9 as a result of regular
> expression matching was not mentioned. When talking about variables I
> think it is worth noting that you should not use $0 - $9 for anything
> else (or you may be surprised as the regexp match creates an inner scope
> where these variables refer to match results). (IMO use of $0-$9 should
> be reserved for that purpose and they should not be assignable).
>
> - Arrays and Hashes are mutable; which is either an bug or a language
> feature. While it is not allowed to directly change a variable, it can
> be indirectly modified if it refers to an array or hash. Great if the
> documentation can clarify if this is a supported feature or should be
> avoided. i.e. $a = [1,2,3] $a[0] = 10. (IMO, this is problematic as any
> logic can refer to the variable and assign to an entry - at least last I
> tried).
>
>
> Again, an excellent language reference!
> Regards
> - henrik
>
>
> On 2012-21-08 22:40, Nick Fagerlund wrote:
> > Hi all,
> >
> > I've finished the all new Puppet 2.7 language reference. EXCITING! Well,
> > exciting to me, at least. Table of contents:
> >
> > http://docs.puppetlabs.com/puppet/2.7/reference/
> >
> > Visual index (for when you know what you're looking for but you don't
> > know what it's called):
> >
> > http://docs.puppetlabs.com/puppet/2.7/reference/lang_visual_index.html
> >
> > And of course, use the navigation in the left sidebar to jump between
> > pages.
> >
> > Our goal here is to nail down every detail of how the Puppet language
> > works, then cut new versions along with major Puppet releases. We'll
> > eventually be expanding this versioned document with non-language
> > details -- we've been referring to this plan as the "Puppet reference
> > manual." Its purpose isn't to replace any of the guides or how-tos, but
> > to lay down a "just the facts" baseline that lets you get in and out
> fast.
> >
> > Anyway, we hope you find it useful. Thanks for using Puppet.
> >
> > --
> > You received this message because you are subscribed to the Google
> > Groups "Puppet Users" group.
> > To view this discussion on the web visit
> > https://groups.google.com/d/msg/puppet-users/-/bDBvT082CjQJ.
> > To post to this group, send email to
> > [email protected]<javascript:>.
>
> > To unsubscribe from this group, send email to
> > [email protected] <javascript:>.
> > For more options, visit this group at
> > http://groups.google.com/group/puppet-users?hl=en.
>
>
>
--
You received this message because you are subscribed to the Google Groups
"Puppet Users" group.
To view this discussion on the web visit
https://groups.google.com/d/msg/puppet-users/-/LtQL3BU9KAAJ.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/puppet-users?hl=en.