[documentation] [bug] Incomplete documentation on hook_help

[drewish]

Issue status update for 
http://drupal.org/node/40695
Post a follow up: 
http://drupal.org/project/comments/add/40695

 Project:      Documentation
 Version:      <none>
 Component:    Developer Guide
 Category:     bug reports
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  fgm
 Updated by:   drewish
 Status:       active

Would you mind posting a patch that begins to correct this? Having one
would make it easy to start a discussion.




drewish



Previous comments:
------------------------------------------------------------------------

Sat, 10 Dec 2005 20:54:59 +0000 : fgm

The current API documentation for hook_help [1] says hook_help is called
with a $section parameter with a definite set of values, enumerated on
the page.


However hook_help is also invoked with at least two other non
documented values:



* from the admin/help page, the hook is invoked with $section ==
'admin/help'
* from the admin/help/<modulename> page, the hook is invoked twice:

* once with $section == 'admin/help#<modulename>' as documented
* once with $section == 'admin/help/<modulename>' which is not
documented



While the second invocation on admin/help/<modulename> seems redundant
and one of the calls might have to be removed or at least documented as
obsoleted, the ability for the hook to be fired from the main help page
is valuable in that it allows a module creator to insert documentation
in the main help page, so the doc should be amended to specify that
behaviour.


[1] http://drupaldocs.org/api/head/function/hook_help\" title=\"Drupal
hook_help API