Update comment maps (#680)

* fix comment reader

* process nested list

* use innerText to get formatted text

* comments for dictionaries/constants

* trim pharases for nested comments

* move to index.ts to keep texts as intact as possible

* convert inline codes as markdown

* update commentmaps

* do not collapse double newlines

Author: saschanaz

baselines/dom.generated.d.ts

@@ -1,14 +1,15 @@
 {
-    "textdecoder": "Returns a new TextDecoder object.\nIf label is either not a label or is a label for replacement, throws a RangeError.",
-    "textdecoder-encoding": "Returns encoding's name, lowercased.",
-    "textdecoder-fatal": "Returns true if error mode is \"fatal\", and\nfalse otherwise.",
-    "textdecoder-ignorebom": "Returns true if ignore BOM flag is set, and false\notherwise.",
-    "textdecoder-decode": "Returns the result of running encoding's decoder.\nThe method can be invoked zero or more times with options's stream set to\ntrue, and then once without options's stream (or set to false), to process\na fragmented stream. If the invocation without options's stream (or set to\nfalse) has no input, it's clearest to omit both arguments.\nvar string = \"\", decoder = new TextDecoder(encoding), buffer;\nwhile(buffer = next_chunk()) {\nstring += decoder.decode(buffer, {stream:true});\n}\nstring += decoder.decode(); // end-of-stream\nIf the error mode is \"fatal\" and encoding's decoder returns error, throws a TypeError.",
+    "textdecoder": "Returns a new TextDecoder object.\n\nIf label is either not a label or is a label for replacement, throws a RangeError.",
+    "textdecodercommon-encoding": "Returns encoding's name, lowercased.",
+    "textdecodercommon-fatal": "Returns true if error mode is \"fatal\", and false otherwise.",
+    "textdecodercommon-ignorebom": "Returns true if ignore BOM flag is set, and false otherwise.",
+    "textdecoder-decode": "Returns the result of running encoding's decoder. The method can be invoked zero or more times with options's stream set to true, and then once without options's stream (or set to false), to process a fragmented stream. If the invocation without options's stream (or set to false) has no input, it's clearest to omit both arguments.\n\n```\nvar string = \"\", decoder = new TextDecoder(encoding), buffer;\nwhile(buffer = next_chunk()) {\n  string += decoder.decode(buffer, {stream:true});\n}\nstring += decoder.decode(); // end-of-stream\n```\n\nIf the error mode is \"fatal\" and encoding's decoder returns error, throws a TypeError.",
     "textencoder": "Returns a new TextEncoder object.",
-    "textencoder-encoding": "Returns \"utf-8\".",
+    "textencodercommon-encoding": "Returns \"utf-8\".",
     "textencoder-encode": "Returns the result of running UTF-8's encoder.",
     "textencoder-encodeinto": "Runs the UTF-8 encoder on source, stores the result of that operation into destination, and returns the progress made as a dictionary whereby read is the number of converted code units of source and written is the number of bytes modified in destination.",
-    "textdecoderstream": "Returns a new TextDecoderStream object.\nIf label is either not a label or is a label for replacement, throws a RangeError.",
-    "generictransformstream-writable": "Returns a writable stream which accepts string chunks and runs them through UTF-8's encoder before making them available to readable.\nTypically this will be used via the pipeThrough() method on a ReadableStream source.\ntextReadable\n.pipeThrough(new TextEncoderStream())\n.pipeTo(byteWritable);",
+    "textdecoderstream": "Returns a new TextDecoderStream object.\n\nIf label is either not a label or is a label for replacement, throws a RangeError.",
+    "generictransformstream-readable": "Returns a readable stream whose chunks are strings resulting from running encoding's decoder on the chunks written to writable.",
+    "generictransformstream-writable": "Returns a writable stream which accepts BufferSource chunks and runs them through encoding's decoder before making them available to readable.\n\nTypically this will be used via the pipeThrough() method on a ReadableStream source.\n\n```\nvar decoder = new TextDecoderStream(encoding);\nbyteReadable\n  .pipeThrough(decoder)\n  .pipeTo(textWritable);\n```\n\nIf the error mode is \"fatal\" and encoding's decoder returns error, both readable and writable will be errored with a TypeError.",
     "textencoderstream": "Returns a new TextEncoderStream object."
 }

baselines/webworker.generated.d.ts

@@ -1,17 +1,31 @@
 {
+    "request": "Returns a new request whose url property is input if input is a string, and input's url if input is a Request object.\n\nThe init argument is an object whose properties can be set as follows:",
     "request-method": "Returns request's HTTP method, which is \"GET\" by default.",
     "request-url": "Returns the URL of request as a string.",
-    "request-headers": "Returns a Headers object consisting of the headers associated with request.\nNote that headers added in the network layer by the user agent will not be accounted for in this\nobject, e.g., the \"Host\" header.",
-    "request-destination": "Returns the kind of resource requested by request, e.g., \"document\" or\n\"script\".",
-    "request-referrer": "Returns the referrer of request. Its value can be a same-origin URL if\nexplicitly set in init, the empty string to indicate no referrer, and\n\"about:client\" when defaulting to the global's default. This is used during\nfetching to determine the value of the `Referer` header of the request being made.",
-    "request-referrerpolicy": "Returns the referrer policy associated with request. This is used during\nfetching to compute the value of the request's referrer.",
-    "request-mode": "Returns the mode associated with request, which is a string indicating\nwhether the request will use CORS, or will be restricted to same-origin URLs.",
-    "request-credentials": "Returns the credentials mode associated with request, which is a string\nindicating whether credentials will be sent with the request always, never, or only when sent to a\nsame-origin URL.",
-    "request-cache": "Returns the cache mode associated with request, which is a string indicating\nhow the request will interact with the browser's cache when fetching.",
-    "request-redirect": "Returns the redirect mode associated with request, which is a string\nindicating how redirects for the request will be handled during fetching. A request will follow redirects by default.",
-    "request-integrity": "Returns request's subresource integrity metadata, which is a cryptographic hash of\nthe resource being fetched. Its value consists of multiple hashes separated by whitespace. [SRI]",
-    "request-keepalive": "Returns a boolean indicating whether or not request can outlive the global in which\nit was created.",
+    "request-headers": "Returns a Headers object consisting of the headers associated with request. Note that headers added in the network layer by the user agent will not be accounted for in this object, e.g., the \"Host\" header.",
+    "request-destination": "Returns the kind of resource requested by request, e.g., \"document\" or \"script\".",
+    "request-referrer": "Returns the referrer of request. Its value can be a same-origin URL if explicitly set in init, the empty string to indicate no referrer, and \"about:client\" when defaulting to the global's default. This is used during fetching to determine the value of the `Referer` header of the request being made.",
+    "request-referrerpolicy": "Returns the referrer policy associated with request. This is used during fetching to compute the value of the request's referrer.",
+    "request-mode": "Returns the mode associated with request, which is a string indicating whether the request will use CORS, or will be restricted to same-origin URLs.",
+    "request-credentials": "Returns the credentials mode associated with request, which is a string indicating whether credentials will be sent with the request always, never, or only when sent to a same-origin URL.",
+    "request-cache": "Returns the cache mode associated with request, which is a string indicating how the request will interact with the browser's cache when fetching.",
+    "request-redirect": "Returns the redirect mode associated with request, which is a string indicating how redirects for the request will be handled during fetching. A request will follow redirects by default.",
+    "request-integrity": "Returns request's subresource integrity metadata, which is a cryptographic hash of the resource being fetched. Its value consists of multiple hashes separated by whitespace. [SRI]",
+    "request-keepalive": "Returns a boolean indicating whether or not request can outlive the global in which it was created.",
     "request-isreloadnavigation": "Returns a boolean indicating whether or not request is for a reload navigation.",
-    "request-ishistorynavigation": "Returns a boolean indicating whether or not request is for a history\nnavigation (a.k.a. back-foward navigation).",
-    "request-signal": "Returns the signal associated with request, which is an AbortSignal object indicating whether or not request has been aborted, and its abort\nevent handler."
+    "request-ishistorynavigation": "Returns a boolean indicating whether or not request is for a history navigation (a.k.a. back-foward navigation).",
+    "request-signal": "Returns the signal associated with request, which is an AbortSignal object indicating whether or not request has been aborted, and its abort event handler.",
+    "requestinit-method": "A string to set request's method.",
+    "requestinit-headers": "A Headers object, an object literal, or an array of two-item arrays to set request's headers.",
+    "requestinit-body": "A BodyInit object or null to set request's body.",
+    "requestinit-referrer": "A string whose value is a same-origin URL, \"about:client\", or the empty string, to set request's referrer.",
+    "requestinit-referrerpolicy": "A referrer policy to set request's referrerPolicy.",
+    "requestinit-mode": "A string to indicate whether the request will use CORS, or will be restricted to same-origin URLs. Sets request's mode.",
+    "requestinit-credentials": "A string indicating whether credentials will be sent with the request always, never, or only when sent to a same-origin URL. Sets request's credentials.",
+    "requestinit-cache": "A string indicating how the request will interact with the browser's cache to set request's cache.",
+    "requestinit-redirect": "A string indicating whether request follows redirects, results in an error upon encountering a redirect, or returns the redirect (in an opaque fashion). Sets request's redirect.",
+    "requestinit-integrity": "A cryptographic hash of the resource to be fetched by request. Sets request's integrity.",
+    "requestinit-keepalive": "A boolean to set request's keepalive.",
+    "requestinit-signal": "An AbortSignal to set request's signal.",
+    "requestinit-window": "Can only be null. Used to disassociate request from any Window."
 }

inputfiles/idl/DOM.commentmap.json

@@ -1,6 +1,6 @@
 {
-    "element-requestfullscreen": "Displays element fullscreen and resolves promise when done.\nWhen supplied, options's navigationUI member indicates whether showing\nnavigation UI while in fullscreen is preferred or not. If set to \"show\", navigation\nsimplicity is preferred over screen space, and if set to \"hide\", more screen space\nis preferred. User agents are always free to honor user preference over the application's. The\ndefault value \"auto\" indicates no application preference.",
-    "document-fullscreenenabled": "Returns true if document has the ability to display elements fullscreen\nand fullscreen is supported, or false otherwise.",
-    "document-exitfullscreen": "Stops document's fullscreen element from being displayed fullscreen and\nresolves promise when done.",
-    "document-fullscreenelement": "Returns shadowroot's fullscreen element."
+    "element-requestfullscreen": "Displays element fullscreen and resolves promise when done.\n\nWhen supplied, options's navigationUI member indicates whether showing navigation UI while in fullscreen is preferred or not. If set to \"show\", navigation simplicity is preferred over screen space, and if set to \"hide\", more screen space is preferred. User agents are always free to honor user preference over the application's. The default value \"auto\" indicates no application preference.",
+    "document-fullscreenenabled": "Returns true if document has the ability to display elements fullscreen and fullscreen is supported, or false otherwise.",
+    "document-exitfullscreen": "Stops document's fullscreen element from being displayed fullscreen and resolves promise when done.",
+    "documentorshadowroot-fullscreenelement": "Returns document's fullscreen element."
 }