Closed (won't fix)
Project:
Site Documentation
Version:
5.x-1.x-dev
Component:
Code
Priority:
Minor
Category:
Feature request
Assigned:
Reporter:
Created:
17 Sep 2007 at 15:51 UTC
Updated:
25 Oct 2008 at 16:39 UTC
I had a need to see which modules implemented a couple of hooks. The code wasn't hard. I'm wondering if anyone would like to see this feature added into Sitedoc. Of course, an additional setting would be required to select which ones you want to see. It would probably also require using hook_sitedoc to have modules supply a list of the hooks they support, which can then be added to a (long) list of core hooks (if I can find the whole list). I haven't decided on whether that list should just be kept in the module source code or if I should create a little table to hold it; I'm kind of leaning toward a table so I don't have to add to the Variable list.
Comments
Comment #1
andrabr commentedThat would be sweet!
Comment #2
WorldFallz commented+1 definitely
Comment #3
nancydruI'm still trying to figure out how best to do this. The problem is contributed modules and finding out what hooks they provide.
Comment #4
nancydruComment #5
SamRose commentedThis might be possible with doxygen..? http://www.stack.nl/~dimitri/doxygen/
Comment #6
nancydruYes, the human would know from that, but I'm not sure how the module would use it dynamically.
Comment #7
SamRose commentedYeah, you're right of course. I guess I should have written "Maybe this module can't do it, but it might be possible to look for hooks with doxygen, and document the code that way instead"
This module doesn't really look like it was focused on documenting code anyway, I think?
Comment #8
nancydruNo, it's not to document code, but it is to document the site. I still think being able to list hook usage would be useful and may get back to it some day (perhaps 7 will be easier for this). And maybe I'll just have to build a list that admins can manually edit.