From c1ca8a08da8edfa0c7710e48169d8974d934978a Mon Sep 17 00:00:00 2001
From: Angie Byron <webchick@24967.no-reply.drupal.org>
Date: Thu, 18 Feb 2010 01:40:46 +0000
Subject: #717666 by heyrocker: Document hook_countries_alter().

---
 modules/system/system.api.php | 13 +++++++++++++
 1 file changed, 13 insertions(+)

(limited to 'modules/system/system.api.php')

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
@@ -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".
  */
-- 
cgit v1.2.3