Issue #11786 has been updated by Daniele Sluijters.

Daniel Pittman wrote:
> Hey.  So, the decision was made by the platform team that they wouldn't take 
> this change, or a change to simple disable `puppet doc`, in the 2.7 branch.  
> It should be as close to correct as it will get with the 3.x releases.  Sorry.

Great, this ticket was closed but the bug has not been fixed, namely that we 
can't generate documentation:

> Error: Could not generate documentation: the version of RDoc included in Ruby 
> 1.9.3 is not supported

It's really beyond me why this can't get fixed / can't get any priority to be 
fixed. It's ridiculous that we can't generate documentation for modules. I'm 
amazed no one seems to give a damn about this, especially if you take into 
account the Forge and how useful this could be. I've also deposited the 
suggestion to just use Yard instead since that it what is being used to 
document Puppet itself now but that too was shot down.

----------------------------------------
Feature #11786: `puppet doc` is not compatible with newer RDoc - thus with Ruby 
1.9
https://projects.puppetlabs.com/issues/11786#change-98970

* Author: Justin Stoller
* Status: Closed
* Priority: Normal
* Assignee: 
* Category: ruby19
* Target version: 
* Affected Puppet version: development
* Keywords: ruby1.9.3
* Branch: https://github.com/puppetlabs/puppet/pull/377
----------------------------------------
The `puppet doc` code depends heavily on RDoc to do the documentation 
generation.

Unfortunately, while the Ruby 1.8 series exclusively used RDoc 1.*, the Ruby 
1.9 uses 3.* and 4.* versions.  These are solidly incompatible with the way we 
used and integrated with RDoc in the `puppet doc` application.

We need to support the `puppet doc` features in a way that also works with 
newer Ruby.


-- 
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.

Reply via email to