[whatwg/url] What is an opaque path? (Issue #922)

JKingweb created an issue (whatwg/url#922)

### What is the issue with the URL Standard?

I'm finding the current definition of an opaque path very unhelpful.

> A [URL](https://url.spec.whatwg.org/#concept-url) has an opaque path if its [path](https://url.spec.whatwg.org/#concept-url-path) is a [URL path segment](https://url.spec.whatwg.org/#url-path-segment).

> A URL path segment is an [ASCII string](https://infra.spec.whatwg.org/#ascii-string). It commonly refers to a directory or a file, but has no predefined meaning.

Read without context this suggest all paths are opaque, which is obviously not the case. I gather, from just having written a parser, that an opaque path is actually one where the parser produces a path which is a string rather than a list of path segments, but I'm struggling to determine exactly what set of conditions ought to yield this result, and thus where the bugs in my implementation actually are.

Can we get a more descriptive definition, or a set of examples, or something?

-- 
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/url/issues/922
You are receiving this because you are subscribed to this thread.

Message ID: <whatwg/url/issues/922@github.com>