Issue #11384 has been updated by Marc Tardif.
A workaround for this issue is to use the hash() function from the stdlib module. To create an empty hash, simply pass an empty array: hash([]) ---------------------------------------- Bug #11384: Hash in class parameter breaks doc generation https://projects.puppetlabs.com/issues/11384#change-93137 * 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.
