Hugh Cole-Baker
2012-Oct-03 13:31 UTC
[Puppet Users] Puppet doc no longer producing documentation
After upgrading to Puppet 3.0.0 it seems that puppet doc is no longer producing documentation from my modules / manifests. I have a setup with two environments in /etc/puppet/environments/[production, testing], and I''m running the following command to generate the docs: puppet doc --all --mode rdoc --environment production --outputdir doc After running this it creates the ''doc'' directory but there are no files in it. The same command was working OK on 2.7.19. Has anything changed in the required format of doc comments in the manifests? -- 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/-/_wWW_iC720cJ. 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.
Jeff McCune
2012-Oct-04 20:00 UTC
Re: [Puppet Users] Puppet doc no longer producing documentation
On Wed, Oct 3, 2012 at 6:31 AM, Hugh Cole-Baker <hugh@fanduel.com> wrote:> After upgrading to Puppet 3.0.0 it seems that puppet doc is no longer > producing documentation from my modules / manifests. > I have a setup with two environments in > /etc/puppet/environments/[production, testing], and I''m running the > following command to generate the docs: > > puppet doc --all --mode rdoc --environment production --outputdir doc > > After running this it creates the ''doc'' directory but there are no files in > it. > The same command was working OK on 2.7.19. > > Has anything changed in the required format of doc comments in the > manifests?This is likely a bug. Could you please file an issue at http://projects.puppetlabs.com/projects/puppet describing the problem and snippets of commands showing how to reproduce the issue? If you follow up to this conversation with the ticket number, I''ll start watching the ticket and work to reproduce the issue. With some effort we might be able to fix this for the 3.0.1 release. Thanks, -Jeff -- 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.
Hugh Cole-Baker
2012-Oct-05 15:09 UTC
Re: [Puppet Users] Puppet doc no longer producing documentation
On Thursday, October 4, 2012 9:01:58 PM UTC+1, Jeff McCune wrote:> > On Wed, Oct 3, 2012 at 6:31 AM, Hugh Cole-Baker <hu...@fanduel.com<javascript:>> > wrote: > > After upgrading to Puppet 3.0.0 it seems that puppet doc is no longer > > producing documentation from my modules / manifests. > > I have a setup with two environments in > > /etc/puppet/environments/[production, testing], and I''m running the > > following command to generate the docs: > > > > puppet doc --all --mode rdoc --environment production --outputdir doc > > > > After running this it creates the ''doc'' directory but there are no files > in > > it. > > The same command was working OK on 2.7.19. > > > > Has anything changed in the required format of doc comments in the > > manifests? > > This is likely a bug. Could you please file an issue at > http://projects.puppetlabs.com/projects/puppet describing the problem > and snippets of commands showing how to reproduce the issue? If you > follow up to this conversation with the ticket number, I''ll start > watching the ticket and work to reproduce the issue. With some effort > we might be able to fix this for the 3.0.1 release. > > Thanks, > -Jeff >Hi Jeff, I''ve created https://projects.puppetlabs.com/issues/16803 in the issue tracker. Thanks, Hugh -- 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/-/graOEp0CFq0J. 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.