diff --git a/css-shapes-2/Overview.bs b/css-shapes-2/Overview.bs
index 7754e70e087..91b8cdd852e 100644
--- a/css-shapes-2/Overview.bs
+++ b/css-shapes-2/Overview.bs
@@ -18,6 +18,9 @@ spec:css-masking-1; type: value
text: nonzero
text: evenodd
spec:css-shapes-1; type:property; text:shape-margin
+spec:css-shapes-2; type:type; text:
+spec:css-writing-modes-4; type:concept; text:physical
+spec:css-writing-modes-4; type:concept; text:"writing mode"
@@ -165,6 +168,79 @@ Supported Shapes
in the path string.
For the initial direction follow SVG 1.1.
+
+
+ shape() = shape( [<>]? from <>, <>#)
+
+
+
+ -
+ The <> represents the starting point for the first draw-command,
+ in physical coordinates.
+
-
+ The sequence of <>s represent commands of an
+ SVG Path.
+
+
+
+ The arguments not defined above are defined as follows:
+
+
+ - <> = <>{2}
+
- Defines a pair of coordinates x & y.
+
+
- <> = <> | <> | <> |
+ <> | <> | <> | close
+
-
+ Defines a single draw command, equivalent to an SVG draw command.
+
- <> = by | to
+
-
+ Represents the reference from which offsets are computed in <>s.
+ When ''to'' is present, the coordinates are relative to the top-left origin of the reference box.
+ Otherwise ''by'' is present, the coordinates are relative to the end position of the previous command.
+
+ Note:
+ <> values are always computed relative to the reference box regardless of how offsets are computed.
+
-
+
+
- <> = move <> <>
+
-
+ Corresponds to a moveto command.
+
- <> = line <> <>
+
-
+ Corresponds to a lineto command.
+ If '''x''' or '''y''' are present instead of a <>, the line will be horizontal or vertical, respectively.
+
- <> = [hline | vline] <> <>
+
-
+ Corresponds to a horizontal or vertical lineto command.
+
- <> = curve <> <> via <>{1,2}
+
-
+ Corresponds to a quadratic curve command if one <> is provided,
+ otherwise corresponds to a cubic curve command.
+
- <> = smooth <> <> [via <>]?
+
-
+ Corresponds to a smooth cubic curve command if a second <> is provided,
+ otherwise corresponds to a smooth quadratic curve command.
+
- <> = arc [<> <> <> || <> || <> || <>]
+
-
+ Corresponds to an arc command.
+
- <> = of <>{1, 2}
+
-
+ Corresponds to the arc's radius.
+ If only one <> is present, that value will be used for both '''rx''' and '''ry'''.
+
- <> = [cw | ccw]?
+
-
+ If ''ccw'' is set, the arc's sweep flag is set to 0.
+ If ''cw'' is set, the arc's sweep flag is set to 1.
+ If it is not set, the automatic value is used.
+
- <> = [large | small]?
+
-
+ If ''large'' is set, the arc's large flag is set to 1.
+ If ''small'' is set, the arc's large flag is set to 0.
+ If it is not set, the automatic value is used.
+
- close
+
-
+ Corrsepponds to a closepath command.