Hi, I have no idea if this has come up before, I didn''t bother to check the archives or anything, but I was wondering if it would be possible to have Puppet''s documentation reflect the version in which a certain feature was added. For example, I just added a user to my catalog using the ''system'' parameter, as per http://docs.puppetlabs.com/references/latest/type.html#user: system Whether the user is a system user with lower UID. Valid values are true, false. And now all my 2.6.3 nodes are complaining: "Invalid parameter system at /etc/puppet/manifests/..." A little digging into the source revealed to me, that this feature is not present in 2.6.3, but it is in 2.7.5. I have no idea in what version it was introduced. It would be nice if the type reference would contain that information. Best regards, Martijn Grendelman -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
----- Original Message -----> Hi, > > I have no idea if this has come up before, I didn''t bother to check > the > archives or anything, but I was wondering if it would be possible to > have > Puppet''s documentation reflect the version in which a certain feature > was > added. > > For example, I just added a user to my catalog using the ''system'' > parameter, as per > http://docs.puppetlabs.com/references/latest/type.html#user: > > system > Whether the user is a system user with lower UID. Valid values > are > true, false. > > And now all my 2.6.3 nodes are complaining: > > "Invalid parameter system at /etc/puppet/manifests/..." > > A little digging into the source revealed to me, that this feature is > not > present in 2.6.3, but it is in 2.7.5. I have no idea in what version > it was introduced. > > It would be nice if the type reference would contain that > information.It would indeed, you can though ask your puppet installs using: puppet describe user or on older: pi user these are always appropriate for your version of puppet, might help. -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
On Fri, Oct 14, 2011 at 7:05 AM, Martijn Grendelman <martijn@iphion.nl>wrote:> Hi, > > I have no idea if this has come up before, I didn''t bother to check the > archives or anything, but I was wondering if it would be possible to have > Puppet''s documentation reflect the version in which a certain feature was > added. > > For example, I just added a user to my catalog using the ''system'' > parameter, as per > http://docs.puppetlabs.com/references/latest/type.html#user: > > system > Whether the user is a system user with lower UID. Valid values are > true, false. > > And now all my 2.6.3 nodes are complaining: > > "Invalid parameter system at /etc/puppet/manifests/..." > > A little digging into the source revealed to me, that this feature is not > present in 2.6.3, but it is in 2.7.5. I have no idea in what version it > was introduced. > > It would be nice if the type reference would contain that information. > >If you go to the Quick Nav menu, you can get to the docs for other versions: http://docs.puppetlabs.com/references/ Then: http://docs.puppetlabs.com/references/2.6.11/type.html should contain what you need I believe ? -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
On Fri, 14 Oct 2011 10:04:19 -0700, Nigel Kersten wrote:> > On Fri, Oct 14, 2011 at 7:05 AM, Martijn Grendelman <martijn@iphion.nl>wrote: > > > Hi, > > > > I have no idea if this has come up before, I didn''t bother to check the > > archives or anything, but I was wondering if it would be possible to have > > Puppet''s documentation reflect the version in which a certain feature was > > added. > > > > For example, I just added a user to my catalog using the ''system'' > > parameter, as per > > http://docs.puppetlabs.com/references/latest/type.html#user: > > > > system > > Whether the user is a system user with lower UID. Valid values are > > true, false. > > > > And now all my 2.6.3 nodes are complaining: > > > > "Invalid parameter system at /etc/puppet/manifests/..." > > > > A little digging into the source revealed to me, that this feature is not > > present in 2.6.3, but it is in 2.7.5. I have no idea in what version it > > was introduced. > > > > It would be nice if the type reference would contain that information. > > > > > If you go to the Quick Nav menu, you can get to the docs for other versions: > http://docs.puppetlabs.com/references/ > > Then: > http://docs.puppetlabs.com/references/2.6.11/type.html > > should contain what you need I believe ? >I think he wants something more along the lines of the "since" sections you can create with newer versions of YARD when documenting methods. For for example: http://rubydoc.info/gems/octocat_herder/0.1.1/OctocatHerder/PullRequest#diff_text-instance_method -- Jacob Helwig
On Fri, Oct 14, 2011 at 11:11 AM, Jacob Helwig <jacob@puppetlabs.com> wrote:> On Fri, 14 Oct 2011 10:04:19 -0700, Nigel Kersten wrote: > > > > On Fri, Oct 14, 2011 at 7:05 AM, Martijn Grendelman <martijn@iphion.nl > >wrote: > > > > > Hi, > > > > > > I have no idea if this has come up before, I didn''t bother to check the > > > archives or anything, but I was wondering if it would be possible to > have > > > Puppet''s documentation reflect the version in which a certain feature > was > > > added. > > > > > > For example, I just added a user to my catalog using the ''system'' > > > parameter, as per > > > http://docs.puppetlabs.com/references/latest/type.html#user: > > > > > > system > > > Whether the user is a system user with lower UID. Valid values are > > > true, false. > > > > > > And now all my 2.6.3 nodes are complaining: > > > > > > "Invalid parameter system at /etc/puppet/manifests/..." > > > > > > A little digging into the source revealed to me, that this feature is > not > > > present in 2.6.3, but it is in 2.7.5. I have no idea in what version it > > > was introduced. > > > > > > It would be nice if the type reference would contain that information. > > > > > > > > If you go to the Quick Nav menu, you can get to the docs for other > versions: > > http://docs.puppetlabs.com/references/ > > > > Then: > > http://docs.puppetlabs.com/references/2.6.11/type.html > > > > should contain what you need I believe ? > > > > I think he wants something more along the lines of the "since" sections > you can create with newer versions of YARD when documenting methods. > > For for example: > http://rubydoc.info/gems/octocat_herder/0.1.1/OctocatHerder/PullRequest#diff_text-instance_methodThat''s pretty sweet. -- Nigel Kersten Product Manager, Puppet Labs -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
Martijn Grendelman
2011-Oct-17 07:56 UTC
Re: [Puppet Users] Type reference, Puppet versions
On 14-10-11 20:14, Nigel Kersten wrote:> > > On Fri, Oct 14, 2011 at 11:11 AM, Jacob Helwig <jacob@puppetlabs.com > <mailto:jacob@puppetlabs.com>> wrote: > > On Fri, 14 Oct 2011 10:04:19 -0700, Nigel Kersten wrote: > > > > On Fri, Oct 14, 2011 at 7:05 AM, Martijn Grendelman > <martijn@iphion.nl <mailto:martijn@iphion.nl>>wrote: > > > > > Hi, > > > > > > I have no idea if this has come up before, I didn''t bother to > check the > > > archives or anything, but I was wondering if it would be possible > to have > > > Puppet''s documentation reflect the version in which a certain > feature was > > > added. > > > > > > For example, I just added a user to my catalog using the ''system'' > > > parameter, as per > > > http://docs.puppetlabs.com/references/latest/type.html#user: > > > > > > system > > > Whether the user is a system user with lower UID. Valid values are > > > true, false. > > > > > > And now all my 2.6.3 nodes are complaining: > > > > > > "Invalid parameter system at /etc/puppet/manifests/..." > > > > > > A little digging into the source revealed to me, that this feature > is not > > > present in 2.6.3, but it is in 2.7.5. I have no idea in what > version it > > > was introduced. > > > > > > It would be nice if the type reference would contain that information. > > > > > > > > If you go to the Quick Nav menu, you can get to the docs for other > versions: > > http://docs.puppetlabs.com/references/ > > > > Then: > > http://docs.puppetlabs.com/references/2.6.11/type.html > > > > should contain what you need I believe ? > > > > I think he wants something more along the lines of the "since" sections > you can create with newer versions of YARD when documenting methods. > > For for example: > http://rubydoc.info/gems/octocat_herder/0.1.1/OctocatHerder/PullRequest#diff_text-instance_method > > > That''s pretty sweet.Exactly what I meant! FWIW, I knew where to find the docs for my particular version, but I just have ''latest'' in my bookmarks. I did not know about ''puppet describe <type>'', which is pretty nice! Thanks! Best regards, Martijn Grendelman -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to puppet-users@googlegroups.com. To unsubscribe from this group, send email to puppet-users+unsubscribe@googlegroups.com. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.