[cssom] Remove CSSCharsetRule. Fixes https://www.w3.org/Bugs/Public/show_bug.cgi?id=27422

Author: zcorpan

cssom/Overview.bs

@@ -12,7 +12,7 @@ Editor: Simon Pieters, Opera Software ASA http://www.opera.com, simonp@opera.com
 Editor: Glenn Adams, Cox Communications, Inc. http://www.cox.com, glenn.adams@cos.com, http://www.w3.org/wiki/User:Gadams
 Former Editor: Anne van Kesteren, Opera Software ASA http://www.opera.com, annevk@annevk.nl, https://annevankesteren.nl/
 Abstract: CSSOM defines APIs (including generic parsing and serialization rules) for Media Queries, Selectors, and of course CSS itself.
-Ignored Terms: EmptyString, mediaText, cssText, InvalidCharacterError, SecurityError, SyntaxError, IndexSizeError, HierarchyRequestError, InvalidStateError, InvalidModificationError, NoModificationAllowedError, CORS-same-origin, group of selectors, list of css page selectors
+Ignored Terms: EmptyString, mediaText, cssText, InvalidCharacterError, SecurityError, SyntaxError, IndexSizeError, HierarchyRequestError, InvalidStateError, InvalidModificationError, NoModificationAllowedError, CORS-same-origin, group of selectors, list of css page selectors, CSSCharsetRule
 </pre>
 
 <pre class='anchors'>
@@ -1684,19 +1684,6 @@ To <dfn>serialize a CSS rule</dfn>, perform one of the following in accordance w
   </ol>
 
 
- <dt>{{CSSCharsetRule}}
- <dd>
-  The result of concatenating the following:
-  <ol>
-   <li>The string "<code>@charset</code>" followed by a single SPACE (U+0020).
-   <li>The result of performing <a>serialize a string</a> on the rule's character encoding.
-   <li>The string "<code>;</code>", i.e., SEMICOLON (U+003B).
-  </ol>
-  <div class="example">
-  <pre>@charset "UTF-8";</pre>
-  </div>
-
-
  <dt>{{CSSImportRule}}
  <dd>
   The result of concatenating the following:
@@ -1749,7 +1736,7 @@ To <dfn>insert a CSS rule</dfn> <var>rule</var> in a CSS rule list <var>list</va
  a {{HierarchyRequestError}} exception. [[!CSS21]]
  Note: For example, a CSS style sheet cannot contain an <code>@import</code> at-rule after a style rule.
  <li>If <var>new rule</var> is an <code>@namespace</code> at-rule, and <var>list</var> contains anything other than
- <code>@charset</code> at-rules, <code>@import</code> at-rules, and <code>@namespace</code> at-rules,
+ <code>@import</code> at-rules, and <code>@namespace</code> at-rules,
  <a>throw</a> an {{InvalidStateError}} exception.
  <li>Insert <var>new rule</var> into <var>list</var> at the zero-indexed position <var>index</var>.
  <li>Return <var>index</var>.
@@ -1762,7 +1749,7 @@ To <dfn>remove a CSS rule</dfn> from a CSS rule list <var>list</var> at index <v
  an {{IndexSizeError}} exception.
  <li>Set <var>old rule</var> to the <var>index</var>th item in <var>list</var>.
  <li>If <var>old rule</var> is an <code>@namespace</code> at-rule, and <var>list</var> contains anything other than
- <code>@charset</code> at-rules, <code>@import</code> at-rules, and <code>@namespace</code> at-rules,
+ <code>@import</code> at-rules, and <code>@namespace</code> at-rules,
  <a>throw</a> an {{InvalidStateError}} exception.
  <li>Remove rule <var>old rule</var> from <var>list</var> at the zero-indexed position <var>index</var>.
  <li>Set <var>old rule</var>'s <a lt=concept-css-rule-parent-css-rule>parent CSS rule</a> and
@@ -1808,7 +1795,7 @@ inherits from this interface.
 
 <pre class=idl>interface CSSRule {
   const unsigned short STYLE_RULE = 1;
-  const unsigned short CHARSET_RULE = 2;
+  const unsigned short CHARSET_RULE = 2; // historical
   const unsigned short IMPORT_RULE = 3;
   const unsigned short MEDIA_RULE = 4;
   const unsigned short FONT_FACE_RULE = 5;
@@ -1826,8 +1813,6 @@ The <dfn attribute for=CSSRule>type</dfn> attribute must return the CSS rule typ
 <dl class=switch>
  <dt>If the object is a {{CSSStyleRule}}
  <dd>Return <dfn const for=CSSRule>STYLE_RULE</dfn> (numeric value 1).
- <dt>If the object is a {{CSSCharsetRule}}
- <dd>Return <dfn const for=CSSRule>CHARSET_RULE</dfn> (numberic value 2).
  <dt>If the object is a {{CSSImportRule}}
  <dd>Return <dfn const for=CSSRule>IMPORT_RULE</dfn> (numberic value 3).
  <dt>If the object is a {{CSSMediaRule}}
@@ -1918,19 +1903,6 @@ The <dfn lt=concept-declarations-specified-order>specified order</dfn> for decla
 expanded into their longhand properties, in canonical order. If a property is specified more than once (after shorthand expansion), only the
 one with greatest cascading order must be represented, at the same relative position as it was specified. [[!CSS3CASCADE]]
 
-### The {{CSSCharsetRule}} Interface ### {#the-csscharsetrule-interface}
-
-Issue: The <code>CSSCharsetRule</code> is being considered for removal. See <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=27422">bug 27422</a>.
-
-The <code>CSSCharsetRule</code> interface represents an <code>@charset</code> at-rule.
-
-<pre class=idl>interface CSSCharsetRule : CSSRule {
-  attribute DOMString encoding;
-};</pre>
-
-The <dfn attribute for=CSSCharsetRule>encoding</dfn> attribute must return the encoding information specified by the
-<code>@charset</code> at-rule.
-
 
 ### The {{CSSImportRule}} Interface ### {#the-cssimportrule-interface}
 
@@ -2069,7 +2041,7 @@ On setting, the {{CSSNamespaceRule/namespaceURI}} attribute must run the followi
  <li>Let <var>list</var> be the <a lt=concept-css-style-sheet-css-rules>CSS rules</a> of <var>parent</var>, or
  null if <var>parent</var> is null.
  <li>If <var>list</var> is not null and contains anything other than
- <code>@charset</code> at-rules, <code>@import</code> at-rules, and <code>@namespace</code> at-rules,
+ <code>@import</code> at-rules, and <code>@namespace</code> at-rules,
  <a>throw</a> an {{InvalidStateError}} exception.
  <li>Set the namespace of the <code>@namespace</code> at-rule to the given value.
 </ol>
@@ -2084,7 +2056,7 @@ On setting, the {{CSSNamespaceRule/prefix}} attribute must run the following ste
  <li>Let <var>list</var> be the <a lt=concept-css-style-sheet-css-rules>CSS rules</a> of <var>parent</var>, or
  null if <var>parent</var> is null.
  <li>If <var>list</var> is not null and contains anything other than
- <code>@charset</code> at-rules, <code>@import</code> at-rules, and <code>@namespace</code> at-rules,
+ <code>@import</code> at-rules, and <code>@namespace</code> at-rules,
  <a>throw</a> an {{InvalidStateError}} exception.
  <li>Set the prefix of the <code>@namespace</code> at-rule to the given value.
 </ol>
@@ -3188,6 +3160,12 @@ Change History {#change-history}
 This section documents some of the changes between publications of this specification. This section is not exhaustive. Bug fixes and editorial changes are
 generally not listed.
 
+<!--
+
+CSSCharsetRule is re-dropped.
+
+-->
+
 Changes From 12 July 2011 To 5 December 2013 {#changes-from-12-july-2011-to-5-december-2013}
 --------------------------------------------------------------------------------------------