Finally getting around to adding final HTML5-warnings changes.

msporny · msporny · commit 454ddc9f8df2 · 2009-08-29T11:30:58.000-04:00
diff --git a/Makefile.in b/Makefile.in
@@ -26,11 +26,13 @@ html5-hixie: directories ${DIST_DIR}/html5-hixie.html
 
 ${DIST_DIR}/html5-hixie.html: headers/header-w3c-html5 html5-hixie/source
 	@echo "Building HTML5-hixie specification..."
+	@echo "Removing non-HTML5 sections..."
+	@perl -e '$$_ = join("", <>); s/<!--END html5-->.*?<!--START html5-->//gs; s/<!--(START|END).*?-->//g; print' html5-hixie/source > html5-hixie/source-html5
 	@echo "Splitting html5-hixie into microsections..."
-	@./bin/microsplit.py html5-hixie/source
+	@./bin/microsplit.py html5-hixie/source-html5
 	@echo "Joining microsections into HTML5-hixie specification..."
 	@echo "include headers/header-w3c-html5" > build/html5-hixie.conf
-	@cat build/source.conf >> build/html5-hixie.conf
+	@cat build/source-html5.conf >> build/html5-hixie.conf
 	@./bin/microjoin.py build/html5-hixie.conf
 	@echo "Generating final document via Anolis (this may take 2-3 minutes)..."
 	@@ANOLIS@ @ANOLIS_FLAGS@ ${BUILD_DIR}/specification.html ${DIST_DIR}/html5-hixie.html
diff --git a/configs/html5-warnings.conf b/configs/html5-warnings.conf
@@ -78,7 +78,6 @@ include build/common-infrastructure-common-dom-interfaces-domstringmap
 include build/common-infrastructure-common-dom-interfaces-dom-feature-strings
 include build/common-infrastructure-common-dom-interfaces-exceptions
 include build/common-infrastructure-common-dom-interfaces-garbage-collection
-include microsections/warnings/common-infrastructure-common-dom-interfaces-garbage-collection-warning
 include build/semantics-structure-and-apis-of-html-documents
 include build/semantics-structure-and-apis-of-html-documents-introduction
 include build/semantics-structure-and-apis-of-html-documents-documents
@@ -109,14 +108,13 @@ include microsections/warnings/the-elements-of-html-document-metadata-the-head-e
 include build/the-elements-of-html-document-metadata-the-title-element
 include build/the-elements-of-html-document-metadata-the-base-element
 include build/the-elements-of-html-document-metadata-the-link-element
-include microsections/warnings/the-elements-of-html-document-metadata-the-meta-element-warning
+include build/the-elements-of-html-document-metadata-the-meta-element
 include build/the-elements-of-html-document-metadata-the-style-element
 include build/the-elements-of-html-document-metadata-styling
 include build/the-elements-of-html-scripting
 include build/the-elements-of-html-scripting-the-script-element
 include build/the-elements-of-html-scripting-the-noscript-element
 include build/the-elements-of-html-sections
-include microsections/warnings/the-elements-of-html-sections-warning
 include build/the-elements-of-html-sections-the-body-element
 include build/the-elements-of-html-sections-the-section-element
 include build/the-elements-of-html-sections-the-nav-element
@@ -230,7 +228,7 @@ include build/the-elements-of-html-interactive-elements
 include build/the-elements-of-html-interactive-elements-the-details-element
 include build/the-elements-of-html-interactive-elements-the-datagrid-element
 include build/the-elements-of-html-interactive-elements-the-command-element
-include microsections/warnings/the-elements-of-html-interactive-elements-the-bb-element-warning
+include build/the-elements-of-html-interactive-elements-the-bb-element
 include build/the-elements-of-html-interactive-elements-the-menu-element
 include build/the-elements-of-html-interactive-elements-commands
 include build/the-elements-of-html-miscellaneous-elements
@@ -252,7 +250,6 @@ include build/microdata-encoding-microdata-names:-the-itemprop-attribute
 include build/microdata-encoding-microdata-values
 include build/microdata-microdata-dom-api
 include build/microdata-predefined-vocabularies
-include microsections/warnings/microdata-predefined-vocabularies-warning
 include build/microdata-predefined-vocabularies-general
 include build/microdata-predefined-vocabularies-vcard
 include build/microdata-predefined-vocabularies-vevent
@@ -325,13 +322,6 @@ include build/web-browsers-browsing-the-web-page-load-processing-model-for-inlin
 include build/web-browsers-browsing-the-web-navigating-to-a-fragment-identifier
 include build/web-browsers-browsing-the-web-history-traversal
 include build/web-browsers-browsing-the-web-unloading-documents
-include build/web-browsers-browsing-the-web-introduction
-include build/web-browsers-browsing-the-web-the-api
-include build/web-browsers-browsing-the-web-1
-include build/web-browsers-browsing-the-web-the-1
-include build/web-browsers-browsing-the-web-disk-space
-include build/web-browsers-browsing-the-web-privacy
-include build/web-browsers-browsing-the-web-security
 include build/web-browsers-links
 include build/web-browsers-links-hyperlink-elements
 include build/web-browsers-links-following-hyperlinks
@@ -370,38 +360,8 @@ include build/user-interaction-undo-history-redo:-moving-forward-in-the-undo-tra
 include build/user-interaction-undo-history-the-undomanagerevent-interface-and-the-undo-and-redo-events
 include build/user-interaction-undo-history-implementation-notes
 include build/user-interaction-editing-apis
-include build/user-interaction-1
-include build/user-interaction-introduction-scope
-include build/user-interaction-introduction-tutorial
-include build/user-interaction-infrastructure
-include build/user-interaction-infrastructure-the-global-scope
-include build/user-interaction-infrastructure-base-urls-and-origins-of-workers
-include build/user-interaction-infrastructure-decoding-scripts
-include build/user-interaction-infrastructure-the-event-loop
-include build/user-interaction-infrastructure-the-workers-lifetime
-include build/user-interaction-infrastructure-processing-model
-include build/user-interaction-infrastructure-runtime-script-errors
-include build/user-interaction-infrastructure-creating-workers
-include build/user-interaction-apis-available-to-workers
-include build/user-interaction-apis-available-to-workers-importing-scripts-and-libraries
-include build/user-interaction-apis-available-to-workers-the-navigator-object
-include build/user-interaction-apis-available-to-workers-apis-defined-in-other-specifications
-include build/user-interaction-apis-available-to-workers-interface-objects-and-constructors
-include build/user-interaction-apis-available-to-workers-worker-locations
 include build/communication
 include build/communication-event-definitions
-include build/communication-event-definitions-introduction
-include build/communication-event-definitions-the-eventsource-interface
-include build/communication-event-definitions-processing-model
-include build/communication-event-definitions-parsing-an-event-stream
-include build/communication-event-definitions-interpreting-an-event-stream
-include build/communication-event-definitions-notes
-include build/communication-event-definitions-garbage-collection
-include build/communication-event-definitions-iana-considerations
-include build/communication-text-event-stream
-include build/communication-text-event-stream-introduction
-include build/communication-text-event-stream-the-websocket-interface
-include build/communication-text-event-stream-feedback-from-the-protocol
 include build/communication-cross-document-messaging
 include build/communication-cross-document-messaging-introduction
 include build/communication-cross-document-messaging-security
@@ -496,7 +456,6 @@ include build/obsolete-features-requirements-for-implementations-frames
 include build/things-that-you-cant-do-with-this-specification-because-they-are-better-handled-using-other-technologies-that-are-further-described-herein
 include build/things-that-you-cant-do-with-this-specification-because-they-are-better-handled-using-other-technologies-that-are-further-described-herein-localization
 include build/things-that-you-cant-do-with-this-specification-because-they-are-better-handled-using-other-technologies-that-are-further-described-herein-declarative-3d-scenes
-include build/things-that-you-cant-do-with-this-specification-because-they-are-better-handled-using-other-technologies-that-are-further-described-herein-rendering-and-the-dom
 include build/iana-considerations
 include build/iana-considerations-text-html
 include build/iana-considerations-application-xhtml-xml
diff --git a/microsections/warnings/common-infrastructure-character-encodings-warnings b/microsections/warnings/common-infrastructure-character-encodings-warnings
@@ -1,5 +1,5 @@
 <p class="XXX">
-This section is controversial and does not enjoy broad consensus. 
+This section is under active discussion and does not enjoy broad consensus. 
 </p>
 
 <p class="XXX">
@@ -13,7 +13,8 @@ violate currently published specifications.
 <p class="XXX">
 While these "willful violations" of current W3C and IETF specifications 
 are performed to ensure backward compatability for legacy content, the
-act of violating known specifications is controversial and must be
-discussed with both the W3C and IETF. There may be a possibility to
-harmonize this specification with the specifications that are violated.
+act of violating known specifications is not good practice and must be
+discussed in further detail with both the W3C and IETF. There may be a 
+possibility to harmonize this specification with the specifications 
+that are violated.
 </p>
diff --git a/microsections/warnings/common-infrastructure-common-dom-interfaces-garbage-collection-warning b/microsections/warnings/common-infrastructure-common-dom-interfaces-garbage-collection-warning
@@ -1,5 +1,5 @@
 <p class="XXX">
-This section is controversial and does not enjoy broad consensus. 
+This section is under active discussion and does not enjoy broad consensus. 
 </p>
 
 <p class="XXX">
diff --git a/microsections/warnings/common-infrastructure-urls-warning b/microsections/warnings/common-infrastructure-urls-warning
@@ -1,12 +1,5 @@
 <p class="XXX">
-This section is unstable, violates existing RFCs and may be updated in 
-future versions of this specification. 
-</p>
-
-<p class="XXX">
-There is a forthcoming IRI specification that would challenge the normative
-nature of this section. The terminology used in this section is a willful
-violation of 
-<a href="http://www.ietf.org/rfc/rfc3986.txt">RFC 3986</a>
-and is expected to be challenged by members of the IETF.
+This section normatively refers to a 'Web Addresses' specification that 
+is work-in-progress; also, usage of the term 'URL' for things that are 
+not URLs as defined in RFC 3986 remains under active discussion.
 </p>
diff --git a/microsections/warnings/microdata-warning b/microsections/warnings/microdata-warning
@@ -1,5 +1,8 @@
 <p class="XXX">
-This section is controversial and does not enjoy broad consensus. 
+This section is under active discussion and does not enjoy broad consensus. 
+The discussion surrounding whether or not to integrate RDFa or Microdata
+into the HTML5 specification was started 
+<a href="http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2008-August/015892.html">around August 2008</a>.
 </p>
 
 <p class="XXX">
@@ -11,6 +14,6 @@ currently published as a
 An additional alternative that is being proposed
 is the removal of Microdata and RDFa from the HTML5 specification and
 the placement of each section into a separate specification that is
-implemented on top of the HTML5 standard.
+implemented on top of the HTML5 standard. 
 </p>
 
diff --git a/microsections/warnings/obsolete-features-warning b/microsections/warnings/obsolete-features-warning
@@ -1,14 +1,15 @@
 <p class="XXX">
-Statements regarding the summary attribute are controversial and 
+Statements regarding the summary attribute are under active discussion and 
 do not enjoy broad consensus. 
 </p>
 
 <p class="XXX">
-There is concern that making the summary attribute obsolete conflicts
+There is concern that making the summary attribute as obsolete conflicts
 with current guidance given via the
 <abbr title="Web Accessibility Initiative">WAI</abbr> and the 
 <abbr title="Protocols and Formats Working Group">PFWG</abbr>. Alternate
 language for the summary attribute is currently being authored and may
 replace some of the language related to summary in this specification.
+This <a href="http://www.w3.org/html/wg/tracker/issues/32">
+issue is currently being tracked</a> at the HTML WG.
 </p>
-
diff --git a/microsections/warnings/the-elements-of-html-document-metadata-the-head-element-warning b/microsections/warnings/the-elements-of-html-document-metadata-the-head-element-warning
@@ -2,11 +2,13 @@
 
   <p class="XXX">
   The removal of the <code>profile</code> attribute from the <code>head</code>
-  element is controversial and currently does not enjoy consensus.
+  element is under active discussion and currently does not enjoy consensus.
+  The issue was <a href="http://www.w3.org/html/wg/tracker/issues/55">
+  raised on June 26th, 2008</a>.
   </p>
 
   <p class="XXX">
-  Microformats and GRDDL require the existence of the <code>profile</code> 
+  GRDDL requires the existence of the <code>profile</code> 
   attribute. There is currently 
   <a href="http://www.w3.org/html/wg/tracker/issues/55">an active issue 
   in HTML WG</a> that is tracking the discussion of the <code>profile</code> 
diff --git a/microsections/warnings/the-elements-of-html-embedded-content-the-img-element-warning b/microsections/warnings/the-elements-of-html-embedded-content-the-img-element-warning
@@ -594,12 +594,12 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
   described in the following sections.</p>
 
   <p class="XXX">
-  Some of the following sections are controversial and do not enjoy 
+  Some of the following sections are under active discussion and do not enjoy 
   broad consensus.
   </p>
   <p class="XXX">
-  The notion that there may be images in the document that contain an
-  <code>alt</code> attribute that is blank may cause a number of usability
+  The notion that there may be images in the document that do not contain an
+  <code>alt</code> attribute may cause a number of usability
   concerns for <abbr title="Assistive Technologies">AT</abbr>. The 
   <abbr title="Web Accessibility Initiative">WAI</abbr> 
   <abbr title="Protocols and Formats Working Group">PFWG</abbr> has 
diff --git a/microsections/warnings/the-elements-of-html-embedded-content-the-source-element-warning b/microsections/warnings/the-elements-of-html-embedded-content-the-source-element-warning
@@ -4,7 +4,7 @@
   There are a 
   <a href="http://www.w3.org/html/wg/tracker/issues/7">number of issues</a> 
   related to codec licensing in the following sections. Codecs for audio and 
-  video continue to be controversial in nature due to the vast pool of unknown
+  video continue to be under active discussion due to the vast pool of unknown
   patents related to online multimedia. There are currently no open-source,
   license-free video and audio codecs that all of the browser manufacturers 
   and web authors are willing to implement and distribute as a core part of
diff --git a/microsections/warnings/the-elements-of-html-sections-warning b/microsections/warnings/the-elements-of-html-sections-warning
@@ -1,9 +1,9 @@
 <p class="XXX">
-There are a number of new elements in this section that are controversial and 
-that do not enjoy broad consensus. 
+There are a number of new elements in this section that are under active 
+discussion and that do not enjoy broad consensus. 
 </p>
 
 <p class="XXX">
 Microsoft and others have asserted that there are a 
-<a href="http://lists.w3.org/Archives/Public/public-html/2009Aug/0389.html">number of language design issues</a> with the <code>section</code>, <code>nav</code>, <code>article</code>, <code>aside</code>, and <code>hgroup</code>. It has been suggested that either the <code>class</code> attribute may perform the same functionality, or the <code>role</code> attribute could be adopted from the XHTML2 work.
+<a href="http://lists.w3.org/Archives/Public/public-html/2009Aug/0389.html">number of language design issues</a> with the <code>section</code>, <code>nav</code>, <code>article</code>, <code>aside</code>, and <code>hgroup</code>. It has been suggested that either the <code>class</code> attribute may perform the same functionality, or the <code>role</code> attribute could be adopted from the XHTML2 work to perform the same functionality.
 </p>
diff --git a/microsections/warnings/web-browsers-browsing-the-web-navigating-across-documents-warning b/microsections/warnings/web-browsers-browsing-the-web-navigating-across-documents-warning
@@ -2,14 +2,14 @@
 
   <p class="XXX">
   The <code title="http-origin">Origin</code> header is currently
-  controversial and may possibly duplicate work being performed at 
+  under active discussion and may possibly duplicate work being performed at 
   the IETF. Since 
   <a href="http://www.w3.org/html/wg/tracker/issues/63">it is 
-  still uncertain</a> where the 
-  <code title="http-origin">Origin</code> header specification
-  will be defined, readers should note that the language in this
-  section concerning the <code title="http-origin">Origin</code> header
-  may be removed. 
+  still uncertain</a> whether or not the
+  <code title="http-origin">Origin</code> header specification will be
+  completed at the IETF, readers should note that the language in this 
+  section concerning the <code title="http-origin">Origin</code> header 
+  may be revised or completely removed.
   </p>
 
   <p>Certain actions cause the <span>browsing context</span> to
