Issue #6267 has been updated by James Turnbull.

Target version deleted (2.6.5)


----------------------------------------
Bug #6267: puppetdoc symbol matching prefers individual tokens a little too 
much.
https://projects.puppetlabs.com/issues/6267

Author: Nick Moffitt
Status: Available In Testing Branch
Priority: Normal
Assignee: 
Category: documentation
Target version: 
Affected Puppet version: 2.6.3
Keywords: puppetdoc rdoc parser
Branch: https://github.com/masterzen/puppet/tree/tickets/2.6.x/6267


I have a number of classes surrounding the management of Apache in
various contexts.  To that end, I have classes like:

        apache::install
        apache::mpm::worker::install
        apache::mpm::prefork::install
        apache::mpm::event::install

...and so on.  When I mention in (say) the
`apache::mpm::worker::install` documentation-comment that it conflicts
with `apache::mpm::prefork::install`, my resulting rdoc output links
each word of that complete class path to arbitrary classes with
identical names all over my manifests.  In particular, it links the word
`install` to the class being documented, and not the one to which I was
referring!

What I would prefer is for the parser to recognize
full::class::specifications and use them in total, in preference to the
individual element matching.  At the very least the individual elements
should point to the correct class documentation pages given the path
before them.



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

Reply via email to