[css-color-adjust-1] Per WG resolution, rename 'color-adjust' to 'print-color-adjust'; re-add 'color-adjust' as alias (shorthand). w3c#3880

Author: tabatkins

css-color-adjust-1/Overview.bs

@@ -39,7 +39,7 @@ Introduction {#intro}
 		and the 'forced-color-adjust' property,
 		which controls whether or not [=forced colors mode=] is allowed to apply to a given element.
 
-	* The 'color-adjust' property,
+	* The 'print-color-adjust' property,
 		which controls whether the browser is allowed
 		to automatically adjust colors to the user's assumed performance preferences,
 		such as suppressing background colors when printing to save ink.
@@ -533,8 +533,6 @@ Opting Out of a Forced Color Scheme: the 'forced-color-adjust' property {#forced
 			for those elements.
 	</dl>
 
-	ISSUE: Should this property be merged with 'color-adjust' somehow?
-
 	In order to not break SVG content,
 	UAs are expected to add the following rules to their UA style sheet:
 
@@ -554,7 +552,7 @@ Opting Out of a Forced Color Scheme: the 'forced-color-adjust' property {#forced
  ██████   ███████  ████████  ███████  ██     ██         ██     ██ ████████   ██████   ███████   ██████     ██
 -->
 
-Performance-based Color Adjustments: the 'color-adjust' property {#perf}
+Performance-based Color Adjustments {#perf}
 ===================================
 
 	On most monitors,
@@ -582,10 +580,13 @@ Performance-based Color Adjustments: the 'color-adjust' property {#perf}
 	and to accommodate what they assume the user would prefer.
 	However, in some cases the document may be using colors in important, well-thought-out ways that the user would appreciate,
 	and so the document would like some way to hint to the user agent that it might want to respect the page's color choices.
-	The 'color-adjust' property controls this.
+	This section defines properties for controlling these automatic adjustments.
+
+Ink Economy: the 'print-color-adjust' property {#print-color-adjust}
+----------------------------------------------
 
 	<pre class='propdef'>
-	Name: color-adjust
+	Name: print-color-adjust
 	Value: economy | exact
 	Initial: economy
 	Applies to: all elements
@@ -595,15 +596,16 @@ Performance-based Color Adjustments: the 'color-adjust' property {#perf}
 	Animation type: discrete
 	</pre>
 
-	The 'color-adjust' property provides a hint to the user-agent about how it should treat color and style choices
-	that might be expensive or generally unwise on a given device,
-	such as using light text on a dark background in a printed document.
+	The 'print-color-adjust' property provides a hint to the user-agent
+	about how it should treat color and style choices
+	that might be expensive or generally unwise on a printer or similar device,
+	such as using light text on a dark background.
 	If user agents allow users to control this aspect of the document's display,
 	the user preference <strong>must</strong> be respected more strongly
-	than the hint provided by 'color-adjust'.
+	than the hint provided by 'print-color-adjust'.
 	It has the following values:
 
-	<dl dfn-type=value dfn-for=color-adjust>
+	<dl dfn-type=value dfn-for=print-color-adjust>
 		<dt><dfn>economy</dfn>
 		<dd>
 			The user agent should make adjustments to the page's styling
@@ -629,6 +631,27 @@ Performance-based Color Adjustments: the 'color-adjust' property {#perf}
 			when distracted in a car.
 	</dl>
 
+The 'color-adjust' Shorthand {#color-adjust}
+--------------------------------------------
+
+	<pre class="propdef shorthand">
+	Name: color-adjust
+	Value: <'print-color-adjust'>
+	</pre>
+
+	The 'color-adjust' shorthand allows an author
+	to set all of the performance-motivated color adjustment properties
+	in one declaration.
+	(Currently, there is only one such property--
+	'print-color-adjust'--
+	but more might be added in the future.)
+
+	Advisement: The 'color-adjust' shorthand is currently <em>deprecated</em>.
+	Authors should use the more specific 'print-color-adjust' property,
+	to avoid accidentally resetting performance-based color adjustments
+	in other contexts than the one intended.
+
+
 Privacy and Security Considerations {#priv-sec}
 ===================================