Use consistant capitalization for "user agent"

Also checks in a little script that helps in doing this
semi-automatically.

Author: frivoal

bin/ua-capitalization.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# This script automates a large part of making sure "user agent" is written in lower case.
+# Doing so is backed by the CSS-WG resolution recorded at https://logs.csswg.org/irc.w3.org/css/2021-04-08/#e1402191
+# After this script has run,
+# there can remain a few instances of the term being used.
+# Those will have to be fixed manually.
+# Run frequently to avoid cruft piling up.
+for FILE in "$@"
+do
+	sed -i -e "s/\([a-zA-Z,;]\) User Agent/\1 user agent/"\
+	    -e "s/Note: User Agent/Note: User agent/"\
+	    -e "s/\. User Agent/. User agent/" $FILE
+done
+echo "Remaining instances of 'User Agent':"
+grep -R "User Agent" $@

css-2017/Overview.bs

@@ -431,7 +431,7 @@ CSS Profiles</h3>
 
 	In the past, the Working Group published a few Profiles,
 	which were meant to define the minimal subset of CSS
-	that various classes of User Agents were expected to support.
+	that various classes of user agents were expected to support.
 
 	This effort has been discontinued,
 	as the Working Group was not finding it effective or useful,

css-2018/Overview.bs

@@ -459,7 +459,7 @@ CSS Profiles</h3>
 
 	In the past, the Working Group published a few Profiles,
 	which were meant to define the minimal subset of CSS
-	that various classes of User Agents were expected to support.
+	that various classes of user agents were expected to support.
 
 	This effort has been discontinued,
 	as the Working Group was not finding it effective or useful,

css-2020/Overview.bs

@@ -525,7 +525,7 @@ CSS Profiles</h3>
 
 	In the past, the Working Group published a few Profiles,
 	which were meant to define the minimal subset of CSS
-	that various classes of User Agents were expected to support.
+	that various classes of user agents were expected to support.
 
 	This effort has been discontinued,
 	as the Working Group was not finding it effective or useful,

css-backgrounds-3/Overview.bs

@@ -2972,7 +2972,7 @@ module.
 
 <dl>
 <dt><dfn>UA</dfn>
-<dt><dfn id="user-agent">User Agent</dfn>
+<dt><dfn id="user-agent">user agent</dfn>
 <dd>
 <p>A program that reads and/or writes CSS style sheets on behalf of a
 user in either or both of these categories: programs whose purpose is

css-break-3/Overview.bs

@@ -273,7 +273,7 @@ Breaks Between Boxes: the 'break-before' and 'break-after' properties</h3>
 
   <p>
     Values for 'break-before' and 'break-after' are defined in the sub-sections below.
-    User Agents must apply these properties to boxes in the normal flow of the <a>fragmentation root</a>.
+    User agents must apply these properties to boxes in the normal flow of the <a>fragmentation root</a>.
     User agents should also apply these properties to floated boxes
     whose containing block is in the normal flow of the root fragmented element.
     User agents may also apply these properties to other boxes.

css-break-4/Overview.bs

@@ -265,7 +265,7 @@ Breaks Between Boxes: the 'break-before' and 'break-after' properties</h3>
 	indicate that content should be kept together.
 
 	Values for 'break-before' and 'break-after' are defined in the sub-sections below.
-	User Agents must apply these properties to boxes in the normal flow of the <a>fragmentation root</a>.
+	User agents must apply these properties to boxes in the normal flow of the <a>fragmentation root</a>.
 	User agents should also apply these properties to floated boxes
 	whose containing block is in the normal flow of the root fragmented element.
 	User agents may also apply these properties to other boxes.

css-contain-1/Overview.bs

@@ -50,7 +50,7 @@ spec:css-sizing-3; type:value; for:width; text:max-content
 <h2 id='intro'>
 Introduction</h2>
 
-	Efficiently rendering a website relies on the User Agent being able to detect what parts of the page are being displayed,
+	Efficiently rendering a website relies on the user agent being able to detect what parts of the page are being displayed,
 	which parts might affect the currently-displayed section,
 	and what can be ignored.
 
@@ -126,7 +126,7 @@ Strong Containment: the 'contain' property</h2>
 	contain-flexbox-outline.html
 	</wpt>
 
-	<p class=all-media>User Agents are expected to support this property on all media, including non-visual ones.</p>
+	<p class=all-media>User agents are expected to support this property on all media, including non-visual ones.</p>
 
 	The 'contain' property allows an author to indicate that an element and its contents are,
 	as much as possible,

css-contain-2/Overview.bs

@@ -57,7 +57,7 @@ spec:css-sizing-3; type:value; for:width; text:max-content
 <h2 id='intro'>
 Introduction</h2>
 
-	Efficiently rendering a website relies on the User Agent being able to detect what parts of the page are being displayed,
+	Efficiently rendering a website relies on the user agent being able to detect what parts of the page are being displayed,
 	which parts might affect the currently-displayed section,
 	and what can be ignored.
 
@@ -125,7 +125,7 @@ Strong Containment: the 'contain' property</h2>
 	contain-flexbox-outline.html
 	</wpt>
 
-	<p class=all-media>User Agents are expected to support this property on all media, including non-visual ones.</p>
+	<p class=all-media>User agents are expected to support this property on all media, including non-visual ones.</p>
 
 	The 'contain' property allows an author to indicate that an element and its contents are,
 	as much as possible,

css-content-3/Overview.bs

@@ -107,7 +107,7 @@ Inserting and replacing content with the 'content' property</h2>
 		Animation type: discrete
 	</pre>
 
-	<p class=all-media>User Agents are expected to support this property on all media, including non-visual ones.</p>
+	<p class=all-media>User agents are expected to support this property on all media, including non-visual ones.</p>
 
 	The 'content' property dictates what is rendered inside an element or pseudo-element.
 
@@ -395,7 +395,7 @@ Specifying quotes with the 'quotes' property</h4>
 		Animation type: discrete
 	</pre>
 
-	<p class=all-media>User Agents are expected to support this property on all media, including non-visual ones.</p>
+	<p class=all-media>User agents are expected to support this property on all media, including non-visual ones.</p>
 
 	This property specifies quotation marks for any number of embedded quotations. Values have the following meanings:
 
@@ -965,7 +965,7 @@ The string-set property</h4>
 	Animation type: discrete
 	</pre>
 
-	<p class=all-media>User Agents are expected to support this property on all media, including non-visual ones.</p>
+	<p class=all-media>User agents are expected to support this property on all media, including non-visual ones.</p>
 
 	The 'string-set' property copies the text content of an element into a ''named string'',
 	which functions as a variable.

css-counter-styles-3/Overview.bs

@@ -1750,7 +1750,7 @@ Symbolic: ''disc'', ''circle'', ''square'', ''disclosure-open'', ''disclosure-cl
 	</dl>
 
 	The ''disc'' counter-style must not be overridable with a ''@counter-style'' rule,
-	so that the initial value of 'list-style-type' is well-known to the User Agent.
+	so that the initial value of 'list-style-type' is well-known to the user agent.
 
 	The following stylesheet fragment provides the normative definition of these predefined counter styles:
 

css-display-3/Overview.bs

@@ -210,7 +210,7 @@ Box Layout Modes: the 'display' property</h2>
 	Animation type:	not animatable
 	</pre>
 
-	<p class=all-media>User Agents are expected to support this property on all media, including non-visual ones.</p>
+	<p class=all-media>User agents are expected to support this property on all media, including non-visual ones.</p>
 
 	The 'display' property defines an element's <dfn export>display type</dfn>,
 	which consists of the two basic qualities of how an element generates boxes:
@@ -760,7 +760,7 @@ Toggling Box Generation: the 'display-or-not' property</h2>
 	Computed value: as specified
 	</pre>
 
-	<p class=all-media>User Agents are expected to support this property on all media, including non-visual ones.</p>
+	<p class=all-media>User agents are expected to support this property on all media, including non-visual ones.</p>
 
 	The ''display: none'' value was historically used as a "toggle"
 	to switch between showing and hiding an element.

css-env-1/Overview.bs

@@ -8,7 +8,7 @@ Group: CSSWG
 URL: https://drafts.csswg.org/css-env-1/
 Editor: Tab Atkins-Bittner, Google, w3cid 42199
 Editor: Dean Jackson, Apple, w3cid 42080
-Abstract: This specification defines the concept of [=environment variables=] and the ''env()'' function, which work similarly to custom properties and the ''var()'' function, but are defined globally for a document. These can be defined either by the User Agent, providing values that can be used on the page based on information the UA has special access to, or provided by the author for "global" variables that are guaranteed to be the same no matter where in the document they're used.
+Abstract: This specification defines the concept of [=environment variables=] and the ''env()'' function, which work similarly to custom properties and the ''var()'' function, but are defined globally for a document. These can be defined either by the user agent, providing values that can be used on the page based on information the UA has special access to, or provided by the author for "global" variables that are guaranteed to be the same no matter where in the document they're used.
 </pre>
 
 <pre class=link-defaults>
@@ -46,7 +46,7 @@ These "global" variables have both benefits and downsides versus cascading varia
 	they can be used in places where there is no obvious element to draw from,
 	such as in ''@media'' rules,
 	where the ''var()'' function would not be valid.
-* Information from the User Agent itself,
+* Information from the user agent itself,
 	such as the margin of the viewport to avoid laying out in by default
 	(for example, to avoid overlapping a "notch" in the screen),
 	can be retrieved via ''env()'',
@@ -58,7 +58,7 @@ Environment Variables {#environment}
 A CSS <dfn for=CSS>environment variable</dfn> is a name associated with a <<declaration-value>>
 (a sequence of zero more CSS tokens, with almost no restrictions on what tokens can exist),
 similar to a [=custom property=].
-[=Environment variables=] can be defined by the User Agent,
+[=Environment variables=] can be defined by the user agent,
 or by the user.
 (In the latter case, the names are <<custom-property-name>>s,
 and start with `--` per standard for custom identifiers.)

css-flexbox-1/Overview.bs

@@ -4516,7 +4516,7 @@ Substantive Changes and Bugfixes</h4>
 						<li>their own axis (left/right percentages resolve against width, top/bottom resolve against height), or,
 						<li>the inline axis (left/right/top/bottom percentages all resolve against width)
 					</ul>
-					<p>A User Agent must choose one of these two behaviors.</p>
+					<p>A user agent must choose one of these two behaviors.</p>
 
 					<p class="note">Note: This variance sucks, but it accurately captures the current state of the world
 					(no consensus among implementations, and no consensus within the CSSWG).