Posted by catch on March 7, 2009 at 10:25pm
Jump to:
| Project: | API |
| Version: | 6.x-1.x-dev |
| Component: | Code |
| Category: | feature request |
| Priority: | normal |
| Assigned: | Unassigned |
| Status: | closed (won't fix) |
Issue Summary
With all the de-opping of Drupal 7, it's hard to compare menu_block() and other de-opped functions between Drupal 6 and Drupal 7.
i.e. http://api.drupal.org/api/function/menu_block/6
http://api.drupal.org/api/function/menu_block_view/7
It'd be useful to have some cross-linking on api.drupal.org for these, although I don't have any ideas on how to do it.
Comments
#1
The currently accepted way to do this now on api.drupal.org is to add a comment to both pages. For instance, see
http://api.drupal.org/api/function/hook_block/6#comment-502
which tells you that hook_block() in Drupal 7 is now hook_block_$op
Given that the function headers are trying to document the current purpose/functionality of the functions, I don't think we want to include a note telling the entire history of the function, or what it used to be called. Nor do we want to go back to Drupal 6 and note down what it will be called in a future version. That's what the module upgrade pages are for, and it would also be a nightmare to try to maintain these links.
So my recommendation would be to mark this "won't fix". As I'm not the maintainer of the API module, I'll leave that for someone else to do...
#2
Yeah this was opened before we had comments on api.drupal.org, I think comments are a fine enough way to document this.