Closed (works as designed)
Project:
Facebook OAuth (FBOAuth)
Version:
7.x-1.x-dev
Component:
Documentation
Priority:
Minor
Category:
Bug report
Assigned:
Unassigned
Reporter:
Created:
8 Mar 2012 at 23:00 UTC
Updated:
9 Mar 2012 at 01:23 UTC
fboauth.api.php had its hook functions switched.
| Comment | File | Size | Author |
|---|---|---|---|
| fboauth-apidocs.patch | 750 bytes | mrf |
Comments
Comment #1
mrf commentedComment #2
quicksketchThis patch doesn't make sense. Why would you put an
@see hook_fboauth_user_save()in the PHPdoc ofhook_fboauth_user_save()? The idea is that each hook tells the user to look at the other one. They're not supposed to reference themselves.Comment #3
mrf commentedAhhh ok that makes sense, I typically think of these example hook implementations as something to be copied and pasted, but you're right about it not making sense within the file itself if that change is made.
Comment #4
quicksketchThe primary purpose of the @see references is so that if FBOAuth is indexed by an API site (like api.drupal.org) links will automatically be generated to related functions. I see where you're coming from too, but that approach is not common in Drupal development.