Issue #19972 has been updated by Richard Pijnenburg.
Took a while but found the issue. Some texts in the defines make rdoc unhappy. Either rdoc needs to parse them as simple text or i need to find a way to have it modified so rdoc accepts it. Example is https://github.com/electrical/puppet-logstash/blob/master/manifests/output/email.pp#L73-L83 ---------------------------------------- Bug #19972: puppet doc fails against forge.puppetlabs.com/ispavailability/logstash https://projects.puppetlabs.com/issues/19972#change-90655 * Author: James Glenn * Status: Unreviewed * Priority: Low * Assignee: * Category: * Target version: * Affected Puppet version: * Keywords: puppet doc rdoc * Branch: ---------------------------------------- I'll be posting this bug there also. Summary: puppet doc fails against forge.puppetlabs.com/ispavailability/logstash Steps to Reproduce: 1. Install http://forge.puppetlabs.com/ispavailability/logstash/0.1.0.tar.gz into modules directory. 2. puppet doc --verbose --trace --all --environment production --mode rdoc --outputdir /www/sites/example.com/files/html/doc --manifestdir /etc/puppet/manifests --modulepath /etc/puppet/modules Expected Results: No error. Actual Results: /usr/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:291: warning: Object#type is deprecated; use Object#class Error: Could not generate documentation: undefined method `level' for nil:NilClass /usr/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:292:in `add_list_breaks' /usr/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:282:in `each' /usr/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:282:in `add_list_breaks' /usr/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:153:in `normalize' /usr/lib/ruby/1.8/rdoc/markup/simple_markup.rb:459:in `group_lines' /usr/lib/ruby/1.8/rdoc/markup/simple_markup.rb:255:in `convert' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:246:in `old_markup' /usr/lib/ruby/vendor_ruby/puppet/util/rdoc/generators/puppet_generator.rb:41:in `markup' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:980:in `description' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:451:in `build_method_detail_list' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:439:in `each' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:439:in `build_method_detail_list' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:437:in `each' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:437:in `build_method_detail_list' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:436:in `each' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:436:in `build_method_detail_list' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:677:in `value_hash' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:657:in `map' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:657:in `value_hash' /usr/lib/ruby/vendor_ruby/puppet/util/rdoc/generators/puppet_generator.rb:414:in `value_hash' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:634:in `write_on' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:1293:in `gen_into' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:1293:in `open' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:1293:in `gen_into' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:1289:in `each' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:1289:in `gen_into' /usr/lib/ruby/1.8/rdoc/generators/html_generator.rb:1277:in `generate_html' /usr/lib/ruby/vendor_ruby/puppet/util/rdoc/generators/puppet_generator.rb:88: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' /usr/lib/ruby/vendor_ruby/puppet/util/rdoc.rb:42:in `rdoc' /usr/lib/ruby/vendor_ruby/puppet/application/doc.rb:188:in `rdoc' /usr/lib/ruby/vendor_ruby/puppet/application/doc.rb:167:in `send' /usr/lib/ruby/vendor_ruby/puppet/application/doc.rb:167:in `run_command' /usr/lib/ruby/vendor_ruby/puppet/application.rb:364:in `run' /usr/lib/ruby/vendor_ruby/puppet/application.rb:456:in `plugin_hook' /usr/lib/ruby/vendor_ruby/puppet/application.rb:364:in `run' /usr/lib/ruby/vendor_ruby/puppet/util.rb:504:in `exit_on_fail' /usr/lib/ruby/vendor_ruby/puppet/application.rb:364:in `run' /usr/lib/ruby/vendor_ruby/puppet/util/command_line.rb:132:in `run' /usr/lib/ruby/vendor_ruby/puppet/util/command_line.rb:86:in `execute' /usr/bin/puppet:4 Notes: I used lots of other modules including others from ispavailability and this is the only one that "breaks" puppet doc. If I remove this module the above command works as expected. Linux puppet-master02 2.6.32-5-amd64 #1 SMP Sun Sep 23 10:07:46 UTC 2012 x86_64 GNU/Linux Debian GNU/Linux 6.0.7 (squeeze) Puppet version: 3.1.1 -- 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 unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/puppet-bugs?hl=en. For more options, visit https://groups.google.com/groups/opt_out.
