Deprecate wgParserEnableLegacyMediaDOM config

Mark as deprecated now that it's false by default and deployed as such,
so that we can remove all the dead paths in a future version.

Bug: T314318
Change-Id: If514d058cc92408c67ffb7625e47f224bb510838

docs/config-schema.yaml

@@ -4154,19 +4154,23 @@ config-schema:
             @since 1.39
     ParserEnableLegacyMediaDOM:
         default: false
+        deprecated: 'since 1.41'
         description: |-
             Enable legacy media HTML structure in the output from the Parser.  The
             alternative modern HTML structure that replaces it is described at
             https://www.mediawiki.org/wiki/Parsing/Media_structure
             @since 1.36
+            @deprecated since 1.41
     UseContentMediaStyles:
         default: false
+        deprecated: 'since 1.41'
         description: |-
             Temporary flag to ship the styles for the media HTML structure that replaces
             legacy, when $wgParserEnableLegacyMediaDOM is `false`.  This is configured
             separately so that it can continue to be served after the latter is disabled
             but still in the cache.
             @internal
+            @deprecated since 1.41
     UseLegacyMediaStyles:
         default: false
         description: |-

docs/config-vars.php

@@ -2334,12 +2334,14 @@ $wgParsoidSettings = null;
 /**
  * Config variable stub for the ParserEnableLegacyMediaDOM setting, for use by phpdoc and IDEs.
  * @see MediaWiki\MainConfigSchema::ParserEnableLegacyMediaDOM
+ * @deprecated since 1.41
  */
 $wgParserEnableLegacyMediaDOM = null;
 
 /**
  * Config variable stub for the UseContentMediaStyles setting, for use by phpdoc and IDEs.
  * @see MediaWiki\MainConfigSchema::UseContentMediaStyles
+ * @deprecated since 1.41
  */
 $wgUseContentMediaStyles = null;
 

includes/MainConfigNames.php

@@ -2349,12 +2349,14 @@ class MainConfigNames {
 	/**
 	 * Name constant for the ParserEnableLegacyMediaDOM setting, for use with Config::get()
 	 * @see MainConfigSchema::ParserEnableLegacyMediaDOM
+	 * @deprecated since 1.41
 	 */
 	public const ParserEnableLegacyMediaDOM = 'ParserEnableLegacyMediaDOM';
 
 	/**
 	 * Name constant for the UseContentMediaStyles setting, for use with Config::get()
 	 * @see MainConfigSchema::UseContentMediaStyles
+	 * @deprecated since 1.41
 	 */
 	public const UseContentMediaStyles = 'UseContentMediaStyles';
 

includes/MainConfigSchema.php

@@ -6483,9 +6483,11 @@ class MainConfigSchema {
 	 * https://www.mediawiki.org/wiki/Parsing/Media_structure
 	 *
 	 * @since 1.36
+	 * @deprecated since 1.41
 	 */
 	public const ParserEnableLegacyMediaDOM = [
 		'default' => false,
+		'deprecated' => 'since 1.41',
 	];
 
 	/**
@@ -6495,9 +6497,11 @@ class MainConfigSchema {
 	 * but still in the cache.
 	 *
 	 * @internal
+	 * @deprecated since 1.41
 	 */
 	public const UseContentMediaStyles = [
 		'default' => false,
+		'deprecated' => 'since 1.41',
 	];
 
 	/**

includes/config-schema.php

@@ -3213,6 +3213,12 @@ return [
 		'AllowImageTag' => [
 			'deprecated' => 'since 1.35; register an extension tag named <img> instead.',
 		],
+		'ParserEnableLegacyMediaDOM' => [
+			'deprecated' => 'since 1.41',
+		],
+		'UseContentMediaStyles' => [
+			'deprecated' => 'since 1.41',
+		],
 		'ReauthenticateTime' => [
 			'additionalProperties' => [
 				'type' => 'integer',