Skip to content

Commit b9b1b45

Browse files
committed
[css-fonts-5][editorial] Fixed Bikeshed issues
1 parent 62bc8c7 commit b9b1b45

1 file changed

Lines changed: 24 additions & 20 deletions

File tree

css-fonts-5/Overview.bs

Lines changed: 24 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Previous Version: https://www.w3.org/TR/2021/WD-css-fonts-5-20211221/
1313
Former Editor: Myles C. Maxfield, Formerly of Apple Inc., mmaxfield@apple.com, w3cid 77180
1414
Editor: Chris Lilley, W3C, https://svgees.us/, w3cid 1438
1515
Abstract: This specification defines modifications to the existing <a href="https://drafts.csswg.org/css-fonts-4/">CSS Fonts 4</a> specification along with additional features.
16+
Ignored terms: cssText
1617
Repository: w3c/csswg-drafts
1718
Inline Github Issues: title
1819
Default Highlight: css
@@ -405,7 +406,7 @@ Issue(8792):
405406
Note how small text remains relatively legible across each row in the lower half.
406407

407408
<figure>
408-
<img alt="text with and without 'font-size-adjust'" src="images/fontsizeadjust.png" >
409+
<img src="images/fontsizeadjust.png" width="544" height="667" alt="">
409410
<figcaption>Text with and without the use of 'font-size-adjust'</figcaption>
410411
</figure>
411412
</div>
@@ -473,7 +474,7 @@ Issue(8792):
473474
</pre>
474475

475476
<figure>
476-
<img alt="Futura with an aspect value of 0.5" src="images/beforefontsizeadjust.png" >
477+
<img src="images/beforefontsizeadjust.png" width="281" height="306" alt="">
477478
<figcaption>Futura with an <a>aspect value</a> of 0.5</figcaption>
478479
</figure>
479480

@@ -482,10 +483,10 @@ Issue(8792):
482483
</div>
483484

484485
Note: If the specified metric has been overridden in ''@font-face'',
485-
e.g. by 'size-adjust',
486+
e.g. by 'size-adjust!!descriptor',
486487
then the overridden metric will be used in the 'font-size-adjust' calculation.
487-
Consequently, applying 'font-size-adjust' and 'size-adjust' together
488-
means that 'size-adjust' appears to have no effect.
488+
Consequently, applying 'font-size-adjust' and 'size-adjust!!descriptor' together
489+
means that 'size-adjust!!descriptor' appears to have no effect.
489490

490491
<h2 id="font-resources">
491492
Font Resources</h2>
@@ -497,7 +498,7 @@ The <dfn id="at-font-face-rule">''@font-face''</dfn> rule</h3>
497498
Multiple fonts can be used within an individual element
498499
e.g. for characters not supported by the [=first available font=].
499500

500-
<h3 id="src-desc">Font reference: the 'src' descriptor</h3>
501+
<h3 id="src-desc">Font reference: the 'src!!descriptor' descriptor</h3>
501502

502503

503504
<!-- same as CSS Fonts 4, keep the two in sync -->
@@ -592,7 +593,7 @@ For: @font-face
592593

593594
<h3 id="size-adjust-desc">
594595
Glyph Size Multiplier:
595-
the 'size-adjust' descriptor</h3>
596+
the 'size-adjust!!descriptor' descriptor</h3>
596597

597598
<pre class='descdef'>
598599
Name: size-adjust
@@ -601,7 +602,7 @@ the 'size-adjust' descriptor</h3>
601602
Initial: 100%
602603
</pre>
603604

604-
The 'size-adjust' descriptor defines a multiplier
605+
The 'size-adjust!!descriptor' descriptor defines a multiplier
605606
for glyph outlines and metrics associated with this font,
606607
to allow the author to harmonize the designs of various fonts
607608
when rendered at the same 'font-size!!property'.
@@ -620,7 +621,7 @@ the 'size-adjust' descriptor</h3>
620621
such as ''em'' units, percentages in 'text-underline-offset', etc.)
621622
remains unaffected.
622623

623-
Note: The 'size-adjust' descriptor functions similarly to
624+
Note: The 'size-adjust!!descriptor' descriptor functions similarly to
624625
the 'font-size-adjust' property,
625626
which essentially calculates an adjustment per font by matching ex heights,
626627
but likewise does not affect the [=computed value|computed=] 'font-size!!property'.
@@ -636,7 +637,7 @@ the 'size-adjust' descriptor</h3>
636637

637638
<h3 id="font-metrics-override-desc">
638639
Line Height Font Metrics Overrides:
639-
the 'ascent-override', 'descent-override', and 'line-gap-override' descriptors</h3>
640+
the 'ascent-override!!descriptor', 'descent-override!!descriptor', and 'line-gap-override!!descriptor' descriptors</h3>
640641

641642
<pre class='descdef'>
642643
Name: ascent-override
@@ -659,7 +660,7 @@ the 'ascent-override', 'descent-override', and 'line-gap-override' descriptors</
659660
Initial: normal
660661
</pre>
661662

662-
The 'ascent-override', 'descent-override', and 'line-gap-override' descriptors specify the
663+
The 'ascent-override!!descriptor', 'descent-override!!descriptor', and 'line-gap-override!!descriptor' descriptors specify the
663664
<a spec="CSS-INLINE-3">ascent metric</a>,
664665
<a spec="CSS-INLINE-3">descent metric</a>, and
665666
<a spec="CSS-INLINE-3">line gap metric</a>
@@ -690,10 +691,10 @@ the 'ascent-override', 'descent-override', and 'line-gap-override' descriptors</
690691
metrics-override-normal-keyword.html
691692
</wpt>
692693

693-
The 'font-size-adjust' property is applied after the 'size-adjust' descriptor.
694+
The 'font-size-adjust' property is applied after the 'size-adjust!!descriptor' descriptor.
694695

695-
Note: The consequence of applying 'font-size-adjust' after 'size-adjust' is that
696-
'size-adjust' appears to have no effect.
696+
Note: The consequence of applying 'font-size-adjust' after 'size-adjust!!descriptor' is that
697+
'size-adjust!!descriptor' appears to have no effect.
697698

698699
Note: None of these descriptors affect the [=computed value|computation=] of
699700
'font-size!!property', 'line-height', or [=font-relative lengths=].
@@ -756,7 +757,7 @@ the 'ascent-override', 'descent-override', and 'line-gap-override' descriptors</
756757

757758
<h3 id="font-sup-sub-override-desc">
758759
Superscript and subscript metrics overrides:
759-
the 'superscript-position-override', 'subscript-position-override','superscript-size-override' and 'subscript-size-override' descriptors</h3>
760+
the 'superscript-position-override!!descriptor', 'subscript-position-override!!descriptor','superscript-size-override!!descriptor' and 'subscript-size-override!!descriptor' descriptors</h3>
760761

761762
<pre class='descdef'>
762763
Name: superscript-position-override
@@ -786,8 +787,8 @@ the 'superscript-position-override', 'subscript-position-override','superscript-
786787
Initial: normal
787788
</pre>
788789

789-
The 'superscript-position-override', 'subscript-position-override',
790-
'superscript-size-override', and 'subscript-size-override' descriptors
790+
The 'superscript-position-override!!descriptor', 'subscript-position-override!!descriptor',
791+
'superscript-size-override!!descriptor', and 'subscript-size-override!!descriptor' descriptors
791792
specify the superscript offset, subscript offset, superscript size, and subscript size
792793
metrics of the font, respectively,
793794
which are used to synthesize glyphs when required by 'font-variant-position'.
@@ -855,7 +856,7 @@ Color Font Support</h2>
855856

856857
This section expands upon [[css-fonts-4#font-tech-definitions]].
857858

858-
The 'avar2' tech refers to support for version 2 of OpenType axis variations [[!avar2]],
859+
The <dfn value for="<font-features-tech>">avar2</dfn> tech refers to support for version 2 of OpenType axis variations [[!avar2]],
859860
for flexible variation axis remapping.
860861

861862
<div class="example" id="ex-avar2">
@@ -897,7 +898,7 @@ for flexible variation axis remapping.
897898
<h3 id="om-fontface">
898899
The <code id="cssfontfacerule2">CSSFontFaceRule</code> interface</h3>
899900

900-
The <dfn id="cssfontfacerule-interface">CSSFontFaceRule</dfn> interface represents a <<@font-face>> rule.
901+
The <dfn export id="cssfontfacerule-interface">CSSFontFaceRule</dfn> interface represents a <<@font-face>> rule.
901902

902903
<pre class="idl">
903904
[Exposed=Window]
@@ -1022,13 +1023,15 @@ Changes
10221023
alternates-order.html
10231024
animations/font-palette-animation-not-specified-endpoints.html
10241025
animations/font-palette-interpolation.html
1026+
animations/font-size-composition.html
10251027
animations/font-size-interpolation-001.html
10261028
animations/font-size-interpolation-002.html
10271029
animations/font-size-interpolation-003.html
10281030
animations/font-stretch-interpolation.html
10291031
animations/font-style-interpolation.html
10301032
animations/font-variation-settings-composition.html
10311033
animations/font-variation-settings-interpolation.html
1034+
animations/font-weight-composition.html
10321035
animations/multiple-elements-font-palette-animation.html
10331036
animations/system-fonts.html
10341037
calc-in-font-variation-settings.html
@@ -1306,6 +1309,7 @@ Changes
13061309
language-specific-01.html
13071310
matching/fixed-stretch-style-over-weight.html
13081311
matching/font-unicode-PUA.html
1312+
matching/font-weight-search-direction.html
13091313
matching/range-descriptor-reversed.html
13101314
matching/stretch-distance-over-weight-distance.html
13111315
matching/style-ranges-over-weight-direction.html
@@ -1495,7 +1499,7 @@ Changes
14951499
test-synthetic-bold.html
14961500
test-synthetic-italic.html
14971501
font-size-zero-3.html
1498-
font-synthesis-weight-webfont-bold.html
1502+
font-synthesis-weight-webfont-bold.html
14991503
</wpt>
15001504

15011505
<!--

0 commit comments

Comments
 (0)