Add missing_code_block_language_in_doc_comment lint to flutter/engine.

analysis_options.yaml

@@ -110,6 +110,7 @@ linter:
     # - lines_longer_than_80_chars # not required by flutter style
     - literal_only_boolean_expressions
     # - matching_super_parameters # blocked on https://github.com/dart-lang/language/issues/2509
+    - missing_code_block_language_in_doc_comment
     # - missing_whitespace_between_adjacent_strings # DIFFERENT FROM FLUTTER/FLUTTER (too many false positives)
     - no_adjacent_strings_in_list
     - no_default_cases

lib/web_ui/lib/src/engine/color_filter.dart

@@ -49,7 +49,7 @@ class EngineColorFilter implements SceneImageFilter, ui.ColorFilter {
   /// The matrix is in row-major order and the translation column is specified
   /// in unnormalized, 0...255, space. For example, the identity matrix is:
   ///
-  /// ```
+  /// ```dart
   /// const ColorMatrix identity = ColorFilter.matrix(<double>[
   ///   1, 0, 0, 0, 0,
   ///   0, 1, 0, 0, 0,
@@ -62,7 +62,7 @@ class EngineColorFilter implements SceneImageFilter, ui.ColorFilter {
   ///
   /// An inversion color matrix:
   ///
-  /// ```
+  /// ```dart
   /// const ColorFilter invert = ColorFilter.matrix(<double>[
   ///   -1,  0,  0, 0, 255,
   ///    0, -1,  0, 0, 255,
@@ -73,7 +73,7 @@ class EngineColorFilter implements SceneImageFilter, ui.ColorFilter {
   ///
   /// A sepia-toned color matrix (values based on the [Filter Effects Spec](https://www.w3.org/TR/filter-effects-1/#sepiaEquivalent)):
   ///
-  /// ```
+  /// ```dart
   /// const ColorFilter sepia = ColorFilter.matrix(<double>[
   ///   0.393, 0.769, 0.189, 0, 0,
   ///   0.349, 0.686, 0.168, 0, 0,
@@ -84,7 +84,7 @@ class EngineColorFilter implements SceneImageFilter, ui.ColorFilter {
   ///
   /// A greyscale color filter (values based on the [Filter Effects Spec](https://www.w3.org/TR/filter-effects-1/#grayscaleEquivalent)):
   ///
-  /// ```
+  /// ```dart
   /// const ColorFilter greyscale = ColorFilter.matrix(<double>[
   ///   0.2126, 0.7152, 0.0722, 0, 0,
   ///   0.2126, 0.7152, 0.0722, 0, 0,

lib/web_ui/lib/src/engine/configuration.dart

@@ -231,7 +231,7 @@ class FlutterConfiguration {
   ///
   /// Example:
   ///
-  /// ```
+  /// ```bash
   /// flutter run \
   ///   -d chrome \
   ///   --web-renderer=canvaskit \
@@ -279,7 +279,7 @@ class FlutterConfiguration {
   ///
   /// Example:
   ///
-  /// ```
+  /// ```bash
   /// flutter run -d chrome --profile --dart-define=FLUTTER_WEB_DEBUG_SHOW_SEMANTICS=true
   /// ```
   bool get debugShowSemanticsNodes =>

lib/web_ui/lib/src/engine/profiler.dart

@@ -33,9 +33,9 @@ typedef Action<R> = R Function();
 ///
 /// Example:
 ///
-/// ```
+/// ```dart
 /// final result = timeAction('expensive_operation', () {
-///   ... expensive work ...
+///   // ... expensive work ...
 ///   return someValue;
 /// });
 /// ```

lib/web_ui/lib/src/engine/text/line_breaker.dart

@@ -210,7 +210,7 @@ bool _isSurrogatePair(int? codePoint) {
 /// way from 0 to the string length. For example, here are the indices for the
 /// string "foo bar":
 ///
-/// ```
+/// ```none
 ///   f   o   o       b   a   r
 /// ^   ^   ^   ^   ^   ^   ^   ^
 /// 0   1   2   3   4   5   6   7

lib/web_ui/lib/src/engine/window.dart

@@ -181,7 +181,7 @@ base class EngineFlutterView implements ui.FlutterView {
   /// so it can push/shrink inside its `hostElement`. That way, a Flutter app
   /// can change the layout of the container page.
   ///
-  /// ```
+  /// ```none
   /// <p>Some HTML content...</p>
   /// +--- (div) hostElement ------------------------------------+
   /// | +--- rootElement ---------------------+                  |

lib/web_ui/test/canvaskit/fragment_program_test.dart

@@ -184,8 +184,8 @@ const String kJsonIPLR = r'''
 }
 ''';
 
-/// Geenrated by impellerc from
-/// ```
+/// Generated by impellerc from
+/// ```cpp
 /// #include <flutter/runtime_effect.glsl>
 /// uniform vec2 uSize;
 /// uniform float[10] uFloats;

testing/scenario_app/bin/utils/options.dart

@@ -65,7 +65,7 @@ extension type const Options._(ArgResults _args) {
   /// This is a shortcut that can be used to determine if the usage information
   /// before parsing the remaining command line arguments. For example:
   ///
-  /// ```
+  /// ```dart
   /// void main(List<String> args) {
   ///   if (Options.showUsage(args)) {
   ///     stdout.writeln(Options.usage);
@@ -88,7 +88,7 @@ extension type const Options._(ArgResults _args) {
   /// be enabled before parsing the remaining command line arguments. For
   /// example:
   ///
-  /// ```
+  /// ```dart
   /// void main(List<String> args) {
   ///   final bool verbose = Options.showVerbose(args);
   ///   // ...

testing/skia_gold_client/lib/skia_gold_client.dart

@@ -297,7 +297,7 @@ interface class SkiaGoldClient {
   /// [pixelColorDelta] defines maximum acceptable difference in RGB channels of
   /// each pixel, such that:
   ///
-  /// ```
+  /// ```dart
   /// bool isSame(Color image, Color golden, int pixelDeltaThreshold) {
   ///   return abs(image.r - golden.r)
   ///     + abs(image.g - golden.g)

third_party/web_unicode/tool/unicode_sync_script.dart

@@ -369,15 +369,15 @@ Iterable<UnicodeRange> processRanges(
 
 /// Example:
 ///
-/// ```
+/// ```none
 /// 0x01C4..0x0293; ALetter
 /// 0x0294..0x0294; ALetter
 /// 0x0295..0x02AF; ALetter
 /// ```
 ///
 /// will get combined into:
 ///
-/// ```
+/// ```none
 /// 0x01C4..0x02AF; ALetter
 /// ```
 List<UnicodeRange> combineAdjacentRanges(