From 8594eba70b75bbb53010117f44d762fc8cfc8c97 Mon Sep 17 00:00:00 2001
From: Adam Roses Wight <awight@wikimedia.org>
Date: Tue, 25 Mar 2014 13:53:06 -0700
Subject: [PATCH] Comment generated code to explain the i18n JSON migration.

Change-Id: I4d41be5a70eab5ceeec3be0bd544e4a87504572a
---
 maintenance/generateJsonI18n.php | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/maintenance/generateJsonI18n.php b/maintenance/generateJsonI18n.php
index 3b2374d429..27a9ff16d9 100644
--- a/maintenance/generateJsonI18n.php
+++ b/maintenance/generateJsonI18n.php
@@ -103,6 +103,17 @@ class GenerateJsonI18n extends Maintenance {
 	protected function doShim( $jsondir ) {
 		$shim = <<<'PHP'
 <?php
+/**
+ * This is a backwards-compatibility shim, generated by:
+ * https://git.wikimedia.org/blob/mediawiki%2Fcore.git/HEAD/maintenance%2FgenerateJsonI18n.php
+ *
+ * Beginning with MediaWiki 1.23, translation strings are stored in json files,
+ * and the EXTENSION.i18n.php file only exists to provide compatibility with
+ * older releases of MediaWiki. For more information about this migration, see:
+ * https://www.mediawiki.org/wiki/Requests_for_comment/Localisation_format
+ *
+ * This shim maintains compatibility back to MediaWiki 1.17.
+ */
 $messages = array();
 $GLOBALS['wgHooks']['LocalisationCacheRecache'][] = function ( $cache, $code, &$cachedData ) {
 	$codeSequence = array_merge( array( $code ), $cachedData['fallbackSequence'] );
-- 
2.20.1