Deprecate LocalFile::getHistory hook

This undocumented hook which is only used in FlaggedRevs (and it's being
removed in If5a56a8fd5fc568) doesn't serve much purpose and can break
the file class.

Bug: T284777
Change-Id: I7ed8c01f0d0485f40307a24cc33cf3536f70c417

RELEASE-NOTES-1.37

@@ -407,6 +407,7 @@ because of Phabricator reports.
 * BaseTemplate::getAfterPortlet, BaseTemplate::renderAfterPortlet and the
   BaseTemplateAfterPortlet hook, which were deprecated in 1.35,
   now emit deprecation warnings.
+* LocalFile::getHistory hook is deprecated.
 * …
 
 === Other changes in 1.37 ===

includes/HookContainer/DeprecatedHooks.php

@@ -43,6 +43,7 @@ class DeprecatedHooks {
 		'BeforeResetNotificationTimestamp' => [ 'deprecatedVersion' => '1.37' ],
 		'EditPageBeforeEditToolbar' => [ 'deprecatedVersion' => '1.36' ],
 		'InternalParseBeforeSanitize' => [ 'deprecatedVersion' => '1.35' ],
+		'LocalFile::getHistory' => [ 'deprecatedVersion' => '1.37' ],
 		'MagicWordwgVariableIDs' => [ 'deprecatedVersion' => '1.35', 'silent' => true ],
 		'PageContentSave' => [ 'deprecatedVersion' => '1.35', 'silent' => true ],
 		'ParserGetVariableValueVarCache' => [ 'deprecatedVersion' => '1.35' ],

includes/filerepo/Hook/LocalFile__getHistoryHook.php

@@ -9,7 +9,7 @@ use File;
  * This is a hook handler interface, see docs/Hooks.md.
  * Use the hook name "LocalFile::getHistory" to register handlers implementing this interface.
  *
- * @stable to implement
+ * @deprecated since 1.37
  * @ingroup Hooks
  */
 interface LocalFile__getHistoryHook {