Skip to content

Commit b9175e8

Browse files
committed
[css-fonts][css-prints][css-values][editorial] Add font- prefix to production names
1 parent 4838dee commit b9175e8

File tree

6 files changed

+47
-47
lines changed

6 files changed

+47
-47
lines changed

css-fonts-4/Overview.bs

Lines changed: 39 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -118,12 +118,12 @@ Font family: the 'font-family!!property' property</h3>
118118

119119
<pre class="propdef">
120120
Name: font-family
121-
Value: [ <<family-name>> | <<generic-family>> ]#
121+
Value: [ <<font-family-name>> | <<generic-font-family>> ]#
122122
Initial: depends on user agent
123123
Applies to: all elements and text
124124
Inherited: yes
125125
Percentages: n/a
126-
Computed value: list, each item a string and/or <<generic-family>> keywords
126+
Computed value: list, each item a string and/or <<generic-font-family>> keywords
127127
Animation type: discrete
128128
</pre>
129129

@@ -212,19 +212,19 @@ Font family: the 'font-family!!property' property</h3>
212212
There are three types of font family names, two of which may be used with this property:
213213

214214
<dl>
215-
<dt><dfn id="family-name-value"><<family-name>></dfn>
215+
<dt><dfn id="font-family-name-value"><<font-family-name>></dfn>
216216
<dd>
217217
The name of a font family, such as Helvetica or Verdana in the previous example.
218218

219219
This might be a locally-instaled font, or might be a web font.
220220

221-
<dt><<generic-family>>
221+
<dt><<generic-font-family>>
222222
<dd>
223-
Each <<generic-family>> keyword represents
223+
Each <<generic-font-family>> keyword represents
224224
a generic font choice,
225225
and behaves as a potential alias for one or more locally-installed fonts
226226
belonging to the specified generic font category.
227-
A <<generic-family>> can thus be used as a fallback
227+
A <<generic-font-family>> can thus be used as a fallback
228228
for when an author's more specific font choices are not available.
229229

230230
There are three types of generic family:
@@ -249,12 +249,12 @@ Font family: the 'font-family!!property' property</h3>
249249
and to use a more specific generic font family, if applicable,
250250
to prefer a specific style even if the individual named font family is not available.
251251

252-
Note that <<generic-family>> keywords cannot be quoted
253-
(otherwise they are interpreted as a <<family-name>>).
252+
Note that <<generic-font-family>> keywords cannot be quoted
253+
(otherwise they are interpreted as a <<font-family-name>>).
254254

255255
The set of generic family keywords is defined in [[#generic-font-families]].
256256

257-
<dt><dfn id="system-family-name-value"><<system-family-name>></dfn>
257+
<dt><dfn id="system-family-name-value"><<system-font-family-name>></dfn>
258258
<dd>
259259
A locally installed system font, whose use is subject to certain constraints.
260260
In particular, it may not be used with the ''font-family'' property,
@@ -284,11 +284,11 @@ Font family: the 'font-family!!property' property</h3>
284284

285285
</dl>
286286

287-
<h4 id="family-name-syntax">
288-
Syntax of <<family-name>>
287+
<h4 id="font-family-name-syntax">
288+
Syntax of <<font-family-name>>
289289
</h4>
290290

291-
<pre class=prod><l><<family-name>></l> = <<string>> | <<custom-ident>>+</pre>
291+
<pre class=prod><l><<font-family-name>></l> = <<string>> | <<custom-ident>>+</pre>
292292

293293
Font family names other than generic families or system font families
294294
must either be given quoted as <<string>>s,
@@ -318,7 +318,7 @@ Syntax of <<family-name>>
318318

319319
Note: this means that if you really have a font
320320
whose name
321-
is the same as one of the <<generic-family>> names,
321+
is the same as one of the <<generic-font-family>> names,
322322
or the system font names,
323323
or the [=CSS-wide keywords=],
324324
it <em>must</em> be quoted.
@@ -336,7 +336,7 @@ Syntax of <<family-name>>
336336
</pre>
337337
</div>
338338

339-
If a sequence of identifiers is given as a <<family-name>>,
339+
If a sequence of identifiers is given as a <<font-family-name>>,
340340
the computed value is the name
341341
converted to a string
342342
by joining all the identifiers in the sequence by single spaces.
@@ -358,27 +358,27 @@ Syntax of <<family-name>>
358358
Font family <em>names</em> that happen to be the same as
359359
a 'font-family!!property' keyword value
360360
(e.g. <a>CSS-wide keywords</a> such as ''inherit'', or
361-
<<generic-family>> keywords such as ''serif'')
361+
<<generic-font-family>> keywords such as ''serif'')
362362
must be quoted to prevent confusion
363363
with the keywords of the same names.
364-
UAs must not consider these keywords as matching the <<family-name>> type.
364+
UAs must not consider these keywords as matching the <<font-family-name>> type.
365365

366366
<h4 id="generic-family-name-syntax">
367-
Syntax of <<generic-family>>
367+
Syntax of <<generic-font-family>>
368368
</h4>
369369

370370
<!-- <pre class=prod>
371-
<dfn><<generic-family>></dfn> = generic(<<generic-script-specific>>) | <<generic-complete>> | <<generic-incomplete>>
372-
<dfn><<generic-script-specific>></dfn> = <a href="">kai</a> | fangsong | nastaliq
373-
<dfn><<generic-complete>></dfn> = serif | sans-serif | system-ui | cursive | fantasy | math | monospace
374-
<dfn><<generic-incomplete>></dfn> = ui-serif | ui-sans-serif | ui-monospace | ui-rounded
371+
<dfn><<generic-font-family>></dfn> = generic(<<generic-font-script-specific>>) | <<generic-font-complete>> | <<generic-font-incomplete>>
372+
<dfn><<generic-font-script-specific>></dfn> = <a href="">kai</a> | fangsong | nastaliq
373+
<dfn><<generic-font-complete>></dfn> = serif | sans-serif | system-ui | cursive | fantasy | math | monospace
374+
<dfn><<generic-font-incomplete>></dfn> = ui-serif | ui-sans-serif | ui-monospace | ui-rounded
375375
</pre> -->
376376

377377
<pre class=prod>
378-
<dfn><<generic-family>></dfn> = <<generic-script-specific>>| <<generic-complete>> | <<generic-incomplete>>
379-
<dfn><<generic-script-specific>></dfn> = <l>''generic(fangsong)''</l> | <l>''generic(kai)''</l> | <l>''generic(khmer-mul)''</l> | <l>''generic(nastaliq)''</l>
380-
<dfn><<generic-complete>></dfn> = <l>''serif''</l> | <l>''sans-serif''</l> | <l>''system-ui''</l> | <l>''cursive''</l> | <l>''fantasy''</l> | <l>''math''</l> | <l>''monospace''</l>
381-
<dfn><<generic-incomplete>></dfn> = <l>''ui-serif''</l> | <l>''ui-sans-serif''</l> | <l>''ui-monospace''</l> | <l>''ui-rounded''</l>
378+
<dfn><<generic-font-family>></dfn> = <<generic-font-script-specific>>| <<generic-font-complete>> | <<generic-font-incomplete>>
379+
<dfn><<generic-font-script-specific>></dfn> = <l>''generic(fangsong)''</l> | <l>''generic(kai)''</l> | <l>''generic(khmer-mul)''</l> | <l>''generic(nastaliq)''</l>
380+
<dfn><<generic-font-complete>></dfn> = <l>''serif''</l> | <l>''sans-serif''</l> | <l>''system-ui''</l> | <l>''cursive''</l> | <l>''fantasy''</l> | <l>''math''</l> | <l>''monospace''</l>
381+
<dfn><<generic-font-incomplete>></dfn> = <l>''ui-serif''</l> | <l>''ui-sans-serif''</l> | <l>''ui-monospace''</l> | <l>''ui-rounded''</l>
382382
</pre>
383383

384384
To make the syntax less succeptible to clashes, more recently defined generic font families are identified using a functional syntax.
@@ -397,11 +397,11 @@ Syntax of <<generic-family>>
397397
</div>
398398

399399
<h4 id="system">
400-
Syntax of <<system-family-name>>
400+
Syntax of <<system-font-family-name>>
401401
</h4>
402402

403403
<pre class="prod">
404-
<l><<system-family-name>></l> = <l>''caption''</l> | <l>''icon''</l> | <l>''menu''</l> | <l>''message-box''</l> | <l>''small-caption''</l> | <l>''status-bar''</l>
404+
<l><<system-font-family-name>></l> = <l>''caption''</l> | <l>''icon''</l> | <l>''menu''</l> | <l>''message-box''</l> | <l>''small-caption''</l> | <l>''status-bar''</l>
405405
</pre>
406406

407407
<h4 id="font-families">
@@ -461,14 +461,14 @@ Generic font families</h4>
461461
generic-family-keywords-002.html
462462
</wpt>
463463

464-
Note: Generic font families are intended to be widely implemented on many platforms, unlike arbitrary <<family-name>>s which are usually platform-specific names. They are expected to map to different fonts on different platforms. Authors may specify these generic family names if they desire their text to follow a particular design on many platforms, and are not particular about which specific font is chosen on those platforms.
464+
Note: Generic font families are intended to be widely implemented on many platforms, unlike arbitrary <<font-family-name>>s which are usually platform-specific names. They are expected to map to different fonts on different platforms. Authors may specify these generic family names if they desire their text to follow a particular design on many platforms, and are not particular about which specific font is chosen on those platforms.
465465

466466
User agents should provide reasonable default choices for the generic font families,
467467
that express the characteristics of each family as well as possible,
468468
within the limits allowed by the underlying technology.
469469
User agents are encouraged to allow users to select alternative faces for the generic font families.
470470

471-
<dl dfn-for="font-family,<generic-family>" dfn-type=value>
471+
<dl dfn-for="font-family,<generic-font-family>" dfn-type=value>
472472
<dt id="serif-def"><dfn>serif</dfn>
473473
<dd>
474474
Serif fonts represent
@@ -1782,7 +1782,7 @@ Shorthand font property: the 'font' property</h3>
17821782
<<'font-weight'>> ||
17831783
<<font-width-css3>> ]? <<'font-size'>> [ / <<'line-height'>> ]?
17841784
<<'font-family'>># ] |
1785-
<<system-family-name>>
1785+
<<system-font-family-name>>
17861786
Initial: see individual properties
17871787
Applies to: all elements and text
17881788
Inherited: yes
@@ -2691,7 +2691,7 @@ The <dfn id="at-font-face-rule">''@font-face''</dfn> rule</h3>
26912691

26922692
<pre class='descdef'>
26932693
Name: font-family
2694-
Value: <<family-name>>
2694+
Value: <<font-family-name>>
26952695
For: @font-face
26962696
Initial: N/A
26972697
</pre>
@@ -2755,7 +2755,7 @@ The <dfn id="at-font-face-rule">''@font-face''</dfn> rule</h3>
27552755

27562756
To parse a <dfn><<font-src-list>></dfn> production, [=parse a list=] of <<font-src>>s.
27572757

2758-
<pre class="prod"><dfn>&lt;font-src></dfn> = <<url>> [ format(<<font-format>>)]? [ tech( <<font-tech>>#)]? | local(<<family-name>>)</pre>
2758+
<pre class="prod"><dfn>&lt;font-src></dfn> = <<url>> [ format(<<font-format>>)]? [ tech( <<font-tech>>#)]? | local(<<font-family-name>>)</pre>
27592759

27602760
<pre class="prod"><dfn id="font-format-values">&lt;font-format&gt;</dfn>
27612761
= [<<string>> | collection | embedded-opentype | opentype
@@ -2941,7 +2941,7 @@ or font format.
29412941
a locally available copy of a given font
29422942
and download it if it's not,
29432943
<code>local()</code> can be used.
2944-
The locally-installed <<family-name>> argument to <code>local()</code>
2944+
The locally-installed <<font-family-name>> argument to <code>local()</code>
29452945
is a format-specific string
29462946
that uniquely identifies a single font face
29472947
within a larger family.
@@ -2956,7 +2956,7 @@ or font format.
29562956
separated by a single space;
29572957
and thus,
29582958
<a>CSS-wide keywords</a> such as ''inherit'', and
2959-
<<generic-family>> keywords such as ''serif''
2959+
<<generic-font-family>> keywords such as ''serif''
29602960
are not allowed inside <code>local()</code>.
29612961

29622962

@@ -6018,7 +6018,7 @@ Each <<font-feature-value>> has the same meaning
60186018
as the corresponding value of the 'font-variant-alternates' property.
60196019

60206020
<pre class=prod export>
6021-
@font-feature-values = @font-feature-values <<family-name>># { <<declaration-rule-list>> }
6021+
@font-feature-values = @font-feature-values <<font-family-name>># { <<declaration-rule-list>> }
60226022
60236023
<dfn for="@font-feature-values">font-feature-value-type</dfn> = <<@stylistic>> | <<@historical-forms>> | <<@styleset>> | <<@character-variant>>
60246024
| <<@swash>> | <<@ornaments>> | <<@annotation>>
@@ -6038,13 +6038,13 @@ as the corresponding value of the 'font-variant-alternates' property.
60386038
</wpt>
60396039

60406040
The ''@font-feature-values'' prelude
6041-
is a comma-delimited list of font family names that match the definition of <<family-name>>
6041+
is a comma-delimited list of font family names that match the definition of <<font-family-name>>
60426042
for the 'font-family!!property' property.
60436043
This means that only named font families are allowed;
60446044
rules that include generic or system fonts in the list of font families are syntax errors.
60456045
However, if a user agent defines a generic font to be a specific named font (e.g. Helvetica),
60466046
the settings associated with that family name will be used.
6047-
If syntax errors occur within the <<family-name>> list,
6047+
If syntax errors occur within the <<font-family-name>> list,
60486048
the entire rule ''@font-feature-values'' rule is invalid
60496049
and must be ignored.
60506050

@@ -6079,7 +6079,7 @@ Between different <<feature-value-block>>s,
60796079
or the same type of <<feature-value-block>>s in separate ''@font-feature-values'' rules,
60806080
names can be reused without colliding.
60816081

6082-
For each <<family-name>> in the ''@font-feature-values'' prelude,
6082+
For each <<font-family-name>> in the ''@font-feature-values'' prelude,
60836083
each [=font feature value declaration=] defines a mapping between a
60846084
(family name, feature block name, declaration name) [=tuple=]
60856085
and the list of one or more integers from the declaration's value.
@@ -7833,7 +7833,7 @@ Font family: the '@font-palette-values/font-family' descriptor</h4>
78337833

78347834
<pre class='descdef'>
78357835
Name: font-family
7836-
Value: <<family-name>>#
7836+
Value: <<font-family-name>>#
78377837
For: @font-palette-values
78387838
Initial: N/A
78397839
</pre>

css-fonts-5/Overview.bs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -211,7 +211,7 @@ in CSS Fonts Level 4, the following new generic font families are also defined.
211211

212212
Issue(4910):
213213

214-
<dl dfn-for="font-family,<generic-family>" dfn-type=value>
214+
<dl dfn-for="font-family,<generic-font-family>" dfn-type=value>
215215
<dt id="xxx-def"><dfn>xxx</dfn>
216216
<dd>
217217
Placeholder text for the xxx generic font family.
@@ -508,7 +508,7 @@ according to section [[css-syntax#parse-comma-separated-list-of-component-values
508508
Then each component value is parsed according to this grammar:
509509

510510

511-
<pre><<url>> [ format(<<font-format>>)]? [ tech( <<font-tech>>#)]? | local(<<family-name>>)</pre>
511+
<pre><<url>> [ format(<<font-format>>)]? [ tech( <<font-tech>>#)]? | local(<<font-family-name>>)</pre>
512512

513513
<pre class="prod"><dfn id="font-format-values">&lt;font-format&gt;</dfn>
514514
= [<<string>> | collection | embedded-opentype | opentype

css-print/Overview.bs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -574,8 +574,8 @@ small-caption | status-bar | inherit</td>
574574
<td>'font-family'</td>
575575
<td><em title="MUST In The RFC 2119 Context" class="RFC2119">MUST</em><a href="#table_note_1">*</a></td>
576576
<td><em title="MUST In The RFC 2119 Context" class="RFC2119">MUST</em><a href="#table_note_1">*</a></td>
577-
<td>[[ &lt;family-name&gt; | &lt;generic-family&gt; ],]* [
578-
&lt;family-name&gt; | &lt;generic-family&gt; ] | inherit</td>
577+
<td>[[ &lt;font-family-name&gt; | &lt;generic-font-family&gt; ],]* [
578+
&lt;font-family-name&gt; | &lt;generic-font-family&gt; ] | inherit</td>
579579
<td>depends on user agent</td></tr>
580580
<tr class="yes">
581581
<td>'font-size'</td>

css-values-3/Overview.bs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -418,7 +418,7 @@ Property Value Examples</h3>
418418
<td>''overline underline''
419419
<tr>
420420
<td><a property>font-family</a>
421-
<td>[ &lt;family-name> | &lt;generic-family> ]#
421+
<td>[ &lt;font-family-name> | &lt;generic-font-family> ]#
422422
<td>''"Gill Sans", Futura, sans-serif''
423423
<tr>
424424
<td>'border-width'

css-values-4/Overview.bs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -490,7 +490,7 @@ Property Value Examples</h3>
490490
<td>''overline underline''
491491
<tr>
492492
<td><a property>font-family</a>
493-
<td>[ &lt;family-name> | &lt;generic-family> ]#
493+
<td>[ &lt;font-family-name> | &lt;generic-font-family> ]#
494494
<td>''"Gill Sans", Futura, sans-serif''
495495
<tr>
496496
<td>'border-width'

cssom-1/Overview.bs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3215,7 +3215,7 @@ For other color functions, see
32153215

32163216

32173217
<dt><<string>>
3218-
<dt><<family-name>>
3218+
<dt><<font-family-name>>
32193219
<dd>The string
32203220
<a lt="serialize a string">serialized as a string</a>.
32213221

@@ -3235,7 +3235,7 @@ For other color functions, see
32353235
&lt;border-width>,
32363236
&lt;border-style>,
32373237
&lt;bottom>,
3238-
&lt;generic-family>,
3238+
&lt;generic-font-family>,
32393239
&lt;generic-voice>,
32403240
&lt;left>,
32413241
&lt;margin-width>,

0 commit comments

Comments
 (0)