mike: various wording changes

mike: various wording changes

http://dev.w3.org/cvsweb/html5/markup/Overview.html?r1=1.349&r2=1.350&f=h

===================================================================
RCS file: /sources/public/html5/markup/Overview.html,v
retrieving revision 1.349
retrieving revision 1.350
diff -u -d -r1.349 -r1.350
--- Overview.html 16 Aug 2009 10:53:40 -0000 1.349
+++ Overview.html 16 Aug 2009 15:46:27 -0000 1.350
@@ -9,7 +9,7 @@
 <body>
 <div class="head">
 <h1>HTML 5: The Markup Language</h1>
-<h2>Editor&#8217;s Draft <em>16 August 2009</em>
+<h2>Editor&#8217;s Draft <em>17 August 2009</em>
 </h2>
 <dl>
 <dt>Latest Editor&#8217;s Draft:</dt>
@@ -42,7 +42,7 @@
     
     
     <p>
-        This document is the 16 August 2009 Editor&#8217;s Draft of 
+        This document is the 17 August 2009 Editor&#8217;s Draft of 
         <cite>HTML 5: The Markup Language</cite>.
       </p>
     <p>

Index: meta.name.html
===================================================================
RCS file: /sources/public/html5/markup/meta.name.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- meta.name.html 16 Aug 2009 10:53:43 -0000 1.12
+++ meta.name.html 16 Aug 2009 15:46:28 -0000 1.13
@@ -63,9 +63,7 @@
       <dd>When the <a href="meta.name.html#meta.name.attrs.name">name</a>
         attribute is set to "<code>description</code>",
         the value of the <a href="meta.name.html#meta.name.attrs.content">content</a> attribute
-        must be a string that describes the page. The value
-        must be appropriate for use in, for example, a
-        search-results page from a search engine.</dd>
+        must be a string that describes the page.</dd>
     </dl>
     <dl>
       <dt>generator</dt>
@@ -74,9 +72,7 @@
         the value of the <a href="meta.name.html#meta.name.attrs.content">content</a> attribute
         must be a string
         that identifies the software used to generate the
-        document. If the page is hand-authored, the
-        "<code>generator</code>" metadata name must not be
-        used.</dd>
+        document.</dd>
     </dl>
     <dl>
       <dt>application-name</dt>
@@ -84,10 +80,7 @@
         attribute is set to "<code>application-name</code>",
         the value of the <a href="meta.name.html#meta.name.attrs.content">content</a> attribute
         must be a string representing the name of the Web
-        application that the page represents. If the page is
-        not a Web application, the
-        "<code>application-name</code>" metadata name must not be
-        used.</dd>
+        application that the page represents.</dd>
     </dl>
     <p>A <dfn id="registered-metadata-name">registered metadata
       name</dfn> is any metadata name registered in the central <a href="http://wiki.whatwg.org/wiki/MetaExtensions">MetaExtensions registration page</a>.</p>

Index: script.html
===================================================================
RCS file: /sources/public/html5/markup/script.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -d -r1.17 -r1.18
--- script.html 16 Aug 2009 10:53:44 -0000 1.17
+++ script.html 16 Aug 2009 15:46:28 -0000 1.18
@@ -15,8 +15,7 @@
       <h2 class="element-head"><span class="element">script</span> &#8211; <span class="shortdesc">embedded script</span> <a class="hash" href="#script">#</a> <a class="toc-bak" href="Overview.html#script-toc">T</a></h2>
       <div id="script-longdesc" class="longdesc">
     <p>The <a href="script.html#script" class="element">script</a> element
-    allows authors to include dynamic script and data blocks in
-    their documents.</p>
+    dynamic script and data blocks to be included in documents.</p>
   </div>
       <div class="no-number no-toc" id="script-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#script-content">#</a></h2>

Index: audio.html
===================================================================
RCS file: /sources/public/html5/markup/audio.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -d -r1.17 -r1.18
--- audio.html 16 Aug 2009 10:53:40 -0000 1.17
+++ audio.html 16 Aug 2009 15:46:28 -0000 1.18
@@ -54,9 +54,8 @@
         stopping.</dd>
           
             <dt><a class="attribute-name" id="audio.attrs.autobuffer" title="audio.attrs.autobuffer" href="audio.html#audio.attrs.autobuffer">autobuffer</a> = <span class="attr-values"></span> </dt>
-            <dd>Instructs the UA that the author believes that
-        downloading the entire audio stream optimistically will be
-        worthwhile.</dd>
+            <dd>Instructs the UA that downloading the entire audio
+        stream optimistically is considered worthwhile.</dd>
           
             <dt><a class="attribute-name" id="audio.attrs.controls" title="audio.attrs.controls" href="audio.html#audio.attrs.controls">controls</a> = <span class="attr-values"></span> </dt>
             <dd>Instructs the UA to expose a user interface for

Index: bdo.html
===================================================================
RCS file: /sources/public/html5/markup/bdo.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- bdo.html 16 Aug 2009 10:53:40 -0000 1.13
+++ bdo.html 16 Aug 2009 15:46:28 -0000 1.14
@@ -14,9 +14,9 @@
 <div id="bdo" class="section">
       <h2 class="element-head"><span class="element">bdo</span> &#8211; <span class="shortdesc">BiDi override</span> <a class="hash" href="#bdo">#</a> <a class="toc-bak" href="Overview.html#bdo-toc">T</a></h2>
       <div id="bdo-longdesc" class="longdesc">
-    <p>The <a href="bdo.html#bdo" class="element">bdo</a> element allows
-    authors to override the Unicode BiDi algorithm by explicitly
-    specifying a direction override.</p>
+    <p>The <a href="bdo.html#bdo" class="element">bdo</a> element provides
+    a means to specify a direction override of the Unicode BiDi
+    algorithm.</p>
   </div>
       <div class="no-number no-toc" id="bdo-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#bdo-content">#</a></h2>

Index: style.html
===================================================================
RCS file: /sources/public/html5/markup/style.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- style.html 16 Aug 2009 10:53:44 -0000 1.16
+++ style.html 16 Aug 2009 15:46:28 -0000 1.17
@@ -14,9 +14,10 @@
 <div id="style" class="section">
       <h2 class="element-head"><span class="element">style</span> &#8211; <span class="shortdesc">style (presentation) information</span> <a class="hash" href="#style">#</a> <a class="toc-bak" href="Overview.html#style-toc">T</a></h2>
       <div id="style-longdesc" class="longdesc">
-    <p>The <a href="style.html#style" class="element">style</a> element
-    allows authors to embed style information in their
-    documents.</p>
+    <p>The
+    <a href="style.html#style" class="element">style</a>
+    element
+    allows style information to be embedded in documents.</p>
   </div>
       <div class="no-number no-toc" id="style-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#style-content">#</a></h2>
@@ -59,10 +60,11 @@
        "scoped"
       <a href="terminology.html#choice" title="EITHER/OR CHOICE" class="rnc-symbol">|</a>  ""
     </span> </dt>
-            <dd>Instructs the UA to
-        apply the specified style information only to the <a href="style.html#style" class="element">style</a> element&#8217;s parent
-        element, and that element&#8217;s child nodes. Otherwise, the
-        specified styles must, if applied, be applied to the
+            <dd>Indicates that the specified style information is meant
+        to apply only to the
+        <a href="style.html#style" class="element">style</a>
+        element&#8217;s parent element, and that element&#8217;s child nodes.
+        Otherwise, the specified styles are meant to apply to the
         entire document.</dd>
           
         </dl></div>

Index: base.html
===================================================================
RCS file: /sources/public/html5/markup/base.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- base.html 16 Aug 2009 10:53:40 -0000 1.13
+++ base.html 16 Aug 2009 15:46:28 -0000 1.14
@@ -14,10 +14,11 @@
 <div id="base" class="section">
       <h2 class="element-head"><span class="element">base</span> &#8211; <span class="shortdesc">base URL</span> <a class="hash" href="#base">#</a> <a class="toc-bak" href="Overview.html#base-toc">T</a></h2>
       <div id="base-longdesc" class="longdesc">
-    <p>The <a href="base.html#base" class="element">base</a> element allows
-    authors to specify a document&#8217;s base URL for the purposes of
-    resolving relative URLs, and the name of the default browsing
-    context for the purposes of following hyperlinks.</p>
+    <p>The <a href="base.html#base" class="element">base</a> element
+    specifies a document-wide base URL for the purposes of
+    resolving relative URLs, and document-wide default
+    <a href="terminology.html#context">browsing context</a> name
+    for the purposes of following hyperlinks.</p>
   </div>
       <div class="no-number no-toc" id="base-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#base-content">#</a></h2>
@@ -45,8 +46,7 @@
       <a class="ref" href="datatypes.html#common.data.browsing-context-name-or-keyword" title="common.data.browsing-context-name-or-keyword">browsing-context-name-or-keyword</a>
     </span> </dt>
             <dd>A <a href="terminology.html#context">browsing context</a> name or
-        keyword. UAs use this value when following
-        hyperlinks.</dd>
+        keyword for use in following hyperlinks.</dd>
           
         </dl></div>
       

Index: spec.html
===================================================================
RCS file: /sources/public/html5/markup/spec.html,v
retrieving revision 1.95
retrieving revision 1.96
diff -u -d -r1.95 -r1.96
--- spec.html 16 Aug 2009 10:57:36 -0000 1.95
+++ spec.html 16 Aug 2009 15:46:28 -0000 1.96
@@ -9,7 +9,7 @@
 <body>
 <div class="head">
 <h1>HTML 5: The Markup Language</h1>
-<h2>Editor&#8217;s Draft <em>16 August 2009</em>
+<h2>Editor&#8217;s Draft <em>17 August 2009</em>
 </h2>
 <dl>
 <dt>Latest Editor&#8217;s Draft:</dt>
@@ -41,7 +41,7 @@
     
     
     <p>
-        This document is the 16 August 2009 Editor&#8217;s Draft of 
+        This document is the 17 August 2009 Editor&#8217;s Draft of 
         <cite>HTML 5: The Markup Language</cite>.
       </p>
     <p>
@@ -3384,9 +3384,8 @@
           
             <dt>
 <a class="attribute-name" id="audio.attrs.autobuffer" title="audio.attrs.autobuffer" href="#audio.attrs.autobuffer">autobuffer</a> = <span class="attr-values"></span> </dt>
-            <dd>Instructs the UA that the author believes that
-        downloading the entire audio stream optimistically will be
-        worthwhile.</dd>
+            <dd>Instructs the UA that downloading the entire audio
+        stream optimistically is considered worthwhile.</dd>
           
             <dt>
 <a class="attribute-name" id="audio.attrs.controls" title="audio.attrs.controls" href="#audio.attrs.controls">controls</a> = <span class="attr-values"></span> </dt>
@@ -3511,10 +3510,11 @@
 <span class="element">base</span> &#8211; <span class="shortdesc">base URL</span> <a class="hash" href="#base">#</a> <a class="toc-bak" href="#base-toc">T</a>
 </h2>
       <div id="base-longdesc" class="longdesc">
-    <p>The <a href="#base" class="element">base</a> element allows
-    authors to specify a document&#8217;s base URL for the purposes of
-    resolving relative URLs, and the name of the default browsing
-    context for the purposes of following hyperlinks.</p>
+    <p>The <a href="#base" class="element">base</a> element
+    specifies a document-wide base URL for the purposes of
+    resolving relative URLs, and document-wide default
+    <a href="#context">browsing context</a> name
+    for the purposes of following hyperlinks.</p>
   </div>
       <div class="no-number no-toc" id="base-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#base-content">#</a>
@@ -3550,8 +3550,7 @@
       <a class="ref" href="#common.data.browsing-context-name-or-keyword" title="common.data.browsing-context-name-or-keyword">browsing-context-name-or-keyword</a>
     </span> </dt>
             <dd>A <a href="#context">browsing context</a> name or
-        keyword. UAs use this value when following
-        hyperlinks.</dd>
+        keyword for use in following hyperlinks.</dd>
           
         </dl>
 </div>
@@ -3669,9 +3668,9 @@
 <span class="element">bdo</span> &#8211; <span class="shortdesc">BiDi override</span> <a class="hash" href="#bdo">#</a> <a class="toc-bak" href="#bdo-toc">T</a>
 </h2>
       <div id="bdo-longdesc" class="longdesc">
-    <p>The <a href="#bdo" class="element">bdo</a> element allows
-    authors to override the Unicode BiDi algorithm by explicitly
-    specifying a direction override.</p>
+    <p>The <a href="#bdo" class="element">bdo</a> element provides
+    a means to specify a direction override of the Unicode BiDi
+    algorithm.</p>
   </div>
       <div class="no-number no-toc" id="bdo-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#bdo-content">#</a>
@@ -10965,9 +10964,7 @@
       <dd>When the <a href="#meta.name.attrs.name">name</a>
         attribute is set to "<code>description</code>",
         the value of the <a href="#meta.name.attrs.content">content</a> attribute
-        must be a string that describes the page. The value
-        must be appropriate for use in, for example, a
-        search-results page from a search engine.</dd>
+        must be a string that describes the page.</dd>
     </dl>
 <dl>
 <dt>generator</dt>
@@ -10976,9 +10973,7 @@
         the value of the <a href="#meta.name.attrs.content">content</a> attribute
         must be a string
         that identifies the software used to generate the
-        document. If the page is hand-authored, the
-        "<code>generator</code>" metadata name must not be
-        used.</dd>
+        document.</dd>
     </dl>
 <dl>
 <dt>application-name</dt>
@@ -10986,10 +10981,7 @@
         attribute is set to "<code>application-name</code>",
         the value of the <a href="#meta.name.attrs.content">content</a> attribute
         must be a string representing the name of the Web
-        application that the page represents. If the page is
-        not a Web application, the
-        "<code>application-name</code>" metadata name must not be
-        used.</dd>
+        application that the page represents.</dd>
     </dl>
 <p>A <dfn id="registered-metadata-name">registered metadata
       name</dfn> is any metadata name registered in the central <a href="http://wiki.whatwg.org/wiki/MetaExtensions">MetaExtensions registration page</a>.</p>
@@ -12845,8 +12837,7 @@
 </h2>
       <div id="script-longdesc" class="longdesc">
     <p>The <a href="#script" class="element">script</a> element
-    allows authors to include dynamic script and data blocks in
-    their documents.</p>
+    dynamic script and data blocks to be included in documents.</p>
   </div>
       <div class="no-number no-toc" id="script-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#script-content">#</a>
@@ -13225,10 +13216,14 @@
 <span class="element">source</span> &#8211; <span class="shortdesc">media source</span> <a class="hash" href="#source">#</a> <a class="toc-bak" href="#source-toc">T</a>
 </h2>
       <div id="source-longdesc" class="longdesc">
-    <p>The <a href="#source" class="element">source</a> element
-    allows authors to specify multiple
-    <a href="#media-source">media sources</a>
-    for media elements.</p>
+    <p>The
+    <a href="#source" class="element">source</a>
+    element
+    enables multiple <a href="#media-source">media sources</a> to
+    be specified for
+    <a href="#audio" class="element">audio</a>
+    <a href="#video" class="element">video</a>
+    .</p>
   </div>
       <div class="no-number no-toc" id="source-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#source-content">#</a>
@@ -13451,9 +13446,10 @@
 <span class="element">style</span> &#8211; <span class="shortdesc">style (presentation) information</span> <a class="hash" href="#style">#</a> <a class="toc-bak" href="#style-toc">T</a>
 </h2>
       <div id="style-longdesc" class="longdesc">
-    <p>The <a href="#style" class="element">style</a> element
-    allows authors to embed style information in their
-    documents.</p>
+    <p>The
+    <a href="#style" class="element">style</a>
+    element
+    allows style information to be embedded in documents.</p>
   </div>
       <div class="no-number no-toc" id="style-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#style-content">#</a>
@@ -13505,10 +13501,11 @@
        "scoped"
       <a href="#choice" title="EITHER/OR CHOICE" class="rnc-symbol">|</a>  ""
     </span> </dt>
-            <dd>Instructs the UA to
-        apply the specified style information only to the <a href="#style" class="element">style</a> element&#8217;s parent
-        element, and that element&#8217;s child nodes. Otherwise, the
-        specified styles must, if applied, be applied to the
+            <dd>Indicates that the specified style information is meant
+        to apply only to the
+        <a href="#style" class="element">style</a>
+        element&#8217;s parent element, and that element&#8217;s child nodes.
+        Otherwise, the specified styles are meant to apply to the
         entire document.</dd>
           
         </dl>

Index: source.html
===================================================================
RCS file: /sources/public/html5/markup/source.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- source.html 16 Aug 2009 10:53:44 -0000 1.19
+++ source.html 16 Aug 2009 15:46:28 -0000 1.20
@@ -14,10 +14,14 @@
 <div id="source" class="section">
       <h2 class="element-head"><span class="element">source</span> &#8211; <span class="shortdesc">media source</span> <a class="hash" href="#source">#</a> <a class="toc-bak" href="Overview.html#source-toc">T</a></h2>
       <div id="source-longdesc" class="longdesc">
-    <p>The <a href="source.html#source" class="element">source</a> element
-    allows authors to specify multiple
-    <a href="source.html#media-source">media sources</a>
-    for media elements.</p>
+    <p>The
+    <a href="source.html#source" class="element">source</a>
+    element
+    enables multiple <a href="source.html#media-source">media sources</a> to
+    be specified for
+    <a href="audio.html#audio" class="element">audio</a>
+    <a href="video.html#video" class="element">video</a>
+    .</p>
   </div>
       <div class="no-number no-toc" id="source-content">
         <h2 class="element-subhead">Content model <a class="hash" href="#source-content">#</a></h2>

Received on Sunday, 16 August 2009 15:47:36 UTC