#717666 by heyrocker: Document hook_countries_alter().

1 files changed, 13 insertions, 0 deletions

diff --git a/modules/system/system.api.php b/modules/system/system.api.php
index 153ddca83..1c124711d 100644
--- a/modules/system/system.api.php
+++ b/modules/system/system.api.php
@@ -3209,5 +3209,18 @@ 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".
  */