[css-font-load-events] Use the Promise hooks wording, add issues about what I plan to do with the promise values.

--HG--
extra : rebase_source : 29fa24075838487710abd9fab69f70087032a27e

Author: tabatkins

css-font-load-events/Overview.html

@@ -68,7 +68,7 @@
 </a></p>
   <h1 class="p-name no-ref" id=title>CSS Font Load Events Module Level 3</h1>
   <h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
-    <span class=dt-updated><span class=value-title title=20130902>2 September 2013</span></span></span></h2>
+    <span class=dt-updated><span class=value-title title=20130903>3 September 2013</span></span></span></h2>
   <div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/css-font-load-events/>http://dev.w3.org/csswg/css-font-load-events/</a><dt>Latest version:<dd><a href=http://www.w3.org/TR/css-font-load-events-3/>http://www.w3.org/TR/css-font-load-events-3/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/css-font-load-events/>http://dev.w3.org/csswg/css-font-load-events/</a>
 <dt>Feedback:</dt>
     <dd><a href="mailto:www-style@w3.org?subject=%5Bcss-font-load-events%5D%20feedback">www-style@w3.org</a>
@@ -420,6 +420,9 @@ <h5 class="heading settled heading" data-level=2.2.2.1 id=loadfont-method><span
 			If the <var>font load list</var> contains no font faces,
 			reject the promise with XXX.
 
+			<p class=issue id=issue-a2eabc2d><a class=self-link href=#issue-a2eabc2d></a>
+				DOMError?  Need to chat with Anne and others about idiomatic way to do errors.
+
 		<li>
 			For all of the font faces in the <var>font load list</var>, initiate the load of any font that has
 			not already been loaded and return.
@@ -428,11 +431,16 @@ <h5 class="heading settled heading" data-level=2.2.2.1 id=loadfont-method><span
 			When all fonts in the <var>font load list</var> have been loaded, 
 			resolve the promise appropriately.
 			If all fonts loaded successfully, 
-			accept the promise with XXX.
+			fulfill the promise with XXX.
 
 			<p>
 				If an error occurred with any one of the fonts in the <var>font load list</var>,
 				reject the promise with XXX.
+
+			<p class=issue id=issue-290a86ee><a class=self-link href=#issue-290a86ee></a>
+				When I define Font objects, and give them load() and ready() methods,
+				I want to define this as simply adopting a Promise.every() of all the font ready promises.
+				The fulfill/reject values then come out automatically.
 	</ol>
 
 <h5 class="heading settled heading" data-level=2.2.2.2 id=checkfont-method><span class=secno>2.2.2.2 </span><span class=content>
@@ -487,7 +495,7 @@ <h5 class="heading settled heading" data-level=2.2.2.3 id=ready-method><span cla
 	before examining content which may be affected by loading fonts.
 
 <p>	Let <var>font loader</var> be the value of the <a class=idl-code data-link-type=attribute href=#dom-document-fontloader>fontloader</a> attribute of <var>doc</var>.
-	The <var>font loader</var> contains a <dfn data-dfn-type=dfn data-export="" id=font-readiness-promise>font readiness promise<a class=self-link href=#font-readiness-promise></a></dfn>,
+	The <var>font loader</var> contains an internal <dfn data-dfn-type=dfn data-export="" id=font-readiness-promise>font readiness promise<a class=self-link href=#font-readiness-promise></a></dfn>,
 	which is initially set to a fresh pending Promise.
 	If, after the document has finished loading and completed its initial layout,
 	no fonts need to be loaded,
@@ -801,4 +809,11 @@ <h2 class="no-num heading settled" id=issues-index><span class=content>Issues In
 		I’m just sketching the promise terminology here.
 		Need to fill it in with the real stuff.
 
-	<a href=#issue-e86f85cf> ↵ </a></div>
+	<a href=#issue-e86f85cf> ↵ </a><p class=issue>
+				DOMError?  Need to chat with Anne and others about idiomatic way to do errors.
+
+		<a href=#issue-a2eabc2d> ↵ </a><p class=issue>
+				When I define Font objects, and give them load() and ready() methods,
+				I want to define this as simply adopting a Promise.every() of all the font ready promises.
+				The fulfill/reject values then come out automatically.
+	<a href=#issue-290a86ee> ↵ </a></div>

css-font-load-events/Overview.src.html

@@ -347,6 +347,9 @@ <h5 id='loadfont-method'>
 			If the <var>font load list</var> contains no font faces,
 			reject the promise with XXX.
 
+			<p class='issue'>
+				DOMError?  Need to chat with Anne and others about idiomatic way to do errors.
+
 		<li>
 			For all of the font faces in the <var>font load list</var>, initiate the load of any font that has
 			not already been loaded and return.
@@ -355,11 +358,16 @@ <h5 id='loadfont-method'>
 			When all fonts in the <var>font load list</var> have been loaded, 
 			resolve the promise appropriately.
 			If all fonts loaded successfully, 
-			accept the promise with XXX.
+			fulfill the promise with XXX.
 
 			<p>
 				If an error occurred with any one of the fonts in the <var>font load list</var>,
 				reject the promise with XXX.
+
+			<p class='issue'>
+				When I define Font objects, and give them load() and ready() methods,
+				I want to define this as simply adopting a Promise.every() of all the font ready promises.
+				The fulfill/reject values then come out automatically.
 	</ol>
 
 <h5 id='checkfont-method'>
@@ -414,7 +422,7 @@ <h5 id='ready-method'>
 	before examining content which may be affected by loading fonts.
 
 	Let <var>font loader</var> be the value of the <a attribute>fontloader</a> attribute of <var>doc</var>.
-	The <var>font loader</var> contains a <dfn export>font readiness promise</dfn>,
+	The <var>font loader</var> contains an internal <dfn export>font readiness promise</dfn>,
 	which is initially set to a fresh pending Promise.
 	If, after the document has finished loading and completed its initial layout,
 	no fonts need to be loaded,