diff options
author | Angie Byron <webchick@24967.no-reply.drupal.org> | 2010-10-06 03:43:01 +0000 |
---|---|---|
committer | Angie Byron <webchick@24967.no-reply.drupal.org> | 2010-10-06 03:43:01 +0000 |
commit | 5144743ad3d941b03ccf3aee54fd806154f0736b (patch) | |
tree | 49e7bd7cd1fc5ce9d4aee8a55df7d5d93228826e /modules/help | |
parent | d63aef074cd71332ac2ffbd32b9d18686de2b912 (diff) | |
download | brdo-5144743ad3d941b03ccf3aee54fd806154f0736b.tar.gz brdo-5144743ad3d941b03ccf3aee54fd806154f0736b.tar.bz2 |
#930566 by Benjamin Melançon: Clarify hook_help() documentation for dealing with wildcards.
Diffstat (limited to 'modules/help')
-rw-r--r-- | modules/help/help.api.php | 32 |
1 files changed, 16 insertions, 16 deletions
diff --git a/modules/help/help.api.php b/modules/help/help.api.php index 83314e8fd..02c9b3527 100644 --- a/modules/help/help.api.php +++ b/modules/help/help.api.php @@ -14,30 +14,30 @@ /** * Provide online user help. * - * By implementing hook_help(), a module can make documentation - * available to the user for the module as a whole, or for specific paths. - * Help for developers should usually be provided via function - * header comments in the code, or in special API example files. + * By implementing hook_help(), a module can make documentation available to + * the user for the module as a whole, or for specific paths. Help for + * developers should usually be provided via function header comments in the + * code, or in special API example files. * * For a detailed usage example, see page_example.module. * * @param $path - * The router menu path, as defined in hook_menu(), for the help that - * is being requested; e.g., 'admin/node' or 'user/edit'. If the router path - * includes a % wildcard, then this will appear in $path; for example, - * node pages would have $path equal to 'node/%' or 'node/%/view'. Your hook - * implementation may also be called with special descriptors after a - * "#" sign. Some examples: - * - admin/help#modulename - * The main module help text, displayed on the admin/help/modulename - * page and linked to from the admin/help page. - * - user/help#modulename - * The help for a distributed authorization module (if applicable). + * The router menu path, as defined in hook_menu(), for the help that is + * being requested; e.g., 'admin/people' or 'user/register'. If the router + * path includes a wildcard, then this will appear in $path as %, even if it + * is a named %autoloader wildcard in the hook_menu() implementation; for + * example, node pages would have $path equal to 'node/%' or 'node/%/view'. + * To provide a help page for a whole module with a listing on admin/help, + * your hook implementation should match a path with a special descriptor + * after a "#" sign: + * 'admin/help#modulename' + * The main module help text, displayed on the admin/help/modulename + * page and linked to from the admin/help page. * @param $arg * An array that corresponds to the return value of the arg() function, for * modules that want to provide help that is specific to certain values * of wildcards in $path. For example, you could provide help for the path - * 'user/1' by looking for the path 'user/%' and $arg[1] == '1'. This + * 'user/1' by looking for the path 'user/%' and $arg[1] == '1'. This given * array should always be used rather than directly invoking arg(), because * your hook implementation may be called for other purposes besides building * the current page's help. Note that depending on which module is invoking |