Skip to content

Commit 3235f9c

Browse files
committed
Rename 'auto' to be more awkward, since it's for deprecated stuff. Mark it at-risk.
1 parent ccc6dcc commit 3235f9c

2 files changed

Lines changed: 38 additions & 79 deletions

File tree

css3-writing-modes/Overview.html

Lines changed: 27 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -192,10 +192,6 @@ <h2 class="no-num no-toc" id=Contents> Table of Contents</h2>
192192

193193
<li><a href="#text-baselines"><span class=secno>4.2. </span> Text
194194
Baselines</a>
195-
<ul class=toc>
196-
<li><a href="#opentype-baselines"><span class=secno>4.2.1. </span>
197-
Baselines in TrueType/OpenType fonts</a>
198-
</ul>
199195

200196
<li><a href="#replaced-baselines"><span class=secno>4.3. </span> Atomic
201197
Inline Baselines</a>
@@ -1304,27 +1300,6 @@ <h3 id=text-baselines><span class=secno>4.2. </span> Text Baselines</h3>
13041300
<p class=note>A future CSS module will deal with baselines in more detail
13051301
and allow the choice of other dominant baselines and alignment options.
13061302

1307-
<h4 id=opentype-baselines><span class=secno>4.2.1. </span> Baselines in
1308-
TrueType/OpenType fonts</h4>
1309-
1310-
<p><em>This section is non-normative.</em>
1311-
1312-
<p>The alphabetic baseline is listed as the <var>romn</var> baseline in
1313-
TrueType/OpenType baseline tables. If missing, it can sometimes be
1314-
computed from the ascender and descender metrics. If it cannot be computed
1315-
from other metrics, it may be assumed to correspond to the zero
1316-
coordinate.
1317-
1318-
<p>For the ascender and descender metrics, it is recommended to use the
1319-
<var>sTypoAscender</var> and <var>sTypoDescender</var> metrics from the
1320-
font's OS/2 table. These should match the <var>idtp</var> and
1321-
<var>ideo</var> baselines (respectively), which, if present, may be used
1322-
instead. In the absence of these metrics, the <var>Ascent</var> and
1323-
<var>Descent</var> metrics from the HHEA/VHEA table should be used. The
1324-
Win metrics can be used as a fallback; however these are intended as
1325-
clipping bounds and are not always appropriate for use as em box
1326-
measurements.
1327-
13281303
<h3 id=replaced-baselines><span class=secno>4.3. </span> Atomic Inline
13291304
Baselines</h3>
13301305

@@ -1505,7 +1480,7 @@ <h3 id=text-orientation><span class=secno>5.1. </span> Orienting Text: the
15051480
<th>Value:
15061481

15071482
<td>vertical-right | upright | sideways-right | sideways-left | sideways
1508-
| auto
1483+
| use-glyph-orientation
15091484

15101485
<tr>
15111486
<th>Initial:
@@ -1638,7 +1613,7 @@ <h3 id=text-orientation><span class=secno>5.1. </span> Orienting Text: the
16381613
writing mode. It can be useful when setting horizontal script text
16391614
vertically in a primarily horizontal-only document.
16401615

1641-
<dt><dfn id=auto>auto</dfn>
1616+
<dt><dfn id=use-glyph-orientation>use-glyph-orientation</dfn>
16421617

16431618
<dd>
16441619
<p><a href="#SVG11" rel=biblioentry>[SVG11]<!--{{!SVG11}}--></a> defines
@@ -1647,20 +1622,24 @@ <h3 id=text-orientation><span class=secno>5.1. </span> Orienting Text: the
16471622
properties that were intended to control text orientation. These
16481623
properties are <em>deprecated</em> and do not apply to non-SVG elements.
16491624
If an implementation supports these properties, the &lsquo;<a
1650-
href="#auto"><code class=css>auto</code></a>&rsquo; value when set on
1651-
SVG elements indicates that the SVG &lsquo;<code
1625+
href="#use-glyph-orientation"><code
1626+
class=css>use-glyph-orientation</code></a>&rsquo; value when set on SVG
1627+
elements indicates that the SVG &lsquo;<code
16521628
class=property>glyph-orientation-vertical</code>&rsquo; and &lsquo;<code
16531629
class=property>glyph-orientation-horizontal</code>&rsquo; behavior
16541630
control the layout of text. Such UAs must set &lsquo;<code
1655-
class=css>text-orientation: auto</code>&rsquo; on all <a
1631+
class=css>text-orientation: glyph-orientation</code>&rsquo; on all <a
16561632
href="http://www.w3.org/TR/SVG/intro.html#TermTextContentElement">SVG
16571633
text content elements</a> in their default UA style sheet for SVG.
16581634

16591635
<p>In all other contexts, and for implementations that do not support the
1660-
glyph orientation properties, the &lsquo;<a href="#auto"><code
1661-
class=css>auto</code></a>&rsquo; behavior is the same as for &lsquo;<a
1662-
href="#vertical-right"><code class=css>vertical-right</code></a>&rsquo;.
1663-
1636+
glyph orientation properties, the &lsquo;<a
1637+
href="#use-glyph-orientation"><code
1638+
class=css>use-glyph-orientation</code></a>&rsquo; behavior is the same
1639+
as for &lsquo;<a href="#vertical-right"><code
1640+
class=css>vertical-right</code></a>&rsquo;.
1641+
1642+
<p class=note>This value is at-risk and may be dropped during CR.
16641643
</dl>
16651644

16661645
<div class=figure> <img alt="text-orientation: vertical-right, upright,
@@ -2203,9 +2182,8 @@ <h3 id=vertical-layout><span class=secno>7.1. </span> Principles of Layout
22032182
class=property>margin-left</code>&rsquo; and &lsquo;<code
22042183
class=property>margin-right</code>&rsquo; would collapse with margins
22052184
before (on the right) and after (on the left) the table, respectively,
2206-
and if the table had &lsquo;<a href="#auto"><code
2207-
class=css>auto</code></a>&rsquo; values for &lsquo;<code
2208-
class=property>margin-top</code>&rsquo; and &lsquo;<code
2185+
and if the table had &lsquo;<code class=css>auto</code>&rsquo; values for
2186+
&lsquo;<code class=property>margin-top</code>&rsquo; and &lsquo;<code
22092187
class=property>margin-bottom</code>&rsquo; it would be centered
22102188
vertically within its block flow.
22112189

@@ -2338,9 +2316,8 @@ <h3 id=orthogonal-flows><span class=secno>7.3. </span> Orthogonal Flows</h3>
23382316

23392317
<p>It is common in CSS for a containing block to have a defined measure,
23402318
but not a defined extent. This typically happens in CSS2.1 when a
2341-
containing block has an &lsquo;<a href="#auto"><code
2342-
class=css>auto</code></a>&rsquo; height, for example: its width is given
2343-
by the calculations in <a
2319+
containing block has an &lsquo;<code class=css>auto</code>&rsquo; height,
2320+
for example: its width is given by the calculations in <a
23442321
href="http://www.w3.org/TR/CSS21/visudet.html#blockwidth">10.3.3</a>, but
23452322
its extent depends on its contents. In such cases the <dfn
23462323
id=available-measure>available measure</dfn> is defined as the measure of
@@ -2360,23 +2337,23 @@ <h4 id=orthogonal-auto><span class=secno>7.3.1. </span> Auto-sizing in
23602337
Orthogonal Flows</h4>
23612338

23622339
<p>If the computed measure of an element establishing an orthogonal flow is
2363-
&lsquo;<a href="#auto"><code class=css>auto</code></a>&rsquo;, then the
2364-
used measure is calculated as the <a
2365-
href="#fit-content"><i>fit-content</i></a> (shrink-to-fit) size using the
2366-
initial containing block's size as the available measure.
2340+
&lsquo;<code class=css>auto</code>&rsquo;, then the used measure is
2341+
calculated as the <a href="#fit-content"><i>fit-content</i></a>
2342+
(shrink-to-fit) size using the initial containing block's size as the
2343+
available measure.
23672344

23682345
<h4 id=orthogonal-multicol><span class=secno>7.3.2. </span> Multi-column
23692346
Layout in Orthogonal Flows</h4>
23702347

23712348
<p>If the UA supports CSS Multi-column Layout <a href="#CSS3COL"
23722349
rel=biblioentry>[CSS3COL]<!--{{!CSS3COL}}--></a>, then for the case where
23732350
the element's extent or available extent is defined but the element's
2374-
measure is &lsquo;<a href="#auto"><code class=css>auto</code></a>&rsquo;:
2351+
measure is &lsquo;<code class=css>auto</code>&rsquo;:
23752352

23762353
<ol>
23772354
<li>If &lsquo;<code class=property>column-count</code>&rsquo; and
2378-
&lsquo;<code class=property>column-width</code>&rsquo; are both &lsquo;<a
2379-
href="#auto"><code class=css>auto</code></a>&rsquo;, a used &lsquo;<code
2355+
&lsquo;<code class=property>column-width</code>&rsquo; are both
2356+
&lsquo;<code class=css>auto</code>&rsquo;, a used &lsquo;<code
23802357
class=property>column-width</code>&rsquo; is calculated for the element
23812358
as the <a href="#fill-available-measure"><i>fill-available
23822359
measure</i></a> using the <a href="#fallback-measure"><i>fallback
@@ -3309,9 +3286,8 @@ <h2 class=no-num id=intrinsic-sizing>Appendix D: Intrinsic Dimensions</h2>
33093286

33103287
<p>For replaced elements, the <a href="#min-content"><i>min-content</i></a>
33113288
and <a href="#max-content"><i>max-content</i></a> sizes are the same and
3312-
correspond used size of the replaced element according to the &lsquo;<a
3313-
href="#auto"><code class=css>auto</code></a>&rsquo; width and height
3314-
calculations.
3289+
correspond used size of the replaced element according to the &lsquo;<code
3290+
class=css>auto</code>&rsquo; width and height calculations.
33153291

33163292
<h3 class=no-num id=multicol-intrinsic> Intrinsic Sizes in Multi-column
33173293
Layout</h3>
@@ -3717,7 +3693,7 @@ <h2 class=no-num id=property-index> Property Index</h2>
37173693
<td><a class=property href="#text-orientation0">text-orientation</a>
37183694

37193695
<td>vertical-right | upright | sideways-right | sideways-left | sideways
3720-
| auto
3696+
| use-glyph-orientation
37213697

37223698
<td>vertical-right
37233699

css3-writing-modes/Overview.src.html

Lines changed: 11 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -920,26 +920,6 @@ <h3 id="text-baselines">
920920
detail and allow the choice of other dominant baselines and alignment
921921
options.</p>
922922

923-
<h4 id="opentype-baselines">
924-
Baselines in TrueType/OpenType fonts</h4>
925-
926-
<p><em>This section is non-normative.</em></p>
927-
928-
<p>The alphabetic baseline is listed as the <var>romn</var>
929-
baseline in TrueType/OpenType baseline tables. If missing, it can
930-
sometimes be computed from the ascender and descender metrics. If it
931-
cannot be computed from other metrics, it may be assumed to correspond
932-
to the zero coordinate.</p>
933-
934-
<p>For the ascender and descender metrics, it is recommended to use the
935-
<var>sTypoAscender</var> and <var>sTypoDescender</var> metrics from the
936-
font's OS/2 table. These should match the <var>idtp</var> and <var>ideo</var>
937-
baselines (respectively), which, if present, may be used instead. In the
938-
absence of these metrics, the <var>Ascent</var> and <var>Descent</var>
939-
metrics from the HHEA/VHEA table should be used. The Win metrics can be
940-
used as a fallback; however these are intended as clipping bounds and
941-
are not always appropriate for use as em box measurements.</em>
942-
943923
<h3 id="replaced-baselines">
944924
Atomic Inline Baselines</h3>
945925

@@ -1085,7 +1065,8 @@ <h3 id="text-orientation">
10851065
</tr>
10861066
<tr>
10871067
<th>Value:</th>
1088-
<td>vertical-right | upright | sideways-right | sideways-left | sideways | auto</td>
1068+
<td>vertical-right | upright | sideways-right | sideways-left | sideways
1069+
| use-glyph-orientation
10891070
</tr>
10901071
<tr>
10911072
<th>Initial:</th>
@@ -1178,20 +1159,22 @@ <h3 id="text-orientation">
11781159
writing mode and equivalent to ''sideways-left'' in ''vertical-lr''
11791160
writing mode. It can be useful when setting horizontal script text
11801161
vertically in a primarily horizontal-only document.
1181-
<dt><dfn>auto</dfn></dt>
1162+
<dt><dfn>use-glyph-orientation</dfn></dt>
11821163
<dd><p>[[!SVG11]] defines 'glyph-orientation-vertical' and
11831164
'glyph-orientation-horizontal' properties that were intended to control
11841165
text orientation. These properties are <em>deprecated</em> and do not
11851166
apply to non-SVG elements. If an implementation supports these properties,
1186-
the ''auto'' value when set on SVG elements indicates that the SVG
1187-
'glyph-orientation-vertical' and 'glyph-orientation-horizontal' behavior
1188-
control the layout of text. Such UAs must set ''text-orientation: auto''
1189-
on all
1167+
the ''use-glyph-orientation'' value when set on SVG elements indicates
1168+
that the SVG
1169+
'glyph-orientation-vertical' and 'glyph-orientation-horizontal'
1170+
behavior control the layout of text. Such UAs must set
1171+
''text-orientation: glyph-orientation'' on all
11901172
<a href="http://www.w3.org/TR/SVG/intro.html#TermTextContentElement">SVG
11911173
text content elements</a> in their default UA style sheet for SVG.
11921174
<p>In all other contexts, and for implementations that do not support
1193-
the glyph orientation properties, the ''auto'' behavior is the same
1194-
as for ''vertical-right''.
1175+
the glyph orientation properties, the ''use-glyph-orientation'' behavior
1176+
is the same as for ''vertical-right''.
1177+
<p class="note">This value is at-risk and may be dropped during CR.
11951178
</dl>
11961179

11971180
<div class="figure">

0 commit comments

Comments
 (0)