From fdd5936bf8dbfedd59b6f5837ea5f8a0e0db0752 Mon Sep 17 00:00:00 2001 From: Tab Atkins-Bittner Date: Tue, 24 May 2022 14:57:04 -0700 Subject: [PATCH] Localize all the 'register that a biblio reference exists' code, and make section links use it. Fixes #2280 --- bikeshed/Spec.py | 3 +- bikeshed/biblio.py | 2 +- bikeshed/unsortedJunk.py | 73 ++-- .../aom/spec/custom-element-semantics.html | 8 +- tests/github/WICG/app-history/spec.html | 4 +- tests/github/WICG/background-fetch/index.html | 6 + .../spec/PeriodicBackgroundSync-index.html | 2 + .../WICG/background-sync/spec/index.html | 6 + .../WICG/construct-stylesheets/index.html | 6 + tests/github/WICG/contact-api/spec/index.html | 2 + .../github/WICG/content-index/spec/index.html | 6 + tests/github/WICG/cookie-store/index.html | 6 +- tests/github/WICG/crash-reporting/index.html | 2 + tests/github/WICG/css-parser-api/index.html | 6 + .../WICG/custom-state-pseudo-class/index.html | 8 + .../WICG/deprecation-reporting/index.html | 8 +- tests/github/WICG/document-policy/index.html | 2 + tests/github/WICG/element-timing/index.html | 6 +- .../index.html | 12 +- tests/github/WICG/entries-api/index.html | 4 +- tests/github/WICG/event-timing/index.html | 12 + .../github/WICG/file-system-access/index.html | 4 + .../spec/index.html | 6 + tests/github/WICG/hdcp-detection/index.html | 6 + .../WICG/intervention-reporting/index.html | 8 +- tests/github/WICG/keyboard-lock/index.html | 6 + tests/github/WICG/keyboard-map/index.html | 8 + tests/github/WICG/kv-storage/spec.html | 2 + .../WICG/largest-contentful-paint/index.html | 6 + .../github/WICG/layout-instability/index.html | 6 + tests/github/WICG/page-lifecycle/spec.html | 8 +- .../WICG/periodic-background-sync/index.html | 6 + tests/github/WICG/portals/index.html | 10 +- .../responsive-image-client-hints/index.html | 8 + .../WICG/scroll-to-text-fragment/index.html | 197 --------- .../WICG/shape-detection-api/index-zh-cn.html | 6 + .../WICG/shape-detection-api/index.html | 2 + .../github/WICG/shape-detection-api/text.html | 4 +- tests/github/WICG/speech-api/index.html | 8 +- tests/github/WICG/ua-client-hints/index.html | 2 + tests/github/WICG/video-rvfc/index.html | 2 +- tests/github/WICG/web-locks/index.html | 12 +- tests/github/WICG/web-otp/index.html | 4 + tests/github/WICG/webpackage/loading.html | 10 +- tests/github/WICG/webusb/index.html | 2 + tests/github/WICG/webusb/test/index.html | 8 + .../github/WebAudio/web-audio-api/index.html | 12 +- .../WebBluetoothCG/web-bluetooth/index.html | 6 + .../web-bluetooth/scanning.html | 6 + .../WebBluetoothCG/web-bluetooth/tests.html | 2 +- tests/github/heycam/webidl/index.html | 4 + tests/github/immersive-web/anchors/index.html | 12 +- .../immersive-web/depth-sensing/index.html | 8 +- .../immersive-web/dom-overlays/index.html | 22 +- .../github/immersive-web/hit-test/index.html | 2 +- .../immersive-web/layers/webxrlayers-1.html | 4 +- .../lighting-estimation/index.html | 10 +- .../real-world-geometry/plane-detection.html | 6 +- .../real-world-geometry/webxrmeshing-1.html | 6 + .../immersive-web/webxr-ar-module/index.html | 2 + .../webxr-gamepads-module/index.html | 4 +- .../immersive-web/webxr-hand-input/index.html | 6 + .../immersive-web/webxr-test-api/index.html | 16 +- tests/github/immersive-web/webxr/index.html | 12 +- .../storage-access/storage-access.html | 2 + tests/github/w3c/FileAPI/index.html | 4 + tests/github/w3c/IndexedDB/index.html | 2 +- .../w3c/IntersectionObserver/index.html | 4 +- .../github/w3c/ServiceWorker/docs/index.html | 8 +- .../w3c/ServiceWorker/docs/v1/index.html | 8 +- .../WD-service-workers-20160830/index.html | 6 +- .../WD-service-workers-1-20161011/index.html | 4 +- tests/github/w3c/accelerometer/index.html | 4 + tests/github/w3c/clipboard-apis/index.html | 2 + .../css-animation-worklet-1/Overview.html | 2 + .../css-layout-api/Overview.html | 12 +- .../css-paint-api/Overview.html | 45 +-- .../css-properties-values-api/Overview.html | 14 + .../css-typed-om/Overview.html | 22 +- .../csswg-drafts/css-align-3/Overview.html | 18 +- .../css-animations-1/Overview.html | 6 + .../css-animations-2/Overview.html | 4 + .../css-backgrounds-3/Overview.html | 4 + .../w3c/csswg-drafts/css-box-3/Overview.html | 55 +-- .../csswg-drafts/css-box-3/block-layout.html | 12 + .../w3c/csswg-drafts/css-box-4/Overview.html | 72 +--- .../csswg-drafts/css-break-3/Overview.html | 8 + .../csswg-drafts/css-break-4/Overview.html | 12 +- .../csswg-drafts/css-cascade-3/Overview.html | 16 + .../csswg-drafts/css-cascade-4/Overview.html | 26 +- .../csswg-drafts/css-cascade-5/Overview.html | 24 +- .../csswg-drafts/css-color-4/Overview.html | 6 +- .../csswg-drafts/css-color-5/Overview.html | 4 + .../css-color-adjust-1/Overview.html | 10 +- .../csswg-drafts/css-color-hdr/Overview.html | 6 + .../css-conditional-4/Overview.html | 2 + .../css-conditional-values-1/Overview.html | 4 + .../csswg-drafts/css-contain-1/Overview.html | 12 +- .../csswg-drafts/css-contain-2/Overview.html | 16 +- .../csswg-drafts/css-contain-3/Overview.html | 2 +- .../csswg-drafts/css-content-3/Overview.html | 6 + .../css-counter-styles-3/Overview.html | 6 + .../css-device-adapt-1/Overview.html | 2 + .../csswg-drafts/css-display-3/Overview.html | 10 +- .../csswg-drafts/css-flexbox-1/Overview.html | 329 +-------------- .../css-font-loading-3/Overview.html | 8 + .../csswg-drafts/css-fonts-4/Overview.html | 6 + .../csswg-drafts/css-fonts-5/Overview.html | 6 + .../w3c/csswg-drafts/css-grid-1/Overview.html | 373 +----------------- .../w3c/csswg-drafts/css-grid-2/Overview.html | 326 +-------------- .../w3c/csswg-drafts/css-grid-3/Overview.html | 6 + .../css-highlight-api-1/Overview.html | 18 +- .../csswg-drafts/css-images-3/Overview.html | 12 + .../csswg-drafts/css-images-4/Overview.html | 8 + .../csswg-drafts/css-inline-3/Overview.html | 20 +- .../csswg-drafts/css-lists-3/Overview.html | 10 + .../csswg-drafts/css-logical-1/Overview.html | 14 + .../csswg-drafts/css-multicol-1/Overview.html | 6 + .../w3c/csswg-drafts/css-nav-1/Overview.html | 6 +- .../csswg-drafts/css-nesting-1/Overview.html | 2 + .../csswg-drafts/css-overflow-3/Overview.html | 16 +- .../csswg-drafts/css-overflow-4/Overview.html | 2 + .../w3c/csswg-drafts/css-page-3/Overview.html | 6 + .../css-page-floats-3/Overview.html | 2 + .../csswg-drafts/css-position-3/Overview.html | 26 +- .../w3c/csswg-drafts/css-print/Overview.html | 2 + .../csswg-drafts/css-pseudo-4/Overview.html | 4 + .../csswg-drafts/css-rhythm-1/Overview.html | 4 + .../css-round-display-1/Overview.html | 2 + .../w3c/csswg-drafts/css-ruby-1/Overview.html | 8 +- .../csswg-drafts/css-scoping-1/Overview.html | 10 + .../css-scroll-anchoring-1/Overview.html | 8 + .../css-scroll-snap-1/Overview.html | 12 + .../css-scrollbars-1/Overview.html | 2 + .../csswg-drafts/css-shapes-1/Overview.html | 2 + .../csswg-drafts/css-shapes-2/Overview.html | 4 +- .../csswg-drafts/css-sizing-3/Overview.html | 12 +- .../csswg-drafts/css-sizing-4/Overview.html | 76 +--- .../csswg-drafts/css-speech-1/Overview.html | 2 + .../csswg-drafts/css-syntax-3/Overview.html | 8 + .../csswg-drafts/css-tables-3/Overview.html | 12 + .../w3c/csswg-drafts/css-text-3/Overview.html | 24 +- .../w3c/csswg-drafts/css-text-4/Overview.html | 2 + .../css-text-decor-3/Overview.html | 8 + .../css-text-decor-4/Overview.html | 10 + .../css-transforms-1/Overview.html | 2 +- .../css-transforms-2/Overview.html | 8 + .../css-transitions-1/Overview.html | 6 + .../css-transitions-2/Overview.html | 4 + .../w3c/csswg-drafts/css-ui-3/Overview.html | 8 + .../w3c/csswg-drafts/css-ui-4/Overview.html | 67 +--- .../csswg-drafts/css-values-3/Overview.html | 10 + .../csswg-drafts/css-values-4/Overview.html | 22 ++ .../css-variables-1/Overview.html | 4 + .../css-writing-modes-3/Overview.html | 94 +---- .../css-writing-modes-4/Overview.html | 106 +---- .../w3c/csswg-drafts/css2/Overview.html | 4 + .../w3c/csswg-drafts/cssom-1/Overview.html | 8 + .../csswg-drafts/cssom-view-1/Overview.html | 2 + .../csswg-drafts/mediaqueries-4/Overview.html | 6 + .../csswg-drafts/mediaqueries-5/Overview.html | 12 +- .../resize-observer-1/Overview.html | 8 + .../scroll-animations-1/Overview.html | 8 + .../csswg-drafts/selectors-4/Overview.html | 6 + .../web-animations-1/Overview.html | 10 +- tests/github/w3c/deviceorientation/index.html | 4 +- .../fxtf-drafts/css-masking-1/Overview.html | 6 + .../w3c/fxtf-drafts/fill-stroke/Overview.html | 4 +- .../w3c/fxtf-drafts/geometry/Overview.html | 4 + .../w3c/fxtf-drafts/motion-1/Overview.html | 12 + tests/github/w3c/longtasks/index.html | 6 + tests/github/w3c/magnetometer/index.html | 2 +- .../github/w3c/media-capabilities/index.html | 6 + .../github/w3c/mediacapture-image/index.html | 2 + .../mediacapture-record/MediaRecorder.html | 2 + .../github/w3c/openscreenprotocol/index.html | 2 +- .../github/w3c/orientation-sensor/index.html | 4 +- .../w3c/orientation-sensor/releases/FPWD.html | 4 +- .../github/w3c/paint-timing/painttiming.html | 10 +- .../w3c/payment-method-manifest/index.html | 4 + tests/github/w3c/permissions/index.html | 16 +- .../github/w3c/picture-in-picture/index.html | 6 + .../w3c/reporting/network-reporting.html | 4 + tests/github/w3c/sensors/index.html | 2 + tests/github/w3c/sensors/usecases.html | 10 + .../w3c/svgwg/specs/color/Overview.html | 6 + .../w3c/svgwg/specs/marker/Overview.html | 2 + .../NOTE-act-rules-common-aspects.html | 2 + .../index.html | 39 +- tests/github/w3c/webappsec-csp/api/index.html | 2 + tests/github/w3c/webappsec-csp/index.html | 6 +- .../w3c/webappsec-csp/pinning/index.html | 4 + .../w3c/webappsec-fetch-metadata/index.html | 2 + .../w3c/webappsec-mixed-content/index.html | 8 + .../webappsec-post-spectre-webdev/index.html | 2 +- .../w3c/webappsec-suborigins/index.html | 4 +- .../webappsec-trusted-types/spec/index.html | 34 +- .../index.html | 2 + tests/github/w3c/webauthn/index.html | 219 +--------- tests/github/w3c/webrtc-priority/index.html | 6 + tests/github/w3c/webvtt/index.html | 4 + .../w3ctag/design-principles/index.html | 8 +- .../w3ctag/security-questionnaire/index.html | 8 +- tests/github/whatwg/compat/compatibility.html | 6 + .../github/whatwg/fullscreen/fullscreen.html | 8 + tests/github/whatwg/streams/index.html | 2 + tests/section-links003.html | 15 +- 207 files changed, 1367 insertions(+), 2088 deletions(-) diff --git a/bikeshed/Spec.py b/bikeshed/Spec.py index 4d8feccbf9..2addc2887f 100644 --- a/bikeshed/Spec.py +++ b/bikeshed/Spec.py @@ -244,8 +244,8 @@ def processDocument(self): u.formatArgumentdefTables(self) u.formatElementdefTables(self) u.processAutolinks(self) + u.fixInterDocumentReferences(self) biblio.dedupBiblioReferences(self) - u.verifyUsageOfAllLocalBiblios(self) caniuse.addCanIUsePanels(self) boilerplate.addIndexSection(self) boilerplate.addExplicitIndexes(self) @@ -269,6 +269,7 @@ def processDocument(self): fingerprinting.addTrackingVector(self) u.fixIntraDocumentReferences(self) u.fixInterDocumentReferences(self) + u.verifyUsageOfAllLocalBiblios(self) u.removeMultipleLinks(self) u.forceCrossorigin(self) lint.brokenLinks(self) diff --git a/bikeshed/biblio.py b/bikeshed/biblio.py index 3724eeccbe..89ed91ec70 100644 --- a/bikeshed/biblio.py +++ b/bikeshed/biblio.py @@ -525,4 +525,4 @@ def isShepherdRef(ref): if keys["shepherd"] in doc.externalRefsUsed: for k, v in list(doc.externalRefsUsed[keys["shepherd"]].items()): doc.externalRefsUsed[keys["specref"]][k] = v - del doc.externalRefsUsed[keys["shepherd"]] + del doc.externalRefsUsed[keys["shepherd"]] diff --git a/bikeshed/unsortedJunk.py b/bikeshed/unsortedJunk.py index d5456226fc..d1069ba7ec 100644 --- a/bikeshed/unsortedJunk.py +++ b/bikeshed/unsortedJunk.py @@ -445,13 +445,13 @@ def fixInterDocumentReferences(doc: "t.SpecType"): ) -def fillInterDocumentReferenceFromShepherd(doc: "t.SpecType", el, spec, section): - specData = doc.refs.fetchHeadings(spec) - if section in specData: - heading = specData[section] +def fillInterDocumentReferenceFromShepherd(doc: "t.SpecType", el, specName, section): + headingData = doc.refs.fetchHeadings(specName) + if section in headingData: + heading = headingData[section] else: m.die( - f"Couldn't find section '{section}' in spec '{spec}':\n{h.outerHTML(el)}", + f"Couldn't find section '{section}' in spec '{specName}':\n{h.outerHTML(el)}", el=el, ) return @@ -459,16 +459,17 @@ def fillInterDocumentReferenceFromShepherd(doc: "t.SpecType", el, spec, section) # Multipage spec if len(heading) == 1: # only one heading of this name, no worries - heading = specData[heading[0]] + heading = headingData[heading[0]] else: # multiple headings of this id, user needs to disambiguate m.die( - f"Multiple headings with id '{section}' for spec '{spec}'. Please specify:\n" - + "\n".join(" [[{}]]".format(spec + x) for x in heading), + f"Multiple headings with id '{section}' for spec '{specName}'. Please specify:\n" + + "\n".join(f" [[{specName + x}]]" for x in heading), el=el, ) return if doc.md.status == "current": + # FIXME: doc.md.status is not these values if "current" in heading: heading = heading["current"] else: @@ -485,6 +486,11 @@ def fillInterDocumentReferenceFromShepherd(doc: "t.SpecType", el, spec, section) h.appendChild(el, " §\u202f{number} {text}".format(**heading)) h.removeAttr(el, "data-link-spec", "spec-section") + # Mark this as a used biblio ref + specData = doc.refs.specs[specName] + bib = biblio.SpecBasedBiblioEntry(specData) + registerBiblioUsage(doc, bib, el=el) + def fillInterDocumentReferenceFromSpecref(doc: "t.SpecType", el, spec, section): bib = doc.refs.getBiblioRef(spec) @@ -497,6 +503,9 @@ def fillInterDocumentReferenceFromSpecref(doc: "t.SpecType", el, spec, section): el.text = bib.title + " §\u202f" + section[1:] h.removeAttr(el, "data-link-spec", "spec-section") + # Mark this as a used biblio ref + registerBiblioUsage(doc, bib, el=el) + def processDfns(doc: "t.SpecType"): dfns = h.findAll(config.dfnElementsSelector, doc) @@ -767,17 +776,6 @@ def classifyLink(el): def processBiblioLinks(doc: "t.SpecType"): biblioLinks = h.findAll("a[data-link-type='biblio']", doc) for el in biblioLinks: - biblioType = el.get("data-biblio-type") - if biblioType == "normative": - storage = doc.normativeRefs - elif biblioType == "informative": - storage = doc.informativeRefs - else: - m.die( - f"Unknown data-biblio-type value '{biblioType}' on {h.outerHTML(el)}. Only 'normative' and 'informative' allowed.", - el=el, - ) - continue linkText = determineLinkText(el) if linkText[0] == "[" and linkText[-1] == "]": @@ -828,7 +826,7 @@ def processBiblioLinks(doc: "t.SpecType"): doc.refs.preferredBiblioNames[ref.linkText] = linkText # Use it on the current ref. Future ones will use the preferred name automatically. ref.linkText = linkText - storage[ref.linkText] = ref + registerBiblioUsage(doc, ref, el=el, type=el.get("data-biblio-type")) id = config.simplifyText(ref.linkText) el.set("href", "#biblio-" + id) @@ -853,8 +851,8 @@ def verifyUsageOfAllLocalBiblios(doc: "t.SpecType"): were used in the spec, so you can remove entries when they're no longer necessary. """ - usedBiblioKeys = {x.lower() for x in list(doc.normativeRefs.keys()) + list(doc.informativeRefs.keys())} - localBiblios = [b["linkText"].lower() for bs in doc.refs.biblios.values() for b in bs if b["order"] == 1] + usedBiblioKeys = {x.upper() for x in list(doc.normativeRefs.keys()) + list(doc.informativeRefs.keys())} + localBiblios = [b["linkText"].upper() for bs in doc.refs.biblios.values() for b in bs if b["order"] == 1] unusedBiblioKeys = [] for b in localBiblios: if b not in usedBiblioKeys: @@ -927,15 +925,10 @@ def processAutolinks(doc: "t.SpecType"): # rather than checking `status == "local"`, as "local" refs include # those defined in `
` datablocks, which we do
         # want to capture here.
-        if ref and ref.spec and doc.refs.spec and ref.spec.lower() != doc.refs.spec.lower():
-            spec = ref.spec.lower()
+        if ref and ref.spec and doc.refs.spec and ref.spec.upper() != doc.refs.spec.upper():
+            spec = ref.spec.upper()
             key = ref.for_[0] if ref.for_ else ""
 
-            if h.isNormative(el, doc):
-                biblioStorage = doc.normativeRefs
-            else:
-                biblioStorage = doc.informativeRefs
-
             # If the ref is from an anchor block, it knows what it's doing.
             # Don't follow obsoletion chains.
             allowObsolete = ref.status == "anchor-block"
@@ -948,8 +941,8 @@ def processAutolinks(doc: "t.SpecType"):
                 allowObsolete=allowObsolete,
             )
             if biblioRef:
-                biblioStorage[biblioRef.linkText] = biblioRef
-                spec = biblioRef.linkText.lower()
+                spec = biblioRef.linkText.upper()
+                registerBiblioUsage(doc, biblioRef, el=el)
                 doc.externalRefsUsed[spec]["_biblio"] = biblioRef
             doc.externalRefsUsed[spec][ref.text][key] = ref
 
@@ -967,6 +960,24 @@ def processAutolinks(doc: "t.SpecType"):
     h.dedupIDs(doc)
 
 
+def registerBiblioUsage(
+    doc: "t.SpecType", ref: biblio.BiblioEntry, el: t.ElementT, type: t.Optional[str] = None
+) -> None:
+    if type is None:
+        if h.isNormative(el, doc):
+            type = "normative"
+        else:
+            type = "informative"
+    if type == "normative":
+        biblioStorage = doc.normativeRefs
+    elif type == "informative":
+        biblioStorage = doc.informativeRefs
+    else:
+        m.die(f"Unknown biblio type {type}.", el=el)
+        return
+    biblioStorage[ref.linkText.upper()] = ref
+
+
 def decorateAutolink(doc: "t.SpecType", el, linkType, linkText, ref):
     # Add additional effects to autolinks.
     if doc.md.slimBuildArtifact:
diff --git a/tests/github/WICG/aom/spec/custom-element-semantics.html b/tests/github/WICG/aom/spec/custom-element-semantics.html
index bf757a92b9..b57c693700 100644
--- a/tests/github/WICG/aom/spec/custom-element-semantics.html
+++ b/tests/github/WICG/aom/spec/custom-element-semantics.html
@@ -1108,13 +1108,13 @@ 
Terms defined by reference

   
    
  • 
-    [uuid] defines the following terms:
+    [UUID] defines the following terms:
     
      
      
    • generate a random uuid
     
    
@@ -2455,6 +2455,8 @@ 
    Mike West. Content Security Policy Level 3. URL: https://w3c.github.io/webappsec-csp/
    
    [WEBAPPSEC-FETCH-METADATA-1]
    
    Fetch Metadata Request Headers URL: https://w3c.github.io/webappsec-fetch-metadata/
+   
    [WebIDL]
+   
    Boris Zbarsky. Web IDL. URL: https://heycam.github.io/webidl/
   
   
    IDL Index
    
 
    partial interface Window {
diff --git a/tests/github/WICG/background-fetch/index.html b/tests/github/WICG/background-fetch/index.html
index 4a761bc10a..e98dd062a4 100644
--- a/tests/github/WICG/background-fetch/index.html
+++ b/tests/github/WICG/background-fetch/index.html
@@ -758,6 +758,7 @@ 
    Table of Contents
    
       References
      
      
       
    1.  Normative References
+      
    2.  Informative References
      
    
     
  •  IDL Index
     
  •  Issues Index
@@ -3465,6 +3466,11 @@ 
    N
    
    [WebIDL]
    
    Boris Zbarsky. Web IDL. 15 December 2016. ED. URL: https://heycam.github.io/webidl/
   
+  
    Informative References
    
+  
    
+   
    [WebDriver]
+   
    Simon Stewart; David Burns. WebDriver. 5 June 2018. REC. URL: https://www.w3.org/TR/webdriver1/
+  
    
   
    IDL Index
    
 
    partial interface ServiceWorkerGlobalScope {
   attribute EventHandler onbackgroundfetchsuccess;
diff --git a/tests/github/WICG/background-sync/spec/PeriodicBackgroundSync-index.html b/tests/github/WICG/background-sync/spec/PeriodicBackgroundSync-index.html
index a57980b32e..217e1f2b79 100644
--- a/tests/github/WICG/background-sync/spec/PeriodicBackgroundSync-index.html
+++ b/tests/github/WICG/background-sync/spec/PeriodicBackgroundSync-index.html
@@ -1769,6 +1769,8 @@ 
    N
    
    S. Bradner. Key words for use in RFCs to Indicate Requirement Levels. March 1997. Best Current Practice. URL: https://datatracker.ietf.org/doc/html/rfc2119
    
    [SERVICE-WORKERS-1]
    
    Alex Russell; et al. Service Workers 1. 19 November 2019. CR. URL: https://www.w3.org/TR/service-workers-1/
+   
    [SERVICE-WORKERS-1]
+   
    Alex Russell; et al. Service Workers 1. 19 November 2019. CR. URL: https://www.w3.org/TR/service-workers-1/
    
    [WEB-BACKGROUND-SYNC]
    
    Web Background Synchronization. cg-draft. URL: https://wicg.github.io/background-sync/spec/
    
    [WebIDL]
diff --git a/tests/github/WICG/background-sync/spec/index.html b/tests/github/WICG/background-sync/spec/index.html
index 38ca159968..bb372d15f7 100644
--- a/tests/github/WICG/background-sync/spec/index.html
+++ b/tests/github/WICG/background-sync/spec/index.html
@@ -698,6 +698,7 @@ 
    Table of Contents
    
       References
      
      
       
    1.  Normative References
+      
    2.  Informative References
      
    
     
  •  IDL Index
    
@@ -1359,6 +1360,11 @@ 
    N
    
    [WebIDL]
    
    Boris Zbarsky. Web IDL. 15 December 2016. ED. URL: https://heycam.github.io/webidl/
   
+  
    Informative References
    
+  
    
+   
    [SERVICE-WORKERS-1]
+   
    Alex Russell; et al. Service Workers 1. 19 November 2019. CR. URL: https://www.w3.org/TR/service-workers-1/
+  
    
   
    IDL Index
    
 
    partial interface ServiceWorkerRegistration {
   readonly attribute SyncManager sync;
diff --git a/tests/github/WICG/construct-stylesheets/index.html b/tests/github/WICG/construct-stylesheets/index.html
index b5a5081dc8..61fe7b36b5 100644
--- a/tests/github/WICG/construct-stylesheets/index.html
+++ b/tests/github/WICG/construct-stylesheets/index.html
@@ -2102,6 +2102,7 @@ 
    Table of Contents
    
       References
      
      
       
    1.  Normative References
+      
    2.  Informative References
      
    
     
  •  IDL Index
    
@@ -2827,6 +2828,11 @@ 
    N
    
    [WebIDL]
    
    Boris Zbarsky. Web IDL. 15 December 2016. ED. URL: https://heycam.github.io/webidl/
   
+  
    Informative References
    
+  
    
+   
    [CSS-CASCADE-5]
+   
    Elika Etemad; Miriam Suzanne; Tab Atkins Jr.. CSS Cascading and Inheritance Level 5. 19 March 2021. WD. URL: https://www.w3.org/TR/css-cascade-5/
+  
    
   
    IDL Index
    
 
    partial interface CSSStyleSheet {
   constructor(optional CSSStyleSheetInit options = {});
diff --git a/tests/github/WICG/contact-api/spec/index.html b/tests/github/WICG/contact-api/spec/index.html
index 9e2269f30a..27eb52251b 100644
--- a/tests/github/WICG/contact-api/spec/index.html
+++ b/tests/github/WICG/contact-api/spec/index.html
@@ -1426,6 +1426,8 @@ 
    N
   
   
    Informative References
    
   
    
+   
    [FileAPI]
+   
    Marijn Kruisselbrink; Arun Ranganathan. File API. 11 September 2019. WD. URL: https://www.w3.org/TR/FileAPI/
    
    [MIMESNIFF]
    
    Gordon P. Hemsley. MIME Sniffing Standard. Living Standard. URL: https://mimesniff.spec.whatwg.org/
   
    
diff --git a/tests/github/WICG/content-index/spec/index.html b/tests/github/WICG/content-index/spec/index.html
index edaebc31ff..5759704fc2 100644
--- a/tests/github/WICG/content-index/spec/index.html
+++ b/tests/github/WICG/content-index/spec/index.html
@@ -752,6 +752,7 @@ 
    Table of Contents
    
       References
      
      
       
    1.  Normative References
+      
    2.  Informative References
      
    
     
  •  IDL Index
     
  •  Issues Index
@@ -1992,6 +1993,11 @@ 
    N
    
    [WebIDL]
    
    Boris Zbarsky. Web IDL. 15 December 2016. ED. URL: https://heycam.github.io/webidl/
   
+  
    Informative References
    
+  
    
+   
    [SERVICE-WORKERS-1]
+   
    Alex Russell; et al. Service Workers 1. 19 November 2019. CR. URL: https://www.w3.org/TR/service-workers-1/
+  
    
   
    IDL Index
    
 
    partial interface ServiceWorkerGlobalScope {
   attribute EventHandler oncontentdelete;
diff --git a/tests/github/WICG/cookie-store/index.html b/tests/github/WICG/cookie-store/index.html
index 494986b8b3..bc81e588ef 100644
--- a/tests/github/WICG/cookie-store/index.html
+++ b/tests/github/WICG/cookie-store/index.html
@@ -2714,7 +2714,7 @@ 
    type
     
    
  • 
-    [ecma262] defines the following terms:
+    [ECMA262] defines the following terms:
     
    
  • 
-    [draft-ietf-httpbis-header-structure] defines the following terms:
+    [DRAFT-IETF-HTTPBIS-HEADER-STRUCTURE] defines the following terms:
     
      
      
    • parsing http1 header fields into structured headers
     
    
@@ -4139,12 +4139,20 @@ 
    N
   
   
    Informative References
    
   
    
+   
    [DRAFT-YASSKIN-HTTP-ORIGIN-SIGNED-RESPONSES]
+   
    Jeffrey Yasskin. Signed HTTP Exchanges. ED. URL: https://wicg.github.io/webpackage/draft-yasskin-http-origin-signed-responses.html
+   
    [DRAFT-YASSKIN-HTTPBIS-ORIGIN-SIGNED-EXCHANGES-IMPL-02]
+   
    Jeffrey Yasskin; Kouhei Ueno. Signed HTTP Exchanges Implementation Checkpoints. ED. URL: https://tools.ietf.org/html/draft-yasskin-httpbis-origin-signed-exchanges-impl-02
    
    [DRAFT-YASSKIN-HTTPBIS-ORIGIN-SIGNED-EXCHANGES-IMPL-03]
    
    Jeffrey Yasskin; Kouhei Ueno. Signed HTTP Exchanges Implementation Checkpoints. ED. URL: https://tools.ietf.org/html/draft-yasskin-httpbis-origin-signed-exchanges-impl-03
    
    [HTTP-DIG-ALG]
    
    Hypertext Transfer Protocol (HTTP) Digest Algorithm Values. LS. URL: https://www.iana.org/assignments/http-dig-alg/http-dig-alg.xhtml
+   
    [NETWORK-ERROR-LOGGING-1]
+   
    Douglas Creager; et al. Network Error Logging. 25 September 2018. WD. URL: https://www.w3.org/TR/network-error-logging-1/
    
    [RFC3230]
    
    J. Mogul; A. Van Hoff. Instance Digests in HTTP. January 2002. Proposed Standard. URL: https://datatracker.ietf.org/doc/html/rfc3230
+   
    [RFC8288]
+   
    M. Nottingham. Web Linking. October 2017. Proposed Standard. URL: https://httpwg.org/specs/rfc8288.html
    
    [SERVICE-WORKERS-1]
    
    Alex Russell; et al. Service Workers 1. 19 November 2019. CR. URL: https://www.w3.org/TR/service-workers-1/
   
    
diff --git a/tests/github/WICG/webusb/index.html b/tests/github/WICG/webusb/index.html
index c805900f40..79a09ec381 100644
--- a/tests/github/WICG/webusb/index.html
+++ b/tests/github/WICG/webusb/index.html
@@ -3555,6 +3555,8 @@ 
    
    
    [CORS]
    
    Anne van Kesteren. Cross-Origin Resource Sharing. 2 June 2020. REC. URL: https://www.w3.org/TR/cors/
+   
    [PERMISSIONS]
+   
    Mounir Lamouri; Marcos Caceres; Jeffrey Yasskin. Permissions. 20 July 2020. WD. URL: https://www.w3.org/TR/permissions/
    
    [POWERFUL-FEATURES]
    
    Mike West. Secure Contexts. 15 September 2016. CR. URL: https://www.w3.org/TR/secure-contexts/
    
    [RFC4122]
diff --git a/tests/github/WICG/webusb/test/index.html b/tests/github/WICG/webusb/test/index.html
index c4d34feda4..8a15e8a8a4 100644
--- a/tests/github/WICG/webusb/test/index.html
+++ b/tests/github/WICG/webusb/test/index.html
@@ -645,6 +645,7 @@ 
    Table of Contents
    
       References
      
      
       
    1.  Normative References
+      
    2.  Informative References
      
    
     
  •  IDL Index
    
@@ -1531,6 +1532,13 @@ 
    N
    
    [WebUSB]
    
    WebUSB API. cg-draft. URL: https://wicg.github.io/webusb/
   
+  
    Informative References
    
+  
    
+   
    [WebIDL]
+   
    Boris Zbarsky. Web IDL. 15 December 2016. ED. URL: https://heycam.github.io/webidl/
+   
    [WebUSB]
+   
    WebUSB API. cg-draft. URL: https://wicg.github.io/webusb/
+  
    
   
    IDL Index
    
 
    partial interface USB {
   [SameObject] readonly attribute USBTest test;
diff --git a/tests/github/WebAudio/web-audio-api/index.html b/tests/github/WebAudio/web-audio-api/index.html
index 232b5861a1..a10c581394 100644
--- a/tests/github/WebAudio/web-audio-api/index.html
+++ b/tests/github/WebAudio/web-audio-api/index.html
@@ -17085,11 +17085,13 @@ 
    N
    
    [HR-TIME-2]
    
    Ilya Grigorik. High Resolution Time Level 2. 21 November 2019. REC. URL: https://www.w3.org/TR/hr-time-2/
    
    [HTML]
-   
    Anne van Kesteren; et al. HTML Standard. Living Standard. URL: https://html.spec.whatwg.org/multipage/
+   
    A vocabulary and associated APIs for HTML and XHTML URL: https://html.spec.whatwg.org/multipage/
    
    [INFRA]
    
    Anne van Kesteren; Domenic Denicola. Infra Standard. Living Standard. URL: https://infra.spec.whatwg.org/
    
    [MEDIACAPTURE-STREAMS]
    
    Cullen Jennings; et al. Media Capture and Streams. 22 March 2021. CR. URL: https://www.w3.org/TR/mediacapture-streams/
+   
    [MIMESNIFF]
+   
    Gordon P. Hemsley. MIME Sniffing Standard. Living Standard. URL: https://mimesniff.spec.whatwg.org/
    
    [RFC2119]
    
    S. Bradner. Key words for use in RFCs to Indicate Requirement Levels. March 1997. Best Current Practice. URL: https://datatracker.ietf.org/doc/html/rfc2119
    
    [WebIDL]
@@ -17101,14 +17103,18 @@ 
    
    
    [2DCONTEXT]
    
    Rik Cabanier; et al. HTML Canvas 2D Context. 28 January 2021. REC. URL: https://www.w3.org/TR/2dcontext/
+   
    [HTML]
+   
    A vocabulary and associated APIs for HTML and XHTML URL: https://html.spec.whatwg.org/multipage/
+   
    [MEDIACAPTURE-STREAMS]
+   
    Cullen Jennings; et al. Media Capture and Streams. 22 March 2021. CR. URL: https://www.w3.org/TR/mediacapture-streams/
    
    [MEDIASTREAM-RECORDING]
    
    Miguel Casas-sanchez; James Barnett; Travis Leithead. MediaStream Recording. 16 February 2021. WD. URL: https://www.w3.org/TR/mediastream-recording/
-   
    [MIMESNIFF]
-   
    Gordon P. Hemsley. MIME Sniffing Standard. Living Standard. URL: https://mimesniff.spec.whatwg.org/
    
    [WEBAUDIO-USECASES]
    
    Joe Berkovitz; Olivier Thereaux. Web Audio Processing: Use Cases and Requirements. 29 January 2013. NOTE. URL: https://www.w3.org/TR/webaudio-usecases/
    
    [WEBGL]
    
    Dean Jackson; Jeff Gilbert. WebGL 2.0 Specification. 12 August 2017. URL: https://www.khronos.org/registry/webgl/specs/latest/2.0/
+   
    [WebIDL]
+   
    Boris Zbarsky. Web IDL. 15 December 2016. ED. URL: https://heycam.github.io/webidl/
    
    [XHR]
    
    Anne van Kesteren. XMLHttpRequest Standard. Living Standard. URL: https://xhr.spec.whatwg.org/
   
diff --git a/tests/github/WebBluetoothCG/web-bluetooth/index.html b/tests/github/WebBluetoothCG/web-bluetooth/index.html
index 5a490b72ea..f537be4a51 100644
--- a/tests/github/WebBluetoothCG/web-bluetooth/index.html
+++ b/tests/github/WebBluetoothCG/web-bluetooth/index.html
@@ -6761,6 +6761,12 @@ 
    
    
    [CSP3]
    
    Mike West. Content Security Policy Level 3. 24 March 2021. WD. URL: https://www.w3.org/TR/CSP3/
+   
    [ECMAScript]
+   
    ECMAScript Language Specification. URL: https://tc39.es/ecma262/
+   
    [PERMISSIONS]
+   
    Mounir Lamouri; Marcos Caceres; Jeffrey Yasskin. Permissions. 20 July 2020. WD. URL: https://www.w3.org/TR/permissions/
+   
    [WebIDL]
+   
    Boris Zbarsky. Web IDL. 15 December 2016. ED. URL: https://heycam.github.io/webidl/
   
   
    IDL Index
    
 
    dictionary BluetoothDataFilterInit {
diff --git a/tests/github/WebBluetoothCG/web-bluetooth/scanning.html b/tests/github/WebBluetoothCG/web-bluetooth/scanning.html
index 449f9ec015..4165a4932a 100644
--- a/tests/github/WebBluetoothCG/web-bluetooth/scanning.html
+++ b/tests/github/WebBluetoothCG/web-bluetooth/scanning.html
@@ -1926,8 +1926,14 @@ 
    N
   
   
    Informative References
    
   
    
+   
    [ECMAScript]
+   
    ECMAScript Language Specification. URL: https://tc39.es/ecma262/
    
    [GEOLOCATION-API]
    
    Andrei Popescu. Geolocation API Specification 2nd Edition. 8 November 2016. REC. URL: https://www.w3.org/TR/geolocation-API/
+   
    [PERMISSIONS]
+   
    Mounir Lamouri; Marcos Caceres; Jeffrey Yasskin. Permissions. 20 July 2020. WD. URL: https://www.w3.org/TR/permissions/
+   
    [WEB-BLUETOOTH]
+   
    Jeffrey Yasskin. Web Bluetooth. Draft Community Group Report. URL: https://webbluetoothcg.github.io/web-bluetooth/
   
    
   
    IDL Index
    
 
    dictionary BluetoothLEScanOptions {
diff --git a/tests/github/WebBluetoothCG/web-bluetooth/tests.html b/tests/github/WebBluetoothCG/web-bluetooth/tests.html
index e73609133f..feef697d6a 100644
--- a/tests/github/WebBluetoothCG/web-bluetooth/tests.html
+++ b/tests/github/WebBluetoothCG/web-bluetooth/tests.html
@@ -1039,7 +1039,7 @@ 
    Terms defined by reference
    
   
    
  • 
-    [webxr device api - level 1] defines the following terms:
+    [WEBXR DEVICE API - LEVEL 1] defines the following terms:
     
      
      
    • XRFrame
      
    • XRSession
@@ -1614,7 +1614,7 @@ 
      xr device
     
    
    
  • 
-    [webxr layers] defines the following terms:
+    [WEBXR LAYERS] defines the following terms:
     
      
      
    • opaque texture
     
    
@@ -1642,6 +1642,8 @@ 
    N
   
   
    Informative References
    
   
    
+   
    [WEBXR]
+   
    Brandon Jones; Manish Goregaokar; Nell Waliczek. WebXR Device API. 24 July 2020. WD. URL: https://www.w3.org/TR/webxr/
    
    [WEBXR-AR-MODULE-1]
    
    Brandon Jones; Nell Waliczek; Manish Goregaokar. WebXR Augmented Reality Module - Level 1. 10 October 2019. WD. URL: https://www.w3.org/TR/webxr-ar-module-1/
   
    
diff --git a/tests/github/immersive-web/dom-overlays/index.html b/tests/github/immersive-web/dom-overlays/index.html
index 366e99d0e6..394e7085f4 100644
--- a/tests/github/immersive-web/dom-overlays/index.html
+++ b/tests/github/immersive-web/dom-overlays/index.html
@@ -979,18 +979,6 @@ 
    2.2. CSS pseudo-class
    
   
-  
-  
   
-  
-  
-  
-