Several doc fixes for dart:io.
Change-Id: I0b7577faf49bc2e80e82ef77b2677478503fe6c9
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/182180
Reviewed-by: Janice Collins <jcollins@google.com>
Commit-Queue: Devon Carew <devoncarew@google.com>
diff --git a/sdk/lib/io/file.dart b/sdk/lib/io/file.dart
index 14d68bb..07c3aeb 100644
--- a/sdk/lib/io/file.dart
+++ b/sdk/lib/io/file.dart
@@ -291,7 +291,7 @@
/// with a [File] for the renamed file.
///
/// If [newPath] is a relative path, it is resolved against
- /// the current working directory ([Directory.cwd]).
+ /// the current working directory ([Directory.current]).
/// This means that simply changing the name of a file,
/// but keeping it the original directory,
/// requires creating a new complete path with the new name
@@ -306,7 +306,7 @@
/// ```
/// On some platforms, a rename operation cannot move a file between
/// different file systems. If that is the case, instead [copy] the
- /// file to the new location and then [remove] the original.
+ /// file to the new location and then remove the original.
///
/// If [newPath] identifies an existing file, that file is
/// removed first. If [newPath] identifies an existing directory, the
@@ -318,7 +318,7 @@
/// Returns a [File] for the renamed file.
///
/// If [newPath] is a relative path, it is resolved against
- /// the current working directory ([Directory.cwd]).
+ /// the current working directory ([Directory.current]).
/// This means that simply changing the name of a file,
/// but keeping it the original directory,
/// requires creating a new complete path with the new name
@@ -333,7 +333,7 @@
/// ```
/// On some platforms, a rename operation cannot move a file between
/// different file systems. If that is the case, instead [copySync] the
- /// file to the new location and then [removeSync] the original.
+ /// file to the new location and then [deleteSync] the original.
///
/// If [newPath] identifies an existing file, that file is
/// removed first. If [newPath] identifies an existing directory the
@@ -343,7 +343,7 @@
/// Copies this file.
///
/// If [newPath] is a relative path, it is resolved against
- /// the current working directory ([Directory.cwd]).
+ /// the current working directory ([Directory.current]).
///
/// Returns a `Future<File>` that completes
/// with a [File] for the copied file.
@@ -356,7 +356,7 @@
/// Synchronously copies this file.
///
/// If [newPath] is a relative path, it is resolved against
- /// the current working directory ([Directory.cwd]).
+ /// the current working directory ([Directory.current]).
///
/// Returns a [File] for the copied file.
///
diff --git a/sdk/lib/io/io.dart b/sdk/lib/io/io.dart
index 5be8785..9a89e63 100644
--- a/sdk/lib/io/io.dart
+++ b/sdk/lib/io/io.dart
@@ -47,8 +47,8 @@
///
/// To get information about a path,
/// you can use the [FileSystemEntity] static methods
-/// such as [FileSystemEntitiy.isDirectory], [FileSystemEntitiy.isFile],
-/// and [FileSystemEntitiy.exists].
+/// such as [FileSystemEntity.isDirectory], [FileSystemEntity.isFile],
+/// and [FileSystemEntity.exists].
/// Because file system access involves I/O, these methods
/// are asynchronous and return a [Future].
/// ```dart
@@ -124,7 +124,7 @@
/// ```
/// The client connects to the [WebSocket] using the [WebSocket.connect] method
/// and a URI that uses the Web Socket protocol.
-/// The client can write to the [WebSocket] with the [Websocket.add] method.
+/// The client can write to the [WebSocket] with the [WebSocket.add] method.
/// For example,
/// ```dart
/// var socket = await WebSocket.connect('ws://127.0.0.1:4040/ws');
diff --git a/sdk/lib/io/socket.dart b/sdk/lib/io/socket.dart
index a0eea00..22d57dd 100644
--- a/sdk/lib/io/socket.dart
+++ b/sdk/lib/io/socket.dart
@@ -310,11 +310,11 @@
/// the system.
///
/// The optional argument [shared] specifies whether additional ServerSocket
- /// objects can bind to the same combination of [address], [port] [and] [v6Only].
- /// If [shared] is `true` and more [ServerSockets] from this isolate or other
- /// isolates are bound to the port, then the incoming connections will be
- /// distributed among all the bound [ServerSockets]. Connections can be
- /// distributed over multiple isolates this way.
+ /// objects can bind to the same combination of [address], [port] and
+ /// [v6Only]. If [shared] is `true` and more server sockets from this
+ /// isolate or other isolates are bound to the port, then the incoming
+ /// connections will be distributed among all the bound server sockets.
+ /// Connections can be distributed over multiple isolates this way.
static Future<ServerSocket> bind(address, int port,
{int backlog = 0, bool v6Only = false, bool shared = false}) {
final IOOverrides? overrides = IOOverrides.current;
diff --git a/sdk/lib/typed_data/typed_data.dart b/sdk/lib/typed_data/typed_data.dart
index 20d17f8..df48112 100644
--- a/sdk/lib/typed_data/typed_data.dart
+++ b/sdk/lib/typed_data/typed_data.dart
@@ -10,6 +10,7 @@
/// import 'dart:typed_data';
/// ```
/// {@category Core}
+/// {@canonicalFor dart:_internal.BytesBuilder}
library dart.typed_data;
import "dart:_internal" show Since, UnmodifiableListBase;
diff --git a/tools/bots/test_matrix.json b/tools/bots/test_matrix.json
index 4093a81..a4817cf 100644
--- a/tools/bots/test_matrix.json
+++ b/tools/bots/test_matrix.json
@@ -3250,7 +3250,7 @@
"script": "out/ReleaseX64/dart-sdk/bin/dartdoc",
"arguments": [
"--exclude",
- "dart:ffi,dart:html,dart:web_sql,dart:web_audio,dart:svg,dart:indexed_db,dart:io",
+ "dart:ffi,dart:html,dart:web_sql,dart:web_audio,dart:svg,dart:indexed_db",
"--sdk-docs",
"--no-generate-docs"
],
