diff --git a/css-display/Overview.bs b/css-display/Overview.bs
index db4c3c4d04c..1271cf01725 100644
--- a/css-display/Overview.bs
+++ b/css-display/Overview.bs
@@ -13,7 +13,7 @@ Previous Version: https://www.w3.org/TR/2015/WD-css-display-3-20150721/
Previous Version: https://www.w3.org/TR/2014/WD-css-display-3-20140911/
Editor: Tab Atkins Jr., Google, http://xanthir.com/contact/
Editor: Elika J. Etemad / fantasai, Invited Expert, http://fantasai.inkedblade.net/contact
-Abstract: This module describes how the CSS formatting box tree is generated from the document element tree and defines the 'display' and 'box-suppress' properties that control it.
+Abstract: This module describes how the CSS formatting box tree is generated from the document element tree and defines the 'display' and 'display-or-not' properties that control it.
Ignored Terms: display-model, display-role, table row group box, absolutely positioned
@@ -40,14 +40,14 @@ Introduction
(See [[!CSS3-CASCADE]].)
Then, for each element, it generates zero or more boxes
- as specified by that element's 'display' and 'box-suppress' properties.
+ as specified by that element's 'display' and 'display-or-not' properties.
Typically, an element generates a single box.
However, some 'display' values
(e.g. ''display: list-item'')
generate more than one box
(e.g. a principal block box and a marker box).
And some values
- (such as ''display:none'', ''display: contents'', and ''box-suppress: discard'')
+ (such as ''display:none'', ''display: contents'', and ''display-or-not: discard'')
cause the element and/or its descendants to not generate any boxes at all.
Boxes are assigned the same styles as their generating element, unless otherwise indicated.
They're often referred to by their 'display' type--
@@ -479,7 +479,7 @@ Box Generation: the ''none'' and ''contents'' keywords
The element and its descendants generates no boxes.
- Advisement: It is recommended that 'box-suppress' be used instead of ''display: none'',
+ Advisement: It is recommended that 'display-or-not' be used instead of ''display: none'',
so that the element's display type is automatically preserved
for when it's no longer suppressed.
@@ -553,16 +553,16 @@ Automatic Box Type Transformations
-Toggling Box Generation: the 'box-suppress' property
+Toggling Box Generation: the 'display-or-not' property
- Name: box-suppress
+ Name: display-or-not
Value: show | discard | hide
Initial: show
Applies to: all elements
Inherited: no
Percentages: n/a
- Computed value: see prose
+ Computed value: as specified
Media: all
@@ -571,16 +571,21 @@ Toggling Box Generation: the 'box-suppress' property
Making this reversible requires either setting up the CSS cascade carefully,
or remembering what the 'display' value was before it was set to ''none''.
To make this common use-case easier,
- this module introduces the separate 'box-suppress' property to do the same thing,
+ this module introduces the separate 'display-or-not' property to do the same thing,
so that toggling whether or not an element appears in the formatting tree
can now be done without affecting its display type when it is displayed.
- If the computed value of 'display' is ''none'',
- the computed value of 'box-suppress' is ''discard''.
- Otherwise, the computed value is the specified value.
+ Issue: This property (which needs a better name)
+ along with a display-type (or possibly display-as) longhand
+ which takes all values of 'display' other than ''none'',
+ are intended to be longhands of 'display'.
+ This has not yet been edited in, as this split feature is likely to be deferred to the next level
+ in order to have time to thoroughly work through and accommodate the
+ various use cases for showing/hiding an element.
+
Values have the following meanings:
-
+
- show
-
The element generates boxes as normal,