23601 2013-10-23 06:00:25 +0000 Define a variable to replace "with prejudice" 2013-11-19 21:15:47 +0000 1 1 1 Unclassified WebAppsWG WebSocket API (editor: Ian Hickson) unspecified PC Linux RESOLVED FIXED P2 normal --- 1 tyoshino ian ian mike public-webapps public-webapps-bugzilla oldest_to_newest 95151 0 tyoshino 2013-10-23 06:00:25 +0000 The definition of close with prejudice is not straightforward. Sometimes it takes minutes to interpret it. I suggest that we replace > If the user agent was required to fail the WebSocket connection or the WebSocket connection is closed with prejudice, fire a simple event named error at the WebSocket object. [WSP] into > If the user agent was required to fail the WebSocket connection or the closed with prejudice flag is true, fire a simple event named error at the WebSocket object. [WSP] and insert this text > When it is said to close the WebSocket connection with prejudice, run these steps: > - Set the closed with prejudice flag. > - close the WebSocket connection and put occurrences of "close the WebSocket connection with prejudice" in the send() definition into an anchor pointing the new text. 95220 1 ian 2013-10-23 19:08:22 +0000 I don't really understand how that would change. "with prejudice" is already hyperlinked to the relevant part of the spec. The term is only used four times. It basically already is a flag (actually, an argument). Can you elaborate on what is confusing? 95274 2 tyoshino 2013-10-24 02:26:56 +0000 Yes, after clicking the link and thinking a bit, I can understand that. But at least for me and another (English native), the link looked weird ("hmm, this text is also referring to the WebSocket connection is closed with prejudice. where's the actual definition...?") and tried to find explicit definition of close the WebSocket connection with prejudice that could be placed somewhere else. Just adding "flag" to "prejudice" is also fine. When I was reading a text in DOM Promises spec that is using "synchronous flag", I didn't find it confusing. 95377 3 ian 2013-10-25 23:34:53 +0000 Yeah, maybe I'm just being too cute here, and it's hurting the readability. I can look into changing the term to something else. 96538 4 contributor 2013-11-19 21:15:47 +0000 Checked in as WHATWG revision r8298. Check-in comment: Reword the concept of closing a WebSocket with prejudice so that it's more obviously a flag http://html5.org/tools/web-apps-tracker?from=8297&to=8298