Issue #11384 has been updated by Jan Vansteenkiste.
I've worked around this by splitting out documentation in a new file
<pre>
class foobar {
#:include: vhost.README.md
$hash = {
}
}
</pre>
----------------------------------------
Bug #11384: Hash in class parameter breaks doc generation
https://projects.puppetlabs.com/issues/11384#change-93147
* 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.
