[css-font-loading] Add a definition for Promise temporarily.

Author: tabatkins

css-font-loading/Overview.bs

@@ -11,7 +11,7 @@ Editor: Tab Atkins Jr., Google, http://xanthir.com/contact/
 Former Editor: John Daggett, Mozilla, jdaggett@mozilla.com
 Abstract: This CSS module describes events and interfaces used for dynamically loading font resources.
 Link Defaults: css-fonts-3 (descriptor) src
-Ignored Terms: promise, domstring, eventinit, cssfontfacerule, eventtarget, workerglobalscope, document
+Ignored Terms: domstring, eventinit, cssfontfacerule, eventtarget, workerglobalscope, document
 </pre>
 
 <h2 id="introduction">
@@ -32,6 +32,14 @@ Introduction</h2>
 	It also provides methods to track the loading status of an individual font,
 	or of all the fonts on an entire page.
 
+<h3 id="values">
+Values</h3>
+
+	This specification uses <dfn interface title="Promise">Promises</dfn>.
+	Promises are currently defined by <a href="https://github.com/domenic/promises-unwrapping">Domenic Denicola's spec</a>,
+	but when TC39 is finished adding them to ECMAScript 6 their definition should be used instead.
+	HTML5Rocks has some <a href="http://www.html5rocks.com/en/tutorials/es6/promises/">good tutorial material introducing Promises</a>.
+
 <h2 id="fontface-interface">
 The <code>FontFace</code> Interface</h2>
 
@@ -138,7 +146,7 @@ The Constructor</h3>
 		<li>
 			Let <var>font face</var> be a fresh <a>FontFace</a> object.
 			Set <var>font face's</var> <a for=FontFace>status</a> argument to <code>"unloaded"</code>.
-			Set its internal <a>[FontStatusPromise]</a> attribute to a newly-created promise object.
+			Set its internal <a>[FontStatusPromise]</a> attribute to a newly-created <a idl>Promise</a> object.
 			Return <var>font face</var>,
 			and complete the rest of these steps asynchronously.
 
@@ -239,7 +247,7 @@ The <code>load()</code> method</h3>
 The <code>ready()</code> method</h3>
 
 	The <a method for=FontFace>ready()</a> method of <a interface>FontFace</a>
-	returns a Promise
+	returns a <a idl>Promise</a>
 	which is fulfilled when the font face is successfully loaded,
 	or rejected when the font face fails to load or parse successfully.
 
@@ -251,7 +259,7 @@ The <code>ready()</code> method</h3>
 			Let <var>font face</var> be the <a>FontFace</a> object on which this method was called.
 
 		<li>
-			Let <var>ready promise</var> be a newly-created promise object.
+			Let <var>ready promise</var> be a newly-created <a idl>Promise</a> object.
 
 		<li>
 			Resolve <var>ready promise</var> with <var>font face's</var> <a attribute>[FontStatusPromise]</a>.

css-font-loading/Overview.html

@@ -70,6 +70,8 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=status><span class=c
 <h2 class="no-num no-toc no-ref heading settled heading" id=contents><span class=content>Table of Contents</span></h2>
 <div data-fill-with=table-of-contents><ul class=toc>
 	<li><a href=#introduction><span class=secno>1</span> Introduction</a>
+		<ul class=toc>
+		<li><a href=#values><span class=secno>1.1</span> Values</a></ul>
 	<li><a href=#fontface-interface><span class=secno>2</span> The <code>FontFace</code> Interface</a>
 		<ul class=toc>
 		<li><a href=#font-face-constructor><span class=secno>2.1</span> The Constructor</a>
@@ -128,6 +130,14 @@ <h2 class="heading settled heading" data-level=1 id=introduction><span class=sec
 	It also provides methods to track the loading status of an individual font,
 	or of all the fonts on an entire page.
 
+<h3 class="heading settled heading" data-level=1.1 id=values><span class=secno>1.1 </span><span class=content>
+Values</span><a class=self-link href=#values></a></h3>
+
+<p>	This specification uses <dfn class=idl-code data-dfn-type=interface data-export="" id=dom-promise title=Promise>Promises<a class=self-link href=#dom-promise></a></dfn>.
+	Promises are currently defined by <a href=https://github.com/domenic/promises-unwrapping>Domenic Denicola’s spec</a>,
+	but when TC39 is finished adding them to ECMAScript 6 their definition should be used instead.
+	HTML5Rocks has some <a href=http://www.html5rocks.com/en/tutorials/es6/promises/>good tutorial material introducing Promises</a>.
+
 <h2 class="heading settled heading" data-level=2 id=fontface-interface><span class=secno>2 </span><span class=content>
 The <code>FontFace</code> Interface</span><a class=self-link href=#fontface-interface></a></h2>
 
@@ -167,7 +177,7 @@ <h2 class="heading settled heading" data-level=2 id=fontface-interface><span cla
 
     // Returns a promise that fulfills or rejects when the font face
     // reached "loaded" or "error" status.
-    <a data-link-type=idl title=promise>Promise</a> <a class=idl-code data-global-name="FontFace<interface>/ready()<method>" data-link-for=FontFace data-link-type=method href=#dom-fontface-ready title=ready()>ready</a>();
+    <a data-link-type=idl href=#dom-promise title=promise>Promise</a> <a class=idl-code data-global-name="FontFace<interface>/ready()<method>" data-link-for=FontFace data-link-type=method href=#dom-fontface-ready title=ready()>ready</a>();
   };
 </pre>
 	<dl data-dfn-for=FontFace data-dfn-type=attribute>
@@ -232,7 +242,7 @@ <h3 class="heading settled heading" data-level=2.1 id=font-face-constructor><spa
 		<li>
 			Let <var>font face</var> be a fresh <a data-link-type=idl href=#dom-fontface title=fontface>FontFace</a> object.
 			Set <var>font face’s</var> <a data-link-for=FontFace data-link-type=idl href=#dom-fontface-status title=status>status</a> argument to <code>"unloaded"</code>.
-			Set its internal <a data-link-type=idl href=#dom-fontface-fontstatuspromise title=[fontstatuspromise]>[FontStatusPromise]</a> attribute to a newly-created promise object.
+			Set its internal <a data-link-type=idl href=#dom-fontface-fontstatuspromise title=[fontstatuspromise]>[FontStatusPromise]</a> attribute to a newly-created <a data-link-type=idl href=#dom-promise title=promise>Promise</a> object.
 			Return <var>font face</var>,
 			and complete the rest of these steps asynchronously.
 
@@ -333,7 +343,7 @@ <h3 class="heading settled heading" data-level=2.3 id=font-face-ready><span clas
 The <code>ready()</code> method</span><a class=self-link href=#font-face-ready></a></h3>
 
 <p>	The <a class=idl-code data-link-for=FontFace data-link-type=method href=#dom-fontface-ready title=ready()>ready()</a> method of <a class=idl-code data-link-type=interface href=#dom-fontface title=fontface>FontFace</a>
-	returns a Promise
+	returns a <a data-link-type=idl href=#dom-promise title=promise>Promise</a>
 	which is fulfilled when the font face is successfully loaded,
 	or rejected when the font face fails to load or parse successfully.
 
@@ -345,7 +355,7 @@ <h3 class="heading settled heading" data-level=2.3 id=font-face-ready><span clas
 			Let <var>font face</var> be the <a data-link-type=idl href=#dom-fontface title=fontface>FontFace</a> object on which this method was called.
 
 		<li>
-			Let <var>ready promise</var> be a newly-created promise object.
+			Let <var>ready promise</var> be a newly-created <a data-link-type=idl href=#dom-promise title=promise>Promise</a> object.
 
 		<li>
 			Resolve <var>ready promise</var> with <var>font face’s</var> <a class=idl-code data-link-type=attribute href=#dom-fontface-fontstatuspromise title=[fontstatuspromise]>[FontStatusPromise]</a>.
@@ -404,14 +414,14 @@ <h2 class="heading settled heading" data-level=3 id=FontFaceSet-interface><span
 
     // check and start loads if appropriate
     // and fulfill promise when all loads complete
-    <a data-link-type=idl title=promise>Promise</a> <a class=idl-code data-global-name="FontFaceSet<interface>/load()<method>" data-link-for=FontFaceSet data-link-type=method href=#dom-fontfaceset-load title=load()>load</a>(DOMString <a class=idl-code data-global-name="FontFaceSet<interface>/load()<method>/font<argument>" data-link-for=FontFaceSet/load() data-link-type=argument href=#dom-fontfacesetload-font title=font>font</a>, optional DOMString <a class=idl-code data-global-name="FontFaceSet<interface>/load()<method>/text<argument>" data-link-for=FontFaceSet/load() data-link-type=argument href=#dom-fontfacesetload-text title=text>text</a> = " ");
+    <a data-link-type=idl href=#dom-promise title=promise>Promise</a> <a class=idl-code data-global-name="FontFaceSet<interface>/load()<method>" data-link-for=FontFaceSet data-link-type=method href=#dom-fontfaceset-load title=load()>load</a>(DOMString <a class=idl-code data-global-name="FontFaceSet<interface>/load()<method>/font<argument>" data-link-for=FontFaceSet/load() data-link-type=argument href=#dom-fontfacesetload-font title=font>font</a>, optional DOMString <a class=idl-code data-global-name="FontFaceSet<interface>/load()<method>/text<argument>" data-link-for=FontFaceSet/load() data-link-type=argument href=#dom-fontfacesetload-text title=text>text</a> = " ");
 
     // return whether all fonts in the fontlist are loaded
     // (does not initiate load if not available)
     boolean <a class=idl-code data-global-name="FontFaceSet<interface>/check()<method>" data-link-for=FontFaceSet data-link-type=method href=#dom-fontfaceset-check title=check()>check</a>(DOMString <a class=idl-code data-global-name="FontFaceSet<interface>/check()<method>/font<argument>" data-link-for=FontFaceSet/check() data-link-type=argument href=#dom-fontfacesetcheck-font title=font>font</a>, optional DOMString <a class=idl-code data-global-name="FontFaceSet<interface>/check()<method>/text<argument>" data-link-for=FontFaceSet/check() data-link-type=argument href=#dom-fontfacesetcheck-text title=text>text</a> = " ");
 
     // async notification that font loading and layout operations are done
-    <a data-link-type=idl title=promise>Promise</a> <a class=idl-code data-global-name="FontFaceSet<interface>/ready()<method>" data-link-for=FontFaceSet data-link-type=method href=#dom-fontfaceset-ready title=ready()>ready</a>();
+    <a data-link-type=idl href=#dom-promise title=promise>Promise</a> <a class=idl-code data-global-name="FontFaceSet<interface>/ready()<method>" data-link-for=FontFaceSet data-link-type=method href=#dom-fontfaceset-ready title=ready()>ready</a>();
 
     // loading state, "loading" while one or more fonts loading, "loaded" otherwise
     readonly attribute <a data-link-type=idl href=#enumdef-fontfaceloadstatus title=fontfaceloadstatus>FontFaceLoadStatus</a> <a class=idl-code data-global-name="FontFaceSet<interface>/status<attribute>" data-link-for=FontFaceSet data-link-type=attribute href=#dom-fontfaceset-status title=status>status</a>;
@@ -1101,6 +1111,7 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
 <li>onloadingerror, <a href=#dom-fontfaceset-onloadingerror title="section 3">3</a>
 <li>[PendingReadyPromises], <a href=#dom-fontfaceset-pendingreadypromises title="section 3">3</a>
 <li>possibly pending font loads, <a href=#possibly-pending-font-loads title="section 3">3</a>
+<li>Promise, <a href=#dom-promise title="section 1.1">1.1</a>
 <li>ready()<ul><li>method for FontFace, <a href=#dom-fontface-ready title="section 2.3">2.3</a>
 <li>method for FontFaceSet, <a href=#dom-fontfaceset-ready title="section 3.5">3.5</a>
 </ul><li>source, <a href=#dom-fontfacefontface-source title="section 2.1">2.1</a>