Index: url/scheme_host_port.h |
diff --git a/url/scheme_host_port.h b/url/scheme_host_port.h |
index 2cc9e070db868cb5631a6c8ffc03c2a09af8fbfd..6e35a25bca9196b5687dcd63545d427acce4b49e 100644 |
--- a/url/scheme_host_port.h |
+++ b/url/scheme_host_port.h |
@@ -36,20 +36,19 @@ namespace url { |
// schemes such as "blob", "filesystem", "data", and "javascript" can only be |
// represented as invalid SchemeHostPort objects. |
// |
-// * The "file" scheme follows the standard syntax, but it is important to note |
-// that the authority portion (host, port) is optional. URLs without an |
-// authority portion will be represented with an empty string for the host, |
-// and a port of 0 (e.g. "file:///etc/hosts" => ("file", "", 0)), and URLs |
-// with a host-only authority portion will be represented with a port of 0 |
-// (e.g. "file://example.com/etc/hosts" => ("file", "example.com", 0)). See |
-// Section 3 of RFC 3986 to better understand these constructs. |
+// * For example, the "file" scheme follows the standard syntax, but it is |
+// important to note that the authority portion (host, port) is optional. |
+// URLs without an authority portion will be represented with an empty string |
+// for the host, and a port of 0 (e.g. "file:///etc/hosts" => |
+// ("file", "", 0)), and URLs with a host-only authority portion will be |
+// represented with a port of 0 (e.g. "file://example.com/etc/hosts" => |
+// ("file", "example.com", 0)). See Section 3 of RFC 3986 to better understand |
+// these constructs. |
// |
// * SchemeHostPort has no notion of the Origin concept (RFC 6454), and in |
// particular, it has no notion of a "unique" Origin. If you need to take |
// uniqueness into account (and, if you're making security-relevant decisions |
-// then you absolutely do), please use 'url::Origin' instead[1]. |
-// |
-// [1]: // TODO(mkwst): Land 'url::Origin'. :) |
+// then you absolutely do), please use 'url::Origin' instead. |
// |
// Usage: |
// |