Issue #11384 has been updated by Keith Edmunds.
We're hitting this problem, too. It's disappointing that a bug that is two years old and easy to reproduce has not apparently had any attention. Most would agree that good documentation is a fundamental part of good software engineering. A broken documentation system should justify more focus than this bug appears to be receiving. Any timescale for a fix? Thanks, Keith ---------------------------------------- Bug #11384: Hash in class parameter breaks doc generation https://projects.puppetlabs.com/issues/11384#change-99712 * Author: Carlos Sanchez * Status: Accepted * Priority: Low * Assignee: * Category: parser * Target version: * Affected Puppet version: 2.7.9 * Keywords: rdoc puppetdoc hash doc parameterized class * Branch: ---------------------------------------- Having a hash in a class parameter makes the Class documentation to be discarded when running puppetdoc Running `puppet doc --mode rdoc --manifestdir test/manifests/test.pp --modulepath ./` `test/manifests/test.pp` <pre> # Class: test # # test class. This comment is ignored by puppetdoc class test( $p = {} ) { } # Class: test2 # # test2 class. This comment is NOT ignored by puppetdoc class test2() { } </pre> I tried to narrow it down and seems an issue at manifest parse time, as the `klass.doc` variable is already "" in `puppet/util/rdoc/parser.rb` -- 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. For more options, visit https://groups.google.com/groups/opt_out.
