[documentation] Need CVS + Drupal Issues guidance: How to help fix API documentation formatting

Sean Burlington sean at practicalweb.co.uk
Tue Jun 3 09:55:42 UTC 2008


Steven Jones wrote:
> But hook_nodeapi for example won't be in core, because there is no
> 'hook' module in core to implement them, the 'hook' is just a
> placeholder. So instead, there's a special bit of the contrib CVS repo
> that has extra documentation for these 'phantom' functions. This gets
> checked out to the directories parsed by a.d.o too.
> 

Slight aside (this doesn't address CVS issues)

...hook_nodeapi isn't in core - but node_invoke_nodeapi is

- and this is what defines the hook

I wonder how hard it would be to alter the api module to recognise hooks 
in this way - and then to add the references (eg forum_nodeapi)

At the moment the only link between these is generated by the comment 
"implementation of hook_nodeapi"

I might have a look at doing this...

-- 

Sean Burlington

www.practicalweb.co.uk
company number 06427950


More information about the documentation mailing list