Issue #16803 has been updated by Hugh Cole-Baker.
Oops, the wiki has removed newlines in the example command I wrote. It should
be:
cd /var/www
puppet doc —all —mode rdoc —environment production —outputdir doc
which then prints:
/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
----------------------------------------
Bug #16803: puppet doc not creating rdoc files
https://projects.puppetlabs.com/issues/16803#change-72769
Author: Hugh Cole-Baker
Status: Unreviewed
Priority: Normal
Assignee:
Category: documentation
Target version:
Affected Puppet version: 3.0.0
Keywords:
Branch:
After upgrading from 2.7.19 to 3.0.0, the process we used to use to generate
documentation from doc-comments in Puppet manifests seems to have stopped
working.
We run a webserver on the puppet master that serves static pages from
/var/www/doc. We have two environments defined, "testing" and "production".
These have identical directory structures in /etc/puppet/environments/[testing,
production]/ with subdirectories for manifests, modules, and templates in each
environment's directory.
To generate rdoc documentation for the "production" environment, I would run
(as root) on the puppet master:
cd /var/www
puppet doc --all --mode rdoc --environment production --outputdir doc
This produces the following output:
/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
It creates the 'doc' directory in /var/www but the directory is empty. This has
only broken since 3.0.0; in 2.7.19 a set of rdoc files would be generated in
the 'doc' directory.
I'm using Puppet installed via the Ubuntu packages from apt.puppetlabs.com,
running Puppet version 3.0.0-1puppetlabs1.
The operating system is Ubuntu 12.04.1 LTS (GNU/Linux 3.2.0-31-virtual x86_64).
I've attached a copy of my puppet.conf (server name removed).
--
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.
