[css-font-loading] Fix Bikeshed errors, including adding a privacy & security considerations section.

Author: tabatkins

css-font-loading-3/Overview.bs

@@ -203,14 +203,7 @@ The Constructor</h3>
 	from a URL pointing to a font face file,
 	or from an {{ArrayBuffer}} (or {{ArrayBufferView}}) containing the binary representation of a font face.
 
-	When the <dfn constructor lt='FontFace()' for=FontFace>FontFace</dfn>(
-	<span dfn-for="FontFace/FontFace(family, source, descriptors)">
-		CSSOMString <dfn argument>family</dfn>,
-		(CSSOMString or {{/BinaryData}}) <dfn argument>source</dfn>,
-		{{/FontFaceDescriptors}} <dfn argument>descriptors</dfn>
-	</span>
-	)
-	method is called,
+	When the <dfn constructor for=FontFace>FontFace(family, source, descriptors)</dfn> method is called,
 	execute these steps:
 
 	1. Let <var>font face</var> be a fresh {{FontFace}} object.
@@ -490,10 +483,10 @@ The <code>FontFaceSet</code> Interface</h2>
 
 			See [[#font-face-set-ready]] for more details on this {{Promise}} and its use.
 
-		: <dfn constructor lt="FontFaceSet()">FontFaceSet</dfn>(sequence&lt;{{FontFace}}> <dfn argument for="FontFaceSet/FontFaceSet()">initialFaces</dfn>)
+		: <dfn constructor>FontFaceSet(initialFaces)</dfn>
 		:: The {{FontFaceSet}} constructor, when called,
 			must iterate its {{initialFaces}} argument
-			and add each value to its <a>set entries</a>.
+			and add each value to its [=FontFaceSet/set entries=].
 
 		: <dfn dfn>iteration order</dfn>
 		:: When iterated over,
@@ -513,12 +506,12 @@ The <code>FontFaceSet</code> Interface</h2>
 			When the {{add()}} method is called,
 			execute the following steps:
 
-			1. If <var>font</var> is already in the {{FontFaceSet}}’s <a>set entries</a>,
+			1. If <var>font</var> is already in the {{FontFaceSet}}’s [=FontFaceSet/set entries=],
 				skip to the last step of this algorithm immediately.
 			2. If <var>font</var> is <a>CSS-connected</a>,
 				throw an {{InvalidModificationError}} exception
 				and exit this algorithm immediately.
-			3. Add the <var>font</var> argument to the {{FontFaceSet}}’s <a>set entries</a>.
+			3. Add the <var>font</var> argument to the {{FontFaceSet}}’s [=FontFaceSet/set entries=].
 			2. If <var>font</var>’s {{FontFace/status}} attribute is "loading":
 				1. If the {{FontFaceSet}}’s {{[[LoadingFonts]]}} list is empty,
 					<a>switch the FontFaceSet to loading</a>.
@@ -533,7 +526,7 @@ The <code>FontFaceSet</code> Interface</h2>
 			1. If <var>font</var> is <a>CSS-connected</a>,
 				return <code class='lang-javascript'>false</code>
 				and exit this algorithm immediately.
-			2. Let <var>deleted</var> be the result of removing <var>font</var> from the {{FontFaceSet}}’s <a>set entries</a>.
+			2. Let <var>deleted</var> be the result of removing <var>font</var> from the {{FontFaceSet}}’s [=FontFaceSet/set entries=].
 			3. If <var>font</var> is present in the {{FontFaceSet}}’s {{[[LoadedFonts]]}}, or {{[[FailedFonts]]}} lists,
 				remove it.
 			4. If <var>font</var> is present in the {{FontFaceSet}}’s {{[[LoadingFonts]]}} list,
@@ -548,7 +541,7 @@ The <code>FontFaceSet</code> Interface</h2>
 			When the {{clear()}} method is called,
 			execute the following steps:
 
-			1. Remove all items from the {{FontFaceSet}}’s <a>set entries</a>,
+			1. Remove all items from the {{FontFaceSet}}’s [=FontFaceSet/set entries=],
 				its {{[[LoadedFonts]]}} list,
 				and its {{[[FailedFonts]]}} list.
 			2. If the {{FontFaceSet}}’s {{[[LoadingFonts]]}} list is non-empty,
@@ -617,7 +610,7 @@ Events</h3>
 		<tbody>
 			<tr>
 				<th>{{onloading}}
-				<td>{{loading}}
+				<td>{{loading!!event}}
 			<tr>
 				<th>{{onloadingdone}}
 				<td>{{loadingdone}}
@@ -654,7 +647,7 @@ Events</h3>
 			replace it with a fresh pending promise.
 
 		<li>
-			Queue a task to <a>fire a font load event</a> named {{loading}} at <var>font face set</var>.
+			Queue a task to <a>fire a font load event</a> named {{loading!!event}} at <var>font face set</var>.
 	</ol>
 
 	When asked to <dfn>switch the FontFaceSet to loaded</dfn> for a given {{FontFaceSet}},
@@ -1031,7 +1024,7 @@ Worker FontFaceSources</h3>
 <h3 id="document-font-face-set">
 Interaction with CSS’s ''@font-face'' Rule</h3>
 
-	The set entries for a document's <a>font source</a>
+	The [=FontFaceSet/set entries=] for a document's <a>font source</a>
 	must be initially populated with all the <a>CSS-connected</a> {{FontFace}} objects
 	from all of the CSS ''@font-face'' rules in the document's stylesheets,
 	in document order.
@@ -1176,3 +1169,13 @@ Acknowledgments</h2>
 
 	Several members of the Google Fonts team provided helpful feedback on font load events,
 	as did Boris Zbarsky, Jonas Sicking and ms2ger.
+
+<h2 class=no-num id=priv-sec>
+Privacy & Security Considerations</h2>
+
+	The {{FontFaceSet}} object leaks information about the user's installed fonts,
+	but in the exact same way as the existing ''@font-face'' rule;
+	no new information is leaked,
+	or in any appreciable easier manner.
+
+	This specification introduces no new security considerations.