Style fixes
authorTakeshi Yoshino <tyoshino@google.com>
Wed, 29 Jan 2014 21:10:42 +0900
changeset 143 d58caffffd98
parent 142 5e5fd6259637
child 144 4aad0585848b
Style fixes
Overview.htm
--- a/Overview.htm	Wed Jan 29 20:20:41 2014 +0900
+++ b/Overview.htm	Wed Jan 29 21:10:42 2014 +0900
@@ -1097,6 +1097,11 @@
 			</p>
 
 			<p>
+				An associated binary data queue <dfn>binaryReadBuffer</dfn> which holds binary data spliced from <a>readDataBuffer</a>.
+				THis queue is initialized to an empty queue on construction.
+			</p>
+
+			<p>
 				A struct type <dfn>PendingReadDescriptor</dfn> has the following members:
 				<ul>
 					<li>A <a>Promise</a> <var>promise</var></li>
@@ -1109,29 +1114,29 @@
 
 			<p>
 				A WritableStream has an associated <a>PendingReadDescriptor</a> <dfn>pendingRead</dfn>.
-				This variable is initialized to <code>null</code>.
+				This variable is initialized to <code>null</code> on construction.
 			</p>
 
 			<p>
-				An associated flag <dfn>eofReached</dfn> which indicates that the EOF was received from the <a>dataSource</a>.
+				An associated flag <dfn>eofReached</dfn> which indicates that the <a>read EOF</a> was received from the <a>dataSource</a>.
 			</p>
 
 			<p>
-				An associated object <dfn>sourceErrorDetail</dfn> which is initialized to <code>null</code>, and once the EOF meaning an error is received from the <a>dataSource</a>, set to the error detail object.
+				An associated object <dfn>sourceErrorDetail</dfn> which is initialized to <code>null</code>. Once the <a>read EOF</a> including indication of an error is received from the <a>dataSource</a>, this variable is set to the error detail object.
 			</p>
 
 			<p>
 				To <dfn>retrieve data</dfn>, run the steps below:
 				<ol>
-					<li>Let <var>readableAmount</var> be sum of the total cost in <a>readDataBuffer</a> and the total number of bytes in <a>binaryReadBuffer</a></li>
-					<li>Let <var>amountToRetrieve</var> be max(max(<a href="#widl-ReadableStream-pullAmount">pullAmount</a>, <a>readUpToPullAmount</a>, <a>pipePullAmount</a>) - (<a>amountRequested</a> + <var>readableAmount</var> + <a>amountBeingReturned</a>), 0)</li>
-					<li>Set <a>amountRequested</a> to <a>amountRequested</a> + <var>amountToRetrieve</var></li>
-					<li>Send a request to the <a>dataSource</a> to return data with <var>amountToRetrieve</var> <a>cost</a> to the ReadableStream</li>
+					<li>Let <var>readableAmount</var> be sum of the total <a>cost</a> in <a>readDataBuffer</a> and the total number of bytes in <a>binaryReadBuffer</a></li>
+					<li>Let <var>amountToNewlyRetrieve</var> be max(max(<a href="#widl-ReadableStream-pullAmount">pullAmount</a>, <a>readUpToPullAmount</a>, <a>pipePullAmount</a>) - (<a>amountRequested</a> + <var>readableAmount</var> + <a>amountBeingReturned</a>), 0)</li>
+					<li>Set <a>amountRequested</a> to <a>amountRequested</a> + <var>amountToNewlyRetrieve</var></li>
+					<li>Send a request to the <a>dataSource</a> to produce data with <var>amountToNewlyRetrieve</var> <a>cost</a> to the ReadableStream</li>
 				</ol>
 			</p>
 
 			<p>
-				To <dfn>splice binary data</dfn> with <var>remainingSize</var> and <var>binaryReadBuffer</var> argument, repeat the steps below while <a>readDataBuffer</a> is not empty:
+				To <dfn>splice binary data</dfn>, repeat the steps below while <a>readDataBuffer</a> is not empty:
 
 				<ol>
 					<li>If <a>pendingRead</a>.<var>size</var> is 0, return from this algorithm</li>