Remove since annotations for 2.12 and earlier

natebosch · Commit Queue · commit 3702cbe573ea · 2025-02-19T20:07:15.000-08:00
The earliest supported language version in current SDK releases is 2.12. Information about the first version supporting an API is not useful for that or any earlier language versions. Remove the annotations to reduce noise in API docs. R=lrn@google.com Change-Id: Ide0b2a7f02bba6f9c261a01c7b9d4a48f5c71c2b CoreLibraryReviewExempt: No behavior changes. Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/405821 Auto-Submit: Nate Bosch <nbosch@google.com> Reviewed-by: Alexander Aprelev <aam@google.com> Commit-Queue: Alexander Aprelev <aam@google.com> Reviewed-by: Brian Quinlan <bquinlan@google.com>
diff --git a/pkg/front_end/testcases/general/error_export_from_dill/main.dart.strong.expect b/pkg/front_end/testcases/general/error_export_from_dill/main.dart.strong.expect
@@ -160,8 +160,8 @@ additionalExports = (core::Deprecated,
   core::deprecated,
   core::override,
   asy::Future,
-  asy::Stream,
   asy::FutureExtensions,
+  asy::Stream,
   asy::FutureIterable,
   asy::FutureRecord2,
   asy::FutureRecord3,
diff --git a/pkg/front_end/testcases/general/error_export_from_dill/main.dart.strong.outline.expect b/pkg/front_end/testcases/general/error_export_from_dill/main.dart.strong.outline.expect
@@ -95,8 +95,8 @@ additionalExports = (core::Deprecated,
   core::deprecated,
   core::override,
   asy::Future,
-  asy::Stream,
   asy::FutureExtensions,
+  asy::Stream,
   asy::FutureIterable,
   asy::FutureRecord2,
   asy::FutureRecord3,
diff --git a/pkg/front_end/testcases/general/error_export_from_dill/main.dart.strong.transformed.expect b/pkg/front_end/testcases/general/error_export_from_dill/main.dart.strong.transformed.expect
@@ -156,8 +156,8 @@ additionalExports = (core::Deprecated,
   core::deprecated,
   core::override,
   asy::Future,
-  asy::Stream,
   asy::FutureExtensions,
+  asy::Stream,
   asy::FutureIterable,
   asy::FutureRecord2,
   asy::FutureRecord3,
diff --git a/sdk/lib/_http/http.dart b/sdk/lib/_http/http.dart
@@ -532,21 +532,13 @@ abstract interface class HttpHeaders {
   ///
   /// The current case of the a header name is that of the name used by
   /// the last [set] or [add] call for that header.
-  void add(
-    String name,
-    Object value, {
-    @Since("2.8") bool preserveHeaderCase = false,
-  });
+  void add(String name, Object value, {bool preserveHeaderCase = false});
 
   /// Sets the header [name] to [value].
   ///
   /// Removes all existing values for the header named [name] and
   /// then [add]s [value] to it.
-  void set(
-    String name,
-    Object value, {
-    @Since("2.8") bool preserveHeaderCase = false,
-  });
+  void set(String name, Object value, {bool preserveHeaderCase = false});
 
   /// Removes a specific value for a header name.
   ///
@@ -1897,7 +1889,6 @@ abstract interface class HttpClientRequest implements IOSink {
   ///   // If abort() called before response is available, onError will fire.
   /// });
   /// ```
-  @Since("2.10")
   void abort([Object? exception, StackTrace? stackTrace]);
 }
 
@@ -1946,7 +1937,6 @@ abstract interface class HttpClientResponse implements Stream<List<int>> {
   /// This specifies whether the response bytes were compressed when they were
   /// received across the wire and whether callers will receive compressed
   /// or uncompressed bytes when they listed to this response's byte stream.
-  @Since("2.4")
   HttpClientResponseCompressionState get compressionState;
 
   /// Gets the persistent connection state returned by the server.
@@ -2023,7 +2013,6 @@ abstract interface class HttpClientResponse implements Stream<List<int>> {
 ///  * Does the caller need to manually decompress the response's byte stream?
 ///
 /// This enum is accessed via the [HttpClientResponse.compressionState] value.
-@Since("2.4")
 enum HttpClientResponseCompressionState {
   /// The body of the HTTP response was received and remains in an uncompressed
   /// state.
diff --git a/sdk/lib/async/future.dart b/sdk/lib/async/future.dart
@@ -1005,7 +1005,6 @@ void unawaited(Future<void>? future) {}
 ///
 /// Adds functionality to futures which makes it easier to
 /// write well-typed asynchronous code.
-@Since("2.12")
 extension FutureExtensions<T> on Future<T> {
   /// Handles errors on this future.
   ///
diff --git a/sdk/lib/async/stream.dart b/sdk/lib/async/stream.dart
@@ -181,7 +181,6 @@ abstract mixin class Stream<T> {
   ///
   /// The returned stream is effectively equivalent to one created by
   /// `(() async* { yield value; } ())` or `Future<T>.value(value).asStream()`.
-  @Since("2.5")
   factory Stream.value(T value) =>
       (_AsyncStreamController<T>(null, null, null, null)
             .._add(value)
@@ -210,7 +209,6 @@ abstract mixin class Stream<T> {
   /// `Future<T>.error(error, stackTrace).asStream()`, by or
   /// `(() async* { throw error; } ())`, except that you can control the
   /// stack trace as well.
-  @Since("2.5")
   factory Stream.error(Object error, [StackTrace? stackTrace]) {
     AsyncError(:error, :stackTrace) = _interceptUserError(error, stackTrace);
     return (_AsyncStreamController<T>(null, null, null, null)
@@ -472,7 +470,6 @@ abstract mixin class Stream<T> {
   ///   }
   /// }
   /// ```
-  @Since("2.9")
   factory Stream.multi(
     void Function(MultiStreamController<T>) onListen, {
     bool isBroadcast = false,
@@ -2615,7 +2612,6 @@ abstract interface class StreamTransformer<S, T> {
   /// final splitDecoded = StreamTransformer<List<int>, String>.fromBind(
   ///     (stream) => stream.transform(utf8.decoder).transform(LineSplitter()));
   /// ```
-  @Since("2.1")
   factory StreamTransformer.fromBind(Stream<T> Function(Stream<S>) bind) =
       _StreamBindTransformer<S, T>;
 
@@ -2779,7 +2775,6 @@ class _ControllerEventSinkWrapper<T> implements EventSink<T> {
 /// That usually means only delivering events synchronously in response to other
 /// asynchronous events, because that is a time when an asynchronous event could
 /// happen.
-@Since("2.9")
 abstract interface class MultiStreamController<T>
     implements StreamController<T> {
   /// Adds and delivers an event.
diff --git a/sdk/lib/async/zone.dart b/sdk/lib/async/zone.dart
@@ -1983,7 +1983,6 @@ R runZoned<R>(
 /// Multiple attempts to use the future in a zone where the error is
 /// inaccessible will cause the error to be reported *again* in it's original
 /// error zone.
-@Since("2.8")
 R? runZonedGuarded<R>(
   R body(),
   void onError(Object error, StackTrace stack), {
diff --git a/sdk/lib/collection/hash_map.dart b/sdk/lib/collection/hash_map.dart
@@ -283,7 +283,6 @@ abstract final class HashMap<K, V> implements Map<K, V> {
   /// final map = HashMap.fromEntries(numbers.map((i) => MapEntry(i, i * i)));
   /// print(map); // {11: 121, 12: 144, 13: 169, 14: 196}
   /// ```
-  @Since("2.1")
   factory HashMap.fromEntries(Iterable<MapEntry<K, V>> entries) =>
       HashMap<K, V>()..addEntries(entries);
 }
diff --git a/sdk/lib/collection/linked_hash_map.dart b/sdk/lib/collection/linked_hash_map.dart
@@ -269,7 +269,6 @@ abstract final class LinkedHashMap<K, V> implements Map<K, V> {
   /// final map = LinkedHashMap.fromEntries(numbers.map((i) => MapEntry(i, i * i)));
   /// print(map); // {11: 121, 12: 144, 13: 169, 14: 196}
   /// ```
-  @Since("2.1")
   factory LinkedHashMap.fromEntries(Iterable<MapEntry<K, V>> entries) =>
       LinkedHashMap<K, V>()..addEntries(entries);
 }
diff --git a/sdk/lib/collection/set.dart b/sdk/lib/collection/set.dart
@@ -425,7 +425,6 @@ class _UnmodifiableSet<E> extends _SetBase<E> with _UnmodifiableSetMixin<E> {
 ///
 /// unmodifiableSetView.remove('Earth'); // Throws.
 /// ```
-@Since("2.12")
 class UnmodifiableSetView<E> extends SetBase<E> with _UnmodifiableSetMixin<E> {
   final Set<E> _source;
 
diff --git a/sdk/lib/core/bool.dart b/sdk/lib/core/bool.dart
@@ -194,19 +194,16 @@ final class bool {
   /// The logical conjunction ("and") of this and [other].
   ///
   /// Returns `true` if both this and [other] are `true`, and `false` otherwise.
-  @Since("2.1")
   bool operator &(bool other) => other && this;
 
   /// The logical disjunction ("inclusive or") of this and [other].
   ///
   /// Returns `true` if either this or [other] is `true`, and `false` otherwise.
-  @Since("2.1")
   bool operator |(bool other) => other || this;
 
   /// The logical exclusive disjunction ("exclusive or") of this and [other].
   ///
   /// Returns whether this and [other] are neither both `true` nor both `false`.
-  @Since("2.1")
   bool operator ^(bool other) => !other == this;
 
   /// Returns either `"true"` for `true` and `"false"` for `false`.
diff --git a/sdk/lib/core/core.dart b/sdk/lib/core/core.dart
@@ -165,10 +165,7 @@ import "dart:convert"
 import "dart:math" show Random; // Used by List.shuffle.
 import "dart:typed_data" show Uint8List;
 
-@Since("2.1")
-export "dart:async" show Future, Stream;
-@Since("2.12")
-export "dart:async" show FutureExtensions;
+export "dart:async" show Future, FutureExtensions, Stream;
 @Since("3.0")
 export "dart:async"
     show
diff --git a/sdk/lib/core/errors.dart b/sdk/lib/core/errors.dart
@@ -217,8 +217,7 @@ class ArgumentError extends Error {
   /// in the error message.
   ///
   /// Returns the [argument] if it is not null.
-  @Since("2.1")
-  static T checkNotNull<@Since("2.8") T>(T? argument, [String? name]) =>
+  static T checkNotNull<T>(T? argument, [String? name]) =>
       argument ?? (throw ArgumentError.notNull(name));
 
   // Helper functions for toString overridden in subclasses.
diff --git a/sdk/lib/core/list.dart b/sdk/lib/core/list.dart
@@ -162,7 +162,6 @@ abstract interface class List<E> implements Iterable<E>, _ListIterable<E> {
   /// final fixedLengthList = List.empty(growable: false);
   /// fixedLengthList.add(1); // error
   /// ```
-  @Since("2.9")
   external factory List.empty({bool growable = false});
 
   /// Creates a list containing all [elements].
diff --git a/sdk/lib/core/regexp.dart b/sdk/lib/core/regexp.dart
@@ -271,8 +271,8 @@ abstract interface class RegExp implements Pattern {
     String source, {
     bool multiLine = false,
     bool caseSensitive = true,
-    @Since("2.4") bool unicode = false,
-    @Since("2.4") bool dotAll = false,
+    bool unicode = false,
+    bool dotAll = false,
   });
 
   /// Creates regular expression syntax that matches the input [text].
@@ -414,7 +414,6 @@ abstract interface class RegExp implements Pattern {
   /// regExp = RegExp(r'^..$', unicode: false);  // Matches two code units.
   /// print(regExp.hasMatch(smiley)); // true
   /// ```
-  @Since("2.4")
   bool get isUnicode;
 
   /// Whether "." in this regular expression matches line terminators.
@@ -426,7 +425,6 @@ abstract interface class RegExp implements Pattern {
   /// This feature is distinct from [isMultiLine]. They affect the behavior
   /// of different pattern characters, so they can be used together or
   /// separately.
-  @Since("2.4")
   bool get isDotAll;
 }
 
@@ -470,7 +468,6 @@ abstract interface class RegExp implements Pattern {
 ///   // This is the second message.
 /// }
 /// ```
-@Since("2.3")
 abstract interface class RegExpMatch implements Match {
   /// The string captured by the named capture group [name].
   ///
diff --git a/sdk/lib/core/set.dart b/sdk/lib/core/set.dart
@@ -104,7 +104,6 @@ abstract interface class Set<E> implements Iterable<E>, _SetIterable<E> {
   /// final characters = <String>{'A', 'B', 'C'};
   /// final unmodifiableSet = Set.unmodifiable(characters);
   /// ```
-  @Since("2.12")
   factory Set.unmodifiable(Iterable<E> elements) =>
       UnmodifiableSetView<E>(<E>{...elements});
 
diff --git a/sdk/lib/core/stacktrace.dart b/sdk/lib/core/stacktrace.dart
@@ -16,7 +16,6 @@ abstract interface class StackTrace {
   ///
   /// This stack trace is used as the default in situations where
   /// a stack trace is required, but the user has not supplied one.
-  @Since("2.8")
   static const empty = const _StringStackTrace("");
 
   StackTrace(); // In case existing classes extend StackTrace.
diff --git a/sdk/lib/ffi/ffi.dart b/sdk/lib/ffi/ffi.dart
@@ -1769,7 +1769,6 @@ extension PointerPointer<T extends NativeType> on Pointer<Pointer<T>> {
 }
 
 /// Extension on [Pointer] specialized for the type argument [Struct].
-@Since('2.12')
 extension StructPointer<T extends Struct> on Pointer<T> {
   /// A Dart view of the struct referenced by this pointer.
   ///
@@ -2280,7 +2279,6 @@ extension BoolAddress on bool {
 }
 
 /// Extension to retrieve the native `Dart_Port` from a [SendPort].
-@Since('2.7')
 extension NativePort on SendPort {
   /// The native port of this [SendPort].
   ///
@@ -2295,25 +2293,21 @@ extension NativePort on SendPort {
 }
 
 /// Opaque, not exposing it's members.
-@Since('2.8')
 final class Dart_CObject extends Opaque {}
 
 typedef Dart_NativeMessageHandler = Void Function(Int64, Pointer<Dart_CObject>);
 
 /// Utilities for accessing the Dart VM API from Dart code or
 /// from C code via `dart_api_dl.h`.
-@Since('2.8')
 abstract final class NativeApi {
   /// On breaking changes the major version is increased.
   ///
   /// The versioning covers the API surface in `dart_api_dl.h`.
-  @Since('2.9')
   external static int get majorVersion;
 
   /// On backwards compatible changes the minor version is increased.
   ///
   /// The versioning covers the API surface in `dart_api_dl.h`.
-  @Since('2.9')
   external static int get minorVersion;
 
   /// A function pointer to
@@ -2350,7 +2344,6 @@ abstract final class NativeApi {
 
   /// Pass this to `Dart_InitializeApiDL` in your native code to enable using the
   /// symbols in `dart_api_dl.h`.
-  @Since('2.9')
   external static Pointer<Void> get initializeApiDLData;
 }
 
diff --git a/sdk/lib/ffi/native_type.dart b/sdk/lib/ffi/native_type.dart
@@ -20,7 +20,6 @@ abstract final class SizedNativeType implements NativeType {}
 ///
 /// [Opaque]'s subtypes are not constructible in the Dart code and serve purely
 /// as markers in type signatures.
-@Since('2.12')
 abstract base class Opaque implements NativeType {}
 
 /// [_NativeInteger]'s subtypes represent a native integer in C.
diff --git a/sdk/lib/ffi/struct.dart b/sdk/lib/ffi/struct.dart
@@ -92,7 +92,6 @@ final class _Compound implements NativeType {
 /// [StructArray], and accessing [Struct] fields. To create an instance backed
 /// by native memory, use [StructPointer.ref]. To create an instance backed by
 /// Dart memory, use [Struct.create].
-@Since('2.12')
 abstract base class Struct extends _Compound implements SizedNativeType {
   /// Construct a reference to the [nullptr].
   ///
diff --git a/sdk/lib/internal/internal.dart b/sdk/lib/internal/internal.dart
diff --git a/sdk/lib/io/secure_socket.dart b/sdk/lib/io/secure_socket.dart
diff --git a/sdk/lib/io/socket.dart b/sdk/lib/io/socket.dart
diff --git a/sdk/lib/isolate/isolate.dart b/sdk/lib/isolate/isolate.dart
diff --git a/sdk/lib/mirrors/mirrors.dart b/sdk/lib/mirrors/mirrors.dart
diff --git a/sdk/lib/typed_data/typed_data.dart b/sdk/lib/typed_data/typed_data.dart

Original file line number	Diff line number	Diff line change
`@@ -283,7 +283,6 @@ abstract final class HashMap<K, V> implements Map<K, V> {`
`283`	`283`	`/// final map = HashMap.fromEntries(numbers.map((i) => MapEntry(i, i * i)));`
`284`	`284`	`/// print(map); // {11: 121, 12: 144, 13: 169, 14: 196}`
`285`	`285`	/// ```
`286`		`- @Since("2.1")`
`287`	`286`	`factory HashMap.fromEntries(Iterable<MapEntry<K, V>> entries) =>`
`288`	`287`	`HashMap<K, V>()..addEntries(entries);`
`289`	`288`	`}`
Original file line number	Diff line number	Diff line change
`@@ -269,7 +269,6 @@ abstract final class LinkedHashMap<K, V> implements Map<K, V> {`
`269`	`269`	`/// final map = LinkedHashMap.fromEntries(numbers.map((i) => MapEntry(i, i * i)));`
`270`	`270`	`/// print(map); // {11: 121, 12: 144, 13: 169, 14: 196}`
`271`	`271`	/// ```
`272`		`- @Since("2.1")`
`273`	`272`	`factory LinkedHashMap.fromEntries(Iterable<MapEntry<K, V>> entries) =>`
`274`	`273`	`LinkedHashMap<K, V>()..addEntries(entries);`
`275`	`274`	`}`