[css-ui-3] Tweak metadata to make bikshed generate better bibliography

Author: frivoal

css-ui-3/Overview.bs

@@ -27,19 +27,19 @@ Abstract: This specification describes user interface related
           It uses various
           properties and values to style basic user interface elements in a document.
 Link Defaults: css-color-3 (property) color
-Link Defaults: css21 (property) min-width
-Link Defaults: css21 (property) min-height
-Link Defaults: css21 (property) max-width
-Link Defaults: css21 (property) max-height
-Link Defaults: css21 (property) width
-Link Defaults: css21 (property) height
-Link Defaults: css21 (property) margin-left
-Link Defaults: css21 (property) margin-top
-Link Defaults: css21 (property) padding-bottom
-Link Defaults: css21 (property) padding-left
-Link Defaults: css21 (property) padding-right
-Link Defaults: css21 (property) padding-top
-Link Defaults: css21 (property) visibility
+Link Defaults: css2 (property) min-width
+Link Defaults: css2 (property) min-height
+Link Defaults: css2 (property) max-width
+Link Defaults: css2 (property) max-height
+Link Defaults: css2 (property) width
+Link Defaults: css2 (property) height
+Link Defaults: css2 (property) margin-left
+Link Defaults: css2 (property) margin-top
+Link Defaults: css2 (property) padding-bottom
+Link Defaults: css2 (property) padding-left
+Link Defaults: css2 (property) padding-right
+Link Defaults: css2 (property) padding-top
+Link Defaults: css2 (property) visibility
 Link Defaults: css-writing-modes-3 (dfn) start
 Link Defaults: css-writing-modes-3 (dfn) end
 Ignored Terms: outline-top
@@ -64,32 +64,33 @@ Ignore Can I Use URL Failure: http://www.w3.org/TR/css3-ui/
 </pre>
 <pre class=link-defaults>
 spec:css-overflow-3; type:property; text:overflow
-spec:css21; type:property; text:display
-spec:css21; type:property; text:width
-spec:css21; type:property; text:height
-spec:css21; type:property; text:left
-spec:css21; type:property; text:overflow
-spec:css21; type:property; text:border-bottom-width
-spec:css21; type:property; text:border-left-width
-spec:css21; type:property; text:border-right-width
-spec:css21; type:property; text:border-top-width
-spec:css21; type:property; text:border-style
-spec:css21; type:property; text:border-width
-spec:css21; type:property; text:background-image
+spec:css2; type:property; text:display
+spec:css2; type:property; text:width
+spec:css2; type:property; text:height
+spec:css2; type:property; text:left
+spec:css2; type:property; text:overflow
+spec:css2; type:property; text:border-bottom-width
+spec:css2; type:property; text:border-left-width
+spec:css2; type:property; text:border-right-width
+spec:css2; type:property; text:border-top-width
+spec:css2; type:property; text:border-style
+spec:css2; type:property; text:border-width
+spec:css2; type:property; text:background-image
 </pre>
 
 <!-- Some of the following definitions have existing exported defintions from other specs,
 but not from specs that are OK to link to from a CR -->
 <pre class="anchors">
-url: https://www.w3.org/TR/CSS21/box.html#border-edge; type: dfn; spec: CSS21; text: border edge
-url: https://www.w3.org/TR/CSS21/visufx.html#propdef-overflow
-    type: property; spec: CSS21; text: overflow
-    type: value; spec: CSS21; text: visible; for: overflow
-url: https://www.w3.org/TR/CSS21/visuren.html#position-props; type: property; spec: CSS21;
+url: https://www.w3.org/TR/CSS2/box.html#border-edge; type: dfn; spec: CSS2; text: border edge
+url: https://www.w3.org/TR/CSS2/visufx.html#propdef-overflow
+    type: property; spec: CSS2; text: overflow
+    type: value; spec: CSS2; text: visible; for: overflow
+url: https://www.w3.org/TR/CSS2/visuren.html#position-props; type: property; spec: CSS2;
     text: top
     text: bottom
     text: left
     text: right
+url: https://www.w3.org/TR/CSS2/visudet.html#the-width-property; type: value; spec: CSS2; for: width; text: auto
 </pre>
 
 
@@ -99,7 +100,7 @@ This module describes CSS properties which enable authors
 to style user interface related properties and values.
 
 <a href="https://www.w3.org/TR/REC-CSS1#anchor-pseudo-classes">Section 2.1 of CSS1</a> [[CSS1]]
-and <a href="https://www.w3.org/TR/CSS2/ui.html">Chapter 18 of CSS2</a> [[CSS21]]
+and <a href="https://www.w3.org/TR/CSS2/ui.html">Chapter 18 of CSS2</a> [[CSS2]]
 introduced several user interface related properties and values.
 <a href="https://www.w3.org/TR/2000/WD-css3-userint-20000216">User Interface for CSS3 (16 February 2000)</a> introduced several new user interface related features.
 
@@ -121,14 +122,22 @@ This document defines new features not present in earlier specifications.
 In addition, it replaces and supersedes the following:
 
 <ul>
-<li><a href="https://www.w3.org/TR/CSS21/ui.html#cursor-props">Section 18.1</a>,
-<a href="https://www.w3.org/TR/CSS21/ui.html#dynamic-outlines">section 18.4</a>,
+<li><a href="https://www.w3.org/TR/CSS2/ui.html#cursor-props">Section 18.1</a>,
+<a href="https://www.w3.org/TR/CSS2/ui.html#dynamic-outlines">section 18.4</a>,
 and Information on the stacking of outlines defined in
-<a href="https://www.w3.org/TR/CSS21/zindex.html">Appendix E</a>
-of Cascading Style Sheets, level 2, revision 1 [[CSS21]]
-<li><a href="https://www.w3.org/TR/2000/WD-css3-userint-20000216">User Interface for CSS3 (16 February 2000)</a> [[CSSUI]]
+<a href="https://www.w3.org/TR/CSS2/zindex.html">Appendix E</a>
+of Cascading Style Sheets, level 2, revision 1 [[CSS2]]
+<li><a href="https://www.w3.org/TR/2000/WD-css3-userint-20000216">User Interface for CSS3 (16 February 2000)</a>
 </ul>
 
+Note: The semantics of property definition tables were first introduced in [[CSS2#property-defs]].
+More up-to-date definitions can be found in
+[[css-transitions-1]],
+[[css-values-3]],
+and [[css-cascade-4]].
+For the reader's convenience,
+this specification links directly to these terms where relevant.
+
 <h2 id="box-model">Box Model addition</h2>
 
 <h3 id="box-sizing" caniuse="css3-boxsizing">Changing the Box Model: the 'box-sizing' property</h3>
@@ -161,7 +170,7 @@ by subtracting the border and padding widths of the respective sides
 from the specified 'width'
 and 'height' properties.
 As the content width and height
-<a href="https://www.w3.org/TR/CSS21/visudet.html#the-width-property">cannot be negative</a> ([[!CSS21]], section 10.2),
+<a href="https://www.w3.org/TR/CSS2/visudet.html#the-width-property">cannot be negative</a> ([[!CSS2]], section 10.2),
 this computation is floored at 0.
 Used values, as exposed for instance through getComputedStyle(), also refer to the border box.
 
@@ -189,14 +198,14 @@ The following terms, whose definitions vary based on the computed value of 'box-
   <tr><th><dfn>max inner height</dfn><td>'max-height'<td>max(0, 'max-height' &minus; 'padding-top' &minus; 'padding-bottom' &minus; 'border-top-width' &minus; 'border-bottom-width')
 </table>
 
-The <a href="https://www.w3.org/TR/CSS21/visudet.html">Visual formatting model details</a> of [[!CSS21]] are written assuming ''box-sizing: content-box''. The following disambiguations are made to clarify the behavior for all values of 'box-sizing':
+The <a href="https://www.w3.org/TR/CSS2/visudet.html">Visual formatting model details</a> of [[!CSS2]] are written assuming ''box-sizing: content-box''. The following disambiguations are made to clarify the behavior for all values of 'box-sizing':
 
 <ol>
-<li>In <a href="https://www.w3.org/TR/CSS21/visudet.html#blockwidth">10.3.3</a>, the second <q>width</q> in the following phrase is to be interpreted as <a spec="css21">content width</a>: <q>If 'width' is not ''width/auto'' and 'border-left-width' + 'padding-left' + 'width' + [...]</q>
+<li>In <a href="https://www.w3.org/TR/CSS2/visudet.html#blockwidth">10.3.3</a>, the second <q>width</q> in the following phrase is to be interpreted as <a spec="css2">content width</a>: <q>If 'width' is not ''width/auto'' and 'border-left-width' + 'padding-left' + 'width' + [...]</q>
 
-<li>In <a href="https://www.w3.org/TR/CSS21/visudet.html#abs-non-replaced-width">10.3.7</a>, <q>width</q> is to be interpreted as <a spec="css21">content width</a> in the following equation: <q>'left' + 'margin-left' + 'border-left-width' + 'padding-left' + 'width' + [...]</q>
+<li>In <a href="https://www.w3.org/TR/CSS2/visudet.html#abs-non-replaced-width">10.3.7</a>, <q>width</q> is to be interpreted as <a spec="css2">content width</a> in the following equation: <q>'left' + 'margin-left' + 'border-left-width' + 'padding-left' + 'width' + [...]</q>
 
-<li>In <a href="https://www.w3.org/TR/CSS21/visudet.html#min-max-widths">10.4</a>, <q>width</q>, <q>height</q>, <q>min-width</q>, <q>max-width</q>, <q>min-height</q> and <q>max-height</q> are respectively to be interpreted as <a spec="css21">content width</a>, <a spec="css21">content height</a>, <a>min inner width</a>, <a>max inner width</a>, <a>min inner height</a> and <a>max inner height</a> in the following phrases:
+<li>In <a href="https://www.w3.org/TR/CSS2/visudet.html#min-max-widths">10.4</a>, <q>width</q>, <q>height</q>, <q>min-width</q>, <q>max-width</q>, <q>min-height</q> and <q>max-height</q> are respectively to be interpreted as <a spec="css2">content width</a>, <a spec="css2">content height</a>, <a>min inner width</a>, <a>max inner width</a>, <a>min inner height</a> and <a>max inner height</a> in the following phrases:
   <ol>
   <li><q>The tentative used width is calculated [...]</q>
   <li><q>If the tentative used width is greater than 'max-width', the rules above are applied again, but this time using the computed value of 'max-width' as the computed value for 'width'.</q>
@@ -206,9 +215,9 @@ The <a href="https://www.w3.org/TR/CSS21/visudet.html">Visual formatting model d
   <li><q>Then apply the rules under "Calculating widths and margins" above, as if 'width' were computed as this value.</q>
   </ol>
 
-<li>In <a href="https://www.w3.org/TR/CSS21/visudet.html#abs-non-replaced-height">10.6.4</a>, <q>height</q> is to be interpreted as <a spec="css21">content height</a> in the following equation: <q>'top' + 'margin-top' + 'border-top-width' + 'padding-top' + 'height' + [...]</q>
+<li>In <a href="https://www.w3.org/TR/CSS2/visudet.html#abs-non-replaced-height">10.6.4</a>, <q>height</q> is to be interpreted as <a spec="css2">content height</a> in the following equation: <q>'top' + 'margin-top' + 'border-top-width' + 'padding-top' + 'height' + [...]</q>
 
-<li>In <a href="https://www.w3.org/TR/CSS21/visudet.html#min-max-heights">10.7</a>, <q>width</q>, <q>height</q>, <q>min-height</q> and <q>max-height</q> are respectively to be interpreted as <a spec="css21">content width</a>, <a spec="css21">content height</a>, <a>min inner height</a> and <a>max inner height</a> in the following phrases:
+<li>In <a href="https://www.w3.org/TR/CSS2/visudet.html#min-max-heights">10.7</a>, <q>width</q>, <q>height</q>, <q>min-height</q> and <q>max-height</q> are respectively to be interpreted as <a spec="css2">content width</a>, <a spec="css2">content height</a>, <a>min inner height</a> and <a>max inner height</a> in the following phrases:
   <ol>
   <li><q>The tentative used height is calculated [...]</q>
   <li><q>If this tentative height is greater than 'max-height', the rules above are applied again, but this time using the value of 'max-height' as the computed value for 'height'.</q>
@@ -267,7 +276,7 @@ ways:
 
 The outline properties control the style of these dynamic outlines.
 
-The stacking of the rendering of these outlines is explicitly left up to implementations to provide a better user experience per platform. This supersedes the stacking of outlines as defined in <a href="https://www.w3.org/TR/CSS21/zindex.html">Appendix E of CSS 2.1</a> [[CSS21]].
+The stacking of the rendering of these outlines is explicitly left up to implementations to provide a better user experience per platform. This supersedes the stacking of outlines as defined in <a href="https://www.w3.org/TR/CSS2/zindex.html">Appendix E of CSS 2.1</a> [[CSS2]].
 
 <strong class="advisement">
 Keyboard users,
@@ -397,14 +406,14 @@ User agents may treat ''outline-style/auto'' as
 
 The 'outline-color' property
 accepts all colors, as well as the keyword <dfn dfn-type=value for=outline-color>invert</dfn>.
-''Invert'' is expected to perform a color inversion on the pixels on the screen.
+''outline-color/Invert'' is expected to perform a color inversion on the pixels on the screen.
 This is a common trick to ensure the focus border is visible,
 regardless of color background.
 
-Conformant UAs may ignore the ''invert'' value
+Conformant UAs may ignore the ''outline-color/invert'' value
 on platforms that do not support color inversion of the pixels on the screen.
 
-If the UA does not support the ''invert'' value
+If the UA does not support the ''outline-color/invert'' value
 then it must reject that value at parse-time, and
 the initial value of the 'outline-color' property
 is the ''outline-color/currentColor'' keyword.
@@ -565,7 +574,7 @@ to:
 
 The effect of the 'resize' property on generated content is undefined. Implementations should not apply the 'resize' property to generated content.
 
-Note: the 'resize' property may apply to generated content in the future if there is implementation of <a href="https://drafts.csswg.org/css-pseudo/#CSSPseudoElement-interface">Interface CSSPseudoElement</a>.
+Note: the 'resize' property may apply to generated content in the future if there is implementation of <a href="https://drafts.csswg.org/css-pseudo/#CSSPseudoElement-interface">Interface CSSPseudoElement</a> (See [[css-pseudo-4]]).
 
 When an element is resized by the user,
 the user agent sets
@@ -676,13 +685,13 @@ for implementation purposes.
 
 For the ellipsis value
 implementations must hide characters and
-<a href="https://www.w3.org/TR/CSS21/visuren.html#inline-boxes">
+<a href="https://www.w3.org/TR/CSS2/visuren.html#inline-boxes">
 atomic inline-level elements</a>
 at the <a>end</a> edge of the line as necessary to fit the ellipsis, and
 place the ellipsis immediately adjacent
 to the <a>end</a> edge of the remaining inline content.
 The first character or
-<a href="https://www.w3.org/TR/CSS21/visuren.html#inline-boxes">
+<a href="https://www.w3.org/TR/CSS2/visuren.html#inline-boxes">
 atomic inline-level element</a>
 on a line
 must be clipped rather than ellipsed.
@@ -1220,8 +1229,8 @@ and render the ''pointer'' cursor.
 
 <h5 id="canvas_cursor">Cursor of the canvas</h5>
 
-The document <a href="https://www.w3.org/TR/CSS21/intro.html#the-canvas">canvas</a>
-is the infinite surface over which the document is rendered [[!CSS21]].
+The document <a href="https://www.w3.org/TR/CSS2/intro.html#the-canvas">canvas</a>
+is the infinite surface over which the document is rendered [[!CSS2]].
 Since no element corresponds to the canvas,
 in order to allow styling of the cursor when not over any element,
 the canvas cursor re-uses the root element's cursor.
@@ -1315,7 +1324,7 @@ This example CSS may be placed into a user style sheet file to force password in
 This specification deliberately does not attempt to document the functionality of legacy ime-mode implementations nor what they specifically support because it does not make sense to pursue or recommend any such path.
 
 <div class="note">
-Note: there are several [[HTML5]] features which authors should use to provide information to user agents that allow them to provide a better input user experience:
+Note: there are several [[HTML]] features which authors should use to provide information to user agents that allow them to provide a better input user experience:
 
 <ul>
 <li>The global <code>lang</code> attribute