diff --git a/css-sizing-3/Overview.bs b/css-sizing-3/Overview.bs
index 4ffa28be7e8..e8583d2fad3 100644
--- a/css-sizing-3/Overview.bs
+++ b/css-sizing-3/Overview.bs
@@ -53,6 +53,8 @@ Module interactions
This module extends the 'width', 'height', 'min-width', 'min-height', 'max-width', 'max-height', and 'column-width'
features defined in [[!CSS2]] chapter 10 and in [[!CSS3COL]]
+
The definition of the 'box-sizing' property in module supersedes the one in [[CSS-UI-3]].
+
Values
@@ -508,7 +510,7 @@ Containing or Excluding Floats
████████ ███████ ██ ██ ██████ ████ ████████ ████ ██ ██ ██████
-->
-
+
Box Edges for Sizing: the 'box-sizing' property
@@ -620,22 +622,67 @@ Box Edges for Sizing: the 'box-sizing' property
+
+ This example uses box-sizing to evenly horizontally split
+ two divs with fixed size borders inside a div container,
+ which would otherwise require additional markup.
+
+ sample CSS:
+
+ div.container {
+ width:38em;
+ border:1em solid black;
+ }
+
+ div.split {
+ box-sizing:border-box;
+ width:50%;
+ border:1em silver ridge;
+ float:left;
+ }
+
+
+ sample HTML fragment:
+
+ <div class="container">
+ <div class="split">This div occupies the left half.</div>
+ <div class="split">This div occupies the right half.</div>
+ </div>
+
+
+ demonstration of sample CSS and HTML:
+
This div should occupy the left half.
This div should occupy the right half.
The two divs above should appear side by side, each (including borders) 50% of the content width of their container. If instead they are stacked one on top of the other then your browser does not support 'box-sizing'.
+
+
Note: Certain HTML elements,
such as <{button}>,
default to ''border-box'' behavior.
See HTML for details on which elements have this behavior.
- In the CSS specifications,
+ In legacy CSS specifications,
the terms width, height,
minimum (min) width,
minimum (min) height,
maximum (max) width, and
maximum (max) height
- refer to the inner size
+ generally refer to the inner size
(content-box size)
of a box
unless otherwise indicated.
+ Refer to [[CSS-UI-3#box-sizing]] for an explicit disambiguation of these terms
+ for the Visual formatting model details section of [[CSS2]].
+
+ To avoid ambiguities,
+ specification authors should avoid ambiguous uses of terms such as width or height without further qualification,
+ and should explicitely refer and link to
+ the
inner size,
+ the
outer size,
+ the size of the
border-box,
+ the
computed value of the
sizing properties,
+ etc,
+ as appropriate for each case.
+