diff --git a/pkgs/http/CHANGELOG.md b/pkgs/http/CHANGELOG.md index 85dccd7313..18e71333b7 100644 --- a/pkgs/http/CHANGELOG.md +++ b/pkgs/http/CHANGELOG.md @@ -1,3 +1,7 @@ +## 1.2.3-wip + +* Fixed unintended HTML tags in doc comments. + ## 1.2.2 * Require package `web: '>=0.5.0 <2.0.0'`. diff --git a/pkgs/http/lib/http.dart b/pkgs/http/lib/http.dart index da35b23a87..317a2c17f3 100644 --- a/pkgs/http/lib/http.dart +++ b/pkgs/http/lib/http.dart @@ -50,15 +50,15 @@ Future get(Uri url, {Map? headers}) => /// Sends an HTTP POST request with the given headers and body to the given URL. /// -/// [body] sets the body of the request. It can be a [String], a [List] or -/// a [Map]. If it's a String, it's encoded using [encoding] and -/// used as the body of the request. The content-type of the request will +/// [body] sets the body of the request. It can be a `String`, a `List` or +/// a `Map`. If it's a `String`, it's encoded using [encoding] +/// and used as the body of the request. The content-type of the request will /// default to "text/plain". /// -/// If [body] is a List, it's used as a list of bytes for the body of the +/// If [body] is a `List`, it's used as a list of bytes for the body of the /// request. /// -/// If [body] is a Map, it's encoded as form fields using [encoding]. The +/// If [body] is a `Map`, it's encoded as form fields using [encoding]. The /// content-type of the request will be set to /// `"application/x-www-form-urlencoded"`; this cannot be overridden. /// @@ -73,15 +73,15 @@ Future post(Uri url, /// Sends an HTTP PUT request with the given headers and body to the given URL. /// -/// [body] sets the body of the request. It can be a [String], a [List] or -/// a [Map]. If it's a String, it's encoded using [encoding] and -/// used as the body of the request. The content-type of the request will +/// [body] sets the body of the request. It can be a `String`, a `List` or +/// a `Map`. If it's a `String`, it's encoded using [encoding] +/// and used as the body of the request. The content-type of the request will /// default to "text/plain". /// -/// If [body] is a List, it's used as a list of bytes for the body of the +/// If [body] is a `List`, it's used as a list of bytes for the body of the /// request. /// -/// If [body] is a Map, it's encoded as form fields using [encoding]. The +/// If [body] is a `Map`, it's encoded as form fields using [encoding]. The /// content-type of the request will be set to /// `"application/x-www-form-urlencoded"`; this cannot be overridden. /// @@ -97,15 +97,15 @@ Future put(Uri url, /// Sends an HTTP PATCH request with the given headers and body to the given /// URL. /// -/// [body] sets the body of the request. It can be a [String], a [List] or -/// a [Map]. If it's a String, it's encoded using [encoding] and -/// used as the body of the request. The content-type of the request will +/// [body] sets the body of the request. It can be a `String`, a `List` or +/// a `Map`. If it's a `String`, it's encoded using [encoding] +/// and used as the body of the request. The content-type of the request will /// default to "text/plain". /// -/// If [body] is a List, it's used as a list of bytes for the body of the +/// If [body] is a `List`, it's used as a list of bytes for the body of the /// request. /// -/// If [body] is a Map, it's encoded as form fields using [encoding]. The +/// If [body] is a `Map`, it's encoded as form fields using [encoding]. The /// content-type of the request will be set to /// `"application/x-www-form-urlencoded"`; this cannot be overridden. /// diff --git a/pkgs/http/lib/src/base_response.dart b/pkgs/http/lib/src/base_response.dart index 0527461dbb..39934ceea9 100644 --- a/pkgs/http/lib/src/base_response.dart +++ b/pkgs/http/lib/src/base_response.dart @@ -117,9 +117,9 @@ var _headerSplitter = RegExp(r'[ \t]*,[ \t]*'); /// /// Set-Cookie strings can contain commas. In particular, the following /// productions defined in RFC-6265, section 4.1.1: -/// - e.g. "Expires=Sun, 06 Nov 1994 08:49:37 GMT" -/// - e.g. "Path=somepath," -/// - e.g. "AnyString,Really," +/// - `` e.g. "Expires=Sun, 06 Nov 1994 08:49:37 GMT" +/// - `` e.g. "Path=somepath," +/// - `` e.g. "AnyString,Really," /// /// Some values are ambiguous e.g. /// "Set-Cookie: lang=en; Path=/foo/" @@ -128,8 +128,9 @@ var _headerSplitter = RegExp(r'[ \t]*,[ \t]*'); /// "Set-Cookie: lang=en; Path=/foo/,SID=x23" /// would both be result in `response.headers` => "lang=en; Path=/foo/,SID=x23" /// -/// The idea behind this regex is that ",=" is more likely to -/// start a new then be part of or . +/// The idea behind this regex is that `,=` is more likely to +/// start a new `` than be part of `` or +/// ``. /// /// See https://datatracker.ietf.org/doc/html/rfc6265#section-4.1.1 var _setCookieSplitter = RegExp(r'[ \t]*,[ \t]*(?=[' + _tokenChars + r']+=)'); diff --git a/pkgs/http/lib/src/client.dart b/pkgs/http/lib/src/client.dart index 6de5698104..8ee554a241 100644 --- a/pkgs/http/lib/src/client.dart +++ b/pkgs/http/lib/src/client.dart @@ -54,17 +54,17 @@ abstract interface class Client { /// Sends an HTTP POST request with the given headers and body to the given /// URL. /// - /// [body] sets the body of the request. It can be a [String], a [List] - /// or a [Map]. + /// [body] sets the body of the request. It can be a `String`, a `List` + /// or a `Map`. /// - /// If [body] is a String, it's encoded using [encoding] and used as the body - /// of the request. The content-type of the request will default to + /// If [body] is a `String`, it's encoded using [encoding] and used as the + /// body of the request. The content-type of the request will default to /// "text/plain". /// - /// If [body] is a List, it's used as a list of bytes for the body of the + /// If [body] is a `List`, it's used as a list of bytes for the body of the /// request. /// - /// If [body] is a Map, it's encoded as form fields using [encoding]. The + /// If [body] is a `Map`, it's encoded as form fields using [encoding]. The /// content-type of the request will be set to /// `"application/x-www-form-urlencoded"`; this cannot be overridden. /// @@ -77,15 +77,15 @@ abstract interface class Client { /// Sends an HTTP PUT request with the given headers and body to the given /// URL. /// - /// [body] sets the body of the request. It can be a [String], a [List] - /// or a [Map]. If it's a String, it's encoded using + /// [body] sets the body of the request. It can be a `String`, a `List` + /// or a `Map`. If it's a `String`, it's encoded using /// [encoding] and used as the body of the request. The content-type of the /// request will default to "text/plain". /// - /// If [body] is a List, it's used as a list of bytes for the body of the + /// If [body] is a `List`, it's used as a list of bytes for the body of the /// request. /// - /// If [body] is a Map, it's encoded as form fields using [encoding]. The + /// If [body] is a `Map`, it's encoded as form fields using [encoding]. The /// content-type of the request will be set to /// `"application/x-www-form-urlencoded"`; this cannot be overridden. /// @@ -98,15 +98,15 @@ abstract interface class Client { /// Sends an HTTP PATCH request with the given headers and body to the given /// URL. /// - /// [body] sets the body of the request. It can be a [String], a [List] - /// or a [Map]. If it's a String, it's encoded using + /// [body] sets the body of the request. It can be a `String`, a `List` + /// or a `Map`. If it's a `String`, it's encoded using /// [encoding] and used as the body of the request. The content-type of the /// request will default to "text/plain". /// - /// If [body] is a List, it's used as a list of bytes for the body of the + /// If [body] is a `List`, it's used as a list of bytes for the body of the /// request. /// - /// If [body] is a Map, it's encoded as form fields using [encoding]. The + /// If [body] is a `Map`, it's encoded as form fields using [encoding]. The /// content-type of the request will be set to /// `"application/x-www-form-urlencoded"`; this cannot be overridden. /// diff --git a/pkgs/http/pubspec.yaml b/pkgs/http/pubspec.yaml index 7039e30838..8c37cff9b1 100644 --- a/pkgs/http/pubspec.yaml +++ b/pkgs/http/pubspec.yaml @@ -1,5 +1,5 @@ name: http -version: 1.2.2 +version: 1.2.3-wip description: A composable, multi-platform, Future-based API for HTTP requests. repository: https://github.com/dart-lang/http/tree/master/pkgs/http diff --git a/pkgs/http_client_conformance_tests/lib/src/compressed_response_body_server.dart b/pkgs/http_client_conformance_tests/lib/src/compressed_response_body_server.dart index 17f8897cc8..bb4b95d1e8 100644 --- a/pkgs/http_client_conformance_tests/lib/src/compressed_response_body_server.dart +++ b/pkgs/http_client_conformance_tests/lib/src/compressed_response_body_server.dart @@ -13,7 +13,7 @@ import 'package:stream_channel/stream_channel.dart'; /// On Startup: /// - send port /// On Request Received: -/// - send headers as Map> +/// - send headers as `Map>` /// When Receive Anything: /// - exit void hybridMain(StreamChannel channel) async { diff --git a/pkgs/http_client_conformance_tests/lib/src/redirect_server.dart b/pkgs/http_client_conformance_tests/lib/src/redirect_server.dart index cf1fafddb8..2813e32239 100644 --- a/pkgs/http_client_conformance_tests/lib/src/redirect_server.dart +++ b/pkgs/http_client_conformance_tests/lib/src/redirect_server.dart @@ -18,7 +18,7 @@ import 'package:stream_channel/stream_channel.dart'; /// ".../9" | ".../8" /// ... | ... /// ".../1" | "/" -/// "/" | <200 return> +/// "/" | <200 return> void hybridMain(StreamChannel channel) async { late HttpServer server; diff --git a/pkgs/http_client_conformance_tests/lib/src/request_headers_server.dart b/pkgs/http_client_conformance_tests/lib/src/request_headers_server.dart index c443ad0034..ad3fdfe0cc 100644 --- a/pkgs/http_client_conformance_tests/lib/src/request_headers_server.dart +++ b/pkgs/http_client_conformance_tests/lib/src/request_headers_server.dart @@ -13,7 +13,7 @@ import 'package:stream_channel/stream_channel.dart'; /// On Startup: /// - send port /// On Request Received: -/// - send headers as Map> +/// - send headers as `Map>` /// When Receive Anything: /// - exit void hybridMain(StreamChannel channel) async { diff --git a/pkgs/http_profile/CHANGELOG.md b/pkgs/http_profile/CHANGELOG.md index b9455a4ed6..fdcad42253 100644 --- a/pkgs/http_profile/CHANGELOG.md +++ b/pkgs/http_profile/CHANGELOG.md @@ -1,3 +1,7 @@ +## 0.1.1-wip + +* Fixed unintended HTML tags in doc comments. + ## 0.1.0 * Initial **experimental** release. diff --git a/pkgs/http_profile/lib/src/utils.dart b/pkgs/http_profile/lib/src/utils.dart index 0225f87f39..780bb446b8 100644 --- a/pkgs/http_profile/lib/src/utils.dart +++ b/pkgs/http_profile/lib/src/utils.dart @@ -14,9 +14,9 @@ var _headerSplitter = RegExp(r'[ \t]*,[ \t]*'); /// /// Set-Cookie strings can contain commas. In particular, the following /// productions defined in RFC-6265, section 4.1.1: -/// - e.g. "Expires=Sun, 06 Nov 1994 08:49:37 GMT" -/// - e.g. "Path=somepath," -/// - e.g. "AnyString,Really," +/// - `` e.g. "Expires=Sun, 06 Nov 1994 08:49:37 GMT" +/// - `` e.g. "Path=somepath," +/// - `` e.g. "AnyString,Really," /// /// Some values are ambiguous e.g. /// "Set-Cookie: lang=en; Path=/foo/" @@ -25,8 +25,9 @@ var _headerSplitter = RegExp(r'[ \t]*,[ \t]*'); /// "Set-Cookie: lang=en; Path=/foo/,SID=x23" /// would both be result in `response.headers` => "lang=en; Path=/foo/,SID=x23" /// -/// The idea behind this regex is that ",=" is more likely to -/// start a new then be part of or . +/// The idea behind this regex is that `,=` is more likely to +/// start a new `` than be part of `` or +/// ``. /// /// See https://datatracker.ietf.org/doc/html/rfc6265#section-4.1.1 var _setCookieSplitter = RegExp(r'[ \t]*,[ \t]*(?=[' + _tokenChars + r']+=)'); diff --git a/pkgs/http_profile/pubspec.yaml b/pkgs/http_profile/pubspec.yaml index d55dc32260..1184789c8a 100644 --- a/pkgs/http_profile/pubspec.yaml +++ b/pkgs/http_profile/pubspec.yaml @@ -3,7 +3,7 @@ description: >- A library used by HTTP client authors to integrate with the DevTools Network View. repository: https://github.com/dart-lang/http/tree/master/pkgs/http_profile -version: 0.1.0 +version: 0.1.1-wip environment: sdk: ^3.4.0