Nothing in locale.api.php belongs there

@webchick: thanks!

In fact, we should not only remove the parts that were already moved to language.api.php but move the rest too. language.module is the base language management UI so language.api.php is the place for all base language API docs. The hooks documented here are not in fact part of either language module or locale module, they are part of the language base system (housed on bootstrap.inc and language.inc), but we don't really have a better place to document these hooks.

Since there are no locale hooks documented whatsoever, this effectively removes locale.api.php.

Note that I made no changes to the docs in any way. I just copy-pasted. The hooks are already all hook_language_*().

Ok retitled for the base problem of the issue :) So we have these in locale.api.php:

function hook_language_init() {
}
function hook_language_switch_links_alter(array &$links, $type, $path) {
}
function hook_language_types_info() {
}
function hook_language_types_info_alter(array &$language_types) {
}
function hook_language_negotiation_info() {
}
function hook_language_negotiation_info_alter(array &$negotiation_info) {
}
function hook_language_fallback_candidates_alter(array &$fallback_candidates) {
}

All these are invoked only from the base include files of bootstrap.inc and language.inc, in order:

core/includes/bootstrap.inc:    bootstrap_invoke_all('language_init');
core/includes/language.inc:        drupal_alter('language_switch_links', $result, $type, $path);
core/includes/language.inc:    $language_types = module_invoke_all('language_types_info');
core/includes/language.inc:    drupal_alter('language_types_info', $language_types);
core/includes/language.inc:    $negotiation_info = module_invoke_all('language_negotiation_info');
core/includes/language.inc:     drupal_alter('language_negotiation_info', $negotiation_info);
core/includes/language.inc:    drupal_alter('language_fallback_candidates', $fallback_candidates);

Therefore we can conclude all those hooks are defined by the base system as per your grouping and should go to system.module. I think these are numerous enough to warrant their own file.

The rest of the hooks documented in locale.api.php are all hook_locale_language_*() which since been all moved to language.api.php and renamed to hook_language_*(). All of those are new to D8.

This makes locale.api.php disappear with items removed and moving to language.api.php in system module. I *did not* make any changes to the docs themselves. Just modified the @file header to properly explain what hooks are these.

Thanks, http://api.drupal.org/api/drupal/modules%21locale%21locale.api.php/7 also has lots of system level hooks documented. The last two are D7 hooks (the first before the last one was removed entirely in D8 and the last one was replaced by more general hooks). So I think this would apply to D7 if we want to clean up API docs placement there too. Feel free to move back to D8 fixed if that is not the case.

Ok, here is a D7 version. Because D7 does have two hooks from locale module, locale.api.php is kept with those.