#717666 by heyrocker: Document hook_countries_alter().

modules/system/system.api.php

@@ -3208,6 +3208,19 @@ function hook_token_info_alter(&$data) {
   );
 }
 
+/**
+ * Alter the default country list.
+ *
+ * @param $countries
+ *   The associative array of countries keyed by ISO 3166-1 country code.
+ *
+ * @see country_get_list()
+ * @see _country_get_predefined_list()
+ */
+function hook_countries_alter(&$countries) {
+  // Quebec has seceded from Canada. Add to country list.
+  $countries['QC'] = 'Quebec';
+}
 /**
  * @} End of "addtogroup hooks".
  */