Posted by ivanjaros on December 28, 2012 at 9:19pm
7 followers
| Project: | Drupal core |
| Version: | 7.x-dev |
| Component: | documentation |
| Category: | task |
| Priority: | normal |
| Assigned: | Unassigned |
| Status: | closed (fixed) |
| Issue tags: | needs backport to D7, Novice |
Issue Summary
In documentation for hook_menu_delete: http://api.drupal.org/api/drupal/modules!menu!menu.api.php/function/hook_menu_delete/7
there is a '$link' insted of '$menu'.
Comments
#1
Good catch!
While we're fixing this, first line should be changed from "Inform modules that..." to say "Respond to...".
http://drupal.org/node/1354#hooks
#2
This got fixed for d8 in #1814916: Convert menus into entities
#3
D7 patch for #1.
#4
#5
There is still a problem in D8 that needs to be addressed (which is addressed in this d7 patch, but we need to fix d8 before fixing d7): the first lines of all the hook docs in menu.api.php are incorrect. So can we get a patch for d8 that fixes them as in the existing d7 patch? Thanks!
Oh actually, the d7 patch says things like:
Respond to a custom menu was created.
That isn't very good English. How about "Respond to custom menu creation"? And similar for the other hooks.
#6
oops,seems i missed #1..sorry for the noise.restoring tag as well
#7
Ok. I will follow up on this.
#8
This D8 patch corrects the subject line.
#9
Thanks! Please change "Responds" to "Respond" -- see
http://drupal.org/node/1354#hooks
#10
Hi, the correction is included in this version.
#11
Looks good! I'll get this committed to 8.x shortly, and then we can return to the 7.x patch.
#12
Thanks again -- Committed the patch in #10 to Drupal 8.
Now we can return to the patch in #3 for Drupal 7, which needs the first lines of the hook documentation to look like the patch in #10.
#13
How about this? See patch...
#14
Hi, -13 patch needs another fix in hook_menu_delete. You can look at -1.patch. This @link parameter is fixed in D8. This is why it is not included in the D8 patch.
#15
Added that change. How about now?
#16
#17
Looks good -- thanks! I'll get this committed shortly.
#18
Thanks again -- this is committed to 7.x.
#19
Automatically closed -- issue fixed for 2 weeks with no activity.