From 9057992dd6a050fb8af01fffb4d3c9df1ab89b70 Mon Sep 17 00:00:00 2001 From: Anne van Kesteren Date: Wed, 20 Sep 2023 14:14:08 +0200 Subject: [PATCH] Editorial: rename host parser's isNotSpecial to isOpaque Double negatives are hard to read. --- url.bs | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/url.bs b/url.bs index c5e14c0d..21de79a6 100644 --- a/url.bs +++ b/url.bs @@ -675,14 +675,13 @@ point URLs from A can come from untrusted sources.

A parse-serialize roundtrip gives the - following results, depending on the isNotSpecial argument to the - host parser: + following results, depending on the isOpaque argument to the host parser:
Input - Output (isNotSpecial = false) - Output (isNotSpecial = true) + Output (isOpaque = false) + Output (isOpaque = true)
EXAMPLE.COM example.com (domain) @@ -998,8 +997,8 @@ to be distinguished.

The host parser takes a -scalar value string input with an optional boolean isNotSpecial -(default false), and then runs these steps. They return failure or a host. +scalar value string input with an optional boolean isOpaque (default +false), and then runs these steps. They return failure or a host.

  1. @@ -1013,7 +1012,7 @@ to be distinguished. leading U+005B ([) and trailing U+005D (]) removed.
-
  • If isNotSpecial is true, then return the result of +

  • If isOpaque is true, then return the result of opaque-host parsing input.

  • Assert: input is not the empty string.