Issue #4798 has been updated by R.I. Pienaar aka Volcane.
James tells me that puppet doc will search in the .. of the site.pp for modules, so if I re-arrange things according to that assumption, also removed the -o option: <pre> $ RUBYLIB=lib bin/puppet doc --mode rdoc --modulepath=/home/rip/manifests/modules --manifest=/home/rip/manifests/modules/site.pp --trace --debug /usr/lib/ruby/1.8/rdoc/dot/dot.rb:28: warning: already initialized constant NODE_OPTS /usr/lib/ruby/1.8/rdoc/dot/dot.rb:46: warning: already initialized constant EDGE_OPTS /usr/lib/ruby/1.8/rdoc/dot/dot.rb:76: warning: already initialized constant GRAPH_OPTS <snip> info: rdoc: scanning /home/rip/manifests/modules/greylistd/manifests/install.pp debug: rdoc: testing /home/rip/manifests/modules/greylistd/manifests/install.pp debug: rdoc: module greylistd into /home/rip/manifests/modules ? debug: rdoc: found module greylistd debug: rdoc: scanning for greylistd debug: rdoc: scanning manifest debug: rdoc: found new class greylistd::install debug: found realize: Package["greylistd"] ./lib/puppet/util/rdoc/generators/puppet_generator.rb:300:in `main_url' ./lib/puppet/util/rdoc/generators/puppet_generator.rb:299:in `each' ./lib/puppet/util/rdoc/generators/puppet_generator.rb:299:in `main_url' ./lib/puppet/util/rdoc/generators/puppet_generator.rb:199:in `gen_top_index' ./lib/puppet/util/rdoc/generators/puppet_generator.rb:183:in `gen_file_index' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:1279:in `generate_html' ./lib/puppet/util/rdoc/generators/puppet_generator.rb:70:in `generate_html' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:1197:in `generate' /usr/lib/ruby/1.8/rdoc/rdoc.rb:284:in `document' ./lib/puppet/util/rdoc.rb:35:in `rdoc' ./lib/puppet/application/doc.rb:85:in `rdoc' ./lib/puppet/application/doc.rb:59:in `send' ./lib/puppet/application/doc.rb:59:in `run_command' ./lib/puppet/application.rb:300:in `run' ./lib/puppet/application.rb:397:in `exit_on_fail' ./lib/puppet/application.rb:300:in `run' ./lib/puppet/util/command_line.rb:55:in `execute' bin/puppet:4 Could not generate documentation: undefined method `global' for #<RDoc::TopLevel:0x2b7e453e2f58> </pre> This took a long time to get to this point and did create a load of html in the doc directory though it didnt finish as there's no overall index for example - lots of modules have been documented though. If I run it with --debug I see it's scanning a lot of my .rb files that are in files of modules, if I rm all of those .rb files same error so that's probably a redherring. ---------------------------------------- Bug #4798: Puppet doc manifests documentation mode broken http://projects.puppetlabs.com/issues/4798 Author: James Turnbull Status: Ready for Testing Priority: High Assignee: Paul Berry Category: documentation Target version: 2.6.2 Affected version: 2.6.0 Keywords: Branch: http://github.com/stereotype441/puppet/tree/ticket/2.6.x/4798 In 2.6.1 (and looks like 2.6.0 also) the puppet doc manifests documentation is busted. <pre> $ puppet doc -o /tmp/doc -m rdoc /path/to/manifests/site.pp --debug </pre> Outputs: <pre> info: scanning: ["tmp/doc", "/path/to/manifests/site.pp"] </pre> And produces zilch output. -- 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 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-bugs?hl=en.
