In #1541792: Enable dynamic allowed list values function with additional context we are changing the arguments passed to an allowed values function, and I realized there isn't any documentation for them.
list_test_allowed_values_callback() is the only example in core, and its docblock just says "Allowed values callback."
This is part of the Field API, but only applies to List field types that have allowed values.
One possibility is to document any custom settings in hook_field_info. This might be superseded by the OO Field API.
Comments
Comment #1
joachim CreditAttribution: joachim commentedNew standards for documenting callbacks apply here: http://drupal.org/node/1354#callback-def
Comment #4
David_Rothstein CreditAttribution: David_Rothstein as a volunteer commentedSome of the patches in #1621356: Pass all the parameters of hook_options_list() to options_list_callback have documentation of the various parameters for this callback that could perhaps be used in this issue.