alignment of doc comments and annotations (#84256)

dev/devicelab/lib/framework/apk_utils.dart

@@ -222,7 +222,7 @@ Future<String> getAndroidManifest(String apk) async {
   );
 }
 
- /// Checks that the classes are contained in the APK, throws otherwise.
+/// Checks that the classes are contained in the APK, throws otherwise.
 Future<void> checkApkContainsClasses(File apk, List<String> classes) async {
   final ApkExtractor extractor = ApkExtractor(apk);
   for (final String className in classes) {

packages/flutter/lib/src/gestures/scale.dart

@@ -60,10 +60,10 @@ class ScaleStartDetails {
   ///    coordinates.
   final Offset localFocalPoint;
 
-  /// The number of pointers being tracked by the gesture recognizer.
-  ///
-  /// Typically this is the number of fingers being used to pan the widget using the gesture
-  /// recognizer.
+ /// The number of pointers being tracked by the gesture recognizer.
+ ///
+ /// Typically this is the number of fingers being used to pan the widget using the gesture
+ /// recognizer.
  final int pointerCount;
 
   @override

packages/flutter/lib/src/painting/continuous_rectangle_border.dart

@@ -48,7 +48,7 @@ class ContinuousRectangleBorder extends OutlinedBorder {
   /// [getOuterPath].
   final BorderRadiusGeometry borderRadius;
 
-   @override
+  @override
   EdgeInsetsGeometry get dimensions => EdgeInsets.all(side.width);
 
   @override

packages/flutter/lib/src/services/raw_keyboard_windows.dart

@@ -62,7 +62,7 @@ class RawKeyEventDataWindows extends RawKeyEventData {
   @override
   PhysicalKeyboardKey get physicalKey => kWindowsToPhysicalKey[scanCode] ?? PhysicalKeyboardKey.none;
 
- @override
+  @override
   LogicalKeyboardKey get logicalKey {
     // Look to see if the keyCode is a printable number pad key, so that a
     // difference between regular keys (e.g. "=") and the number pad version
@@ -286,7 +286,7 @@ class RawKeyEventDataWindows extends RawKeyEventData {
   /// {@macro flutter.services.RawKeyEventDataWindows.modifierShift}
   static const int modifierNumLock = 1 << 12;
 
-    /// This mask is used to check the [modifiers] field to test whether the SCROLL LOCK key
+  /// This mask is used to check the [modifiers] field to test whether the SCROLL LOCK key
   /// is pressed.
   ///
   /// {@macro flutter.services.RawKeyEventDataWindows.modifierShift}

packages/flutter_localizations/lib/src/cupertino_localizations.dart

@@ -127,17 +127,23 @@ abstract class GlobalCupertinoLocalizations implements CupertinoLocalizations {
   }
 
   /// Subclasses should provide the optional zero pluralization of [datePickerHourSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerHourSemanticsLabelZero => null;
+  @protected
+  String? get datePickerHourSemanticsLabelZero => null;
   /// Subclasses should provide the optional one pluralization of [datePickerHourSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerHourSemanticsLabelOne => null;
+  @protected
+  String? get datePickerHourSemanticsLabelOne => null;
   /// Subclasses should provide the optional two pluralization of [datePickerHourSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerHourSemanticsLabelTwo => null;
+  @protected
+  String? get datePickerHourSemanticsLabelTwo => null;
   /// Subclasses should provide the optional few pluralization of [datePickerHourSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerHourSemanticsLabelFew => null;
+  @protected
+  String? get datePickerHourSemanticsLabelFew => null;
   /// Subclasses should provide the optional many pluralization of [datePickerHourSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerHourSemanticsLabelMany => null;
+  @protected
+  String? get datePickerHourSemanticsLabelMany => null;
   /// Subclasses should provide the required other pluralization of [datePickerHourSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerHourSemanticsLabelOther;
+  @protected
+  String? get datePickerHourSemanticsLabelOther;
 
   @override
   String? datePickerHourSemanticsLabel(int hour) {
@@ -154,17 +160,23 @@ abstract class GlobalCupertinoLocalizations implements CupertinoLocalizations {
   }
 
   /// Subclasses should provide the optional zero pluralization of [datePickerMinuteSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerMinuteSemanticsLabelZero => null;
+  @protected
+  String? get datePickerMinuteSemanticsLabelZero => null;
   /// Subclasses should provide the optional one pluralization of [datePickerMinuteSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerMinuteSemanticsLabelOne => null;
+  @protected
+  String? get datePickerMinuteSemanticsLabelOne => null;
   /// Subclasses should provide the optional two pluralization of [datePickerMinuteSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerMinuteSemanticsLabelTwo => null;
+  @protected
+  String? get datePickerMinuteSemanticsLabelTwo => null;
   /// Subclasses should provide the optional few pluralization of [datePickerMinuteSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerMinuteSemanticsLabelFew => null;
+  @protected
+  String? get datePickerMinuteSemanticsLabelFew => null;
   /// Subclasses should provide the optional many pluralization of [datePickerMinuteSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerMinuteSemanticsLabelMany => null;
+  @protected
+  String? get datePickerMinuteSemanticsLabelMany => null;
   /// Subclasses should provide the required other pluralization of [datePickerMinuteSemanticsLabel] based on the ARB file.
-  @protected String? get datePickerMinuteSemanticsLabelOther;
+  @protected
+  String? get datePickerMinuteSemanticsLabelOther;
 
   @override
   String? datePickerMinuteSemanticsLabel(int minute) {
@@ -279,17 +291,23 @@ abstract class GlobalCupertinoLocalizations implements CupertinoLocalizations {
   }
 
   /// Subclasses should provide the optional zero pluralization of [timerPickerHourLabel] based on the ARB file.
-  @protected String? get timerPickerHourLabelZero => null;
+  @protected
+  String? get timerPickerHourLabelZero => null;
   /// Subclasses should provide the optional one pluralization of [timerPickerHourLabel] based on the ARB file.
-  @protected String? get timerPickerHourLabelOne => null;
+  @protected
+  String? get timerPickerHourLabelOne => null;
   /// Subclasses should provide the optional two pluralization of [timerPickerHourLabel] based on the ARB file.
-  @protected String? get timerPickerHourLabelTwo => null;
+  @protected
+  String? get timerPickerHourLabelTwo => null;
   /// Subclasses should provide the optional few pluralization of [timerPickerHourLabel] based on the ARB file.
-  @protected String? get timerPickerHourLabelFew => null;
+  @protected
+  String? get timerPickerHourLabelFew => null;
   /// Subclasses should provide the optional many pluralization of [timerPickerHourLabel] based on the ARB file.
-  @protected String? get timerPickerHourLabelMany => null;
+  @protected
+  String? get timerPickerHourLabelMany => null;
   /// Subclasses should provide the required other pluralization of [timerPickerHourLabel] based on the ARB file.
-  @protected String? get timerPickerHourLabelOther;
+  @protected
+  String? get timerPickerHourLabelOther;
 
   @override
   String? timerPickerHourLabel(int hour) {
@@ -316,17 +334,23 @@ abstract class GlobalCupertinoLocalizations implements CupertinoLocalizations {
   ];
 
   /// Subclasses should provide the optional zero pluralization of [timerPickerMinuteLabel] based on the ARB file.
-  @protected String? get timerPickerMinuteLabelZero => null;
+  @protected
+  String? get timerPickerMinuteLabelZero => null;
   /// Subclasses should provide the optional one pluralization of [timerPickerMinuteLabel] based on the ARB file.
-  @protected String? get timerPickerMinuteLabelOne => null;
+  @protected
+  String? get timerPickerMinuteLabelOne => null;
   /// Subclasses should provide the optional two pluralization of [timerPickerMinuteLabel] based on the ARB file.
-  @protected String? get timerPickerMinuteLabelTwo => null;
+  @protected
+  String? get timerPickerMinuteLabelTwo => null;
   /// Subclasses should provide the optional few pluralization of [timerPickerMinuteLabel] based on the ARB file.
-  @protected String? get timerPickerMinuteLabelFew => null;
+  @protected
+  String? get timerPickerMinuteLabelFew => null;
   /// Subclasses should provide the optional many pluralization of [timerPickerMinuteLabel] based on the ARB file.
-  @protected String? get timerPickerMinuteLabelMany => null;
+  @protected
+  String? get timerPickerMinuteLabelMany => null;
   /// Subclasses should provide the required other pluralization of [timerPickerMinuteLabel] based on the ARB file.
-  @protected String? get timerPickerMinuteLabelOther;
+  @protected
+  String? get timerPickerMinuteLabelOther;
 
   @override
   String? timerPickerMinuteLabel(int minute) {
@@ -353,17 +377,23 @@ abstract class GlobalCupertinoLocalizations implements CupertinoLocalizations {
   ];
 
   /// Subclasses should provide the optional zero pluralization of [timerPickerSecondLabel] based on the ARB file.
-  @protected String? get timerPickerSecondLabelZero => null;
+  @protected
+  String? get timerPickerSecondLabelZero => null;
   /// Subclasses should provide the optional one pluralization of [timerPickerSecondLabel] based on the ARB file.
-  @protected String? get timerPickerSecondLabelOne => null;
+  @protected
+  String? get timerPickerSecondLabelOne => null;
   /// Subclasses should provide the optional two pluralization of [timerPickerSecondLabel] based on the ARB file.
-  @protected String? get timerPickerSecondLabelTwo => null;
+  @protected
+  String? get timerPickerSecondLabelTwo => null;
   /// Subclasses should provide the optional few pluralization of [timerPickerSecondLabel] based on the ARB file.
-  @protected String? get timerPickerSecondLabelFew => null;
+  @protected
+  String? get timerPickerSecondLabelFew => null;
   /// Subclasses should provide the optional many pluralization of [timerPickerSecondLabel] based on the ARB file.
-  @protected String? get timerPickerSecondLabelMany => null;
+  @protected
+  String? get timerPickerSecondLabelMany => null;
   /// Subclasses should provide the required other pluralization of [timerPickerSecondLabel] based on the ARB file.
-  @protected String? get timerPickerSecondLabelOther;
+  @protected
+  String? get timerPickerSecondLabelOther;
 
   @override
   String? timerPickerSecondLabel(int second) {

packages/flutter_test/lib/src/_binding_web.dart

@@ -6,7 +6,7 @@ import 'package:flutter/widgets.dart';
 
 import 'binding.dart';
 
- /// Ensure the [WidgetsBinding] is initialized.
+/// Ensure the [WidgetsBinding] is initialized.
 WidgetsBinding ensureInitialized([@visibleForTesting Map<String, String>? environment]) {
   if (WidgetsBinding.instance == null) {
     AutomatedTestWidgetsFlutterBinding();
@@ -15,8 +15,8 @@ WidgetsBinding ensureInitialized([@visibleForTesting Map<String, String>? enviro
   return WidgetsBinding.instance!;
 }
 
- /// This method is a noop on the web.
+/// This method is a noop on the web.
 void setupHttpOverrides() { }
 
- /// This method is a noop on the web.
+/// This method is a noop on the web.
 void mockFlutterAssets() { }

packages/flutter_test/lib/src/_goldens_web.dart

@@ -18,7 +18,7 @@ class LocalFileComparator extends GoldenFileComparator {
     throw UnsupportedError('LocalFileComparator is not supported on the web.');
   }
 
-   @override
+  @override
   Future<void> update(Uri golden, Uint8List imageBytes) {
     throw UnsupportedError('LocalFileComparator is not supported on the web.');
   }

packages/flutter_tools/lib/src/cache.dart

@@ -478,7 +478,7 @@ class Cache {
     return versionFile.existsSync() ? versionFile.readAsStringSync().trim() : null;
   }
 
-    /// Delete all stamp files maintained by the cache.
+  /// Delete all stamp files maintained by the cache.
   void clearStampFiles() {
     try {
       getStampFileFor('flutter_tools').deleteSync();
@@ -1072,7 +1072,7 @@ class ArtifactUpdater {
     }
   }
 
-    /// Clear any zip/gzip files downloaded.
+  /// Clear any zip/gzip files downloaded.
   void removeDownloadedFiles() {
     for (final File file in downloadedFiles) {
       if (!file.existsSync()) {

packages/flutter_tools/lib/src/windows/visual_studio.dart

@@ -91,7 +91,7 @@ class VisualStudio {
     return _bestVisualStudioDetails[_isLaunchableKey] as bool? ?? true;
   }
 
-    /// True if the Visual Studio installation is as pre-release version.
+  /// True if the Visual Studio installation is as pre-release version.
   bool get isPrerelease => _bestVisualStudioDetails[_isPrereleaseKey] as bool? ?? false;
 
   /// True if a reboot is required to complete the Visual Studio installation.

packages/flutter_tools/test/commands.shard/hermetic/devices_test.dart

@@ -160,6 +160,6 @@ class NoDevicesManager extends DeviceManager {
   Future<List<Device>> refreshAllConnectedDevices({Duration timeout}) =>
     getAllConnectedDevices();
 
-@override
+  @override
   List<DeviceDiscovery> get deviceDiscoverers => <DeviceDiscovery>[];
 }

packages/flutter_tools/test/general.shard/flutter_validator_test.dart

@@ -236,7 +236,7 @@ class FakeOperatingSystemUtils extends Fake implements OperatingSystemUtils {
 }
 
 class FakeThrowingFlutterVersion extends FakeFlutterVersion {
-  @override
+   @override
    String get frameworkCommitDate {
      throw VersionCheckError('version error');
    }