<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>15931</bug_id>
          
          <creation_ts>2012-02-07 20:26:32 +0000</creation_ts>
          <short_desc>WebIDL snippets need updating</short_desc>
          <delta_ts>2012-03-15 17:58:22 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>CSS</product>
          <component>Regions</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>cssom</status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Ms2ger">Ms2ger</reporter>
          <assigned_to name="Vincent Hardy">vhardy</assigned_to>
          <cc>eoconnor</cc>
    
    <cc>mihnea</cc>
          
          <qa_contact>public-css-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>63858</commentid>
    <comment_count>0</comment_count>
    <who name="Ms2ger">Ms2ger</who>
    <bug_when>2012-02-07 20:26:32 +0000</bug_when>
    <thetext>There are various bugs in the WebIDL blocks:

&gt; [Supplemental] interface Document {
&gt;   NamedFlow getFlowByName(DOMString name);
&gt;   NamedFlowCollection getNamedFlows();
&gt; };

&apos;[Supplemental]&apos; should be &apos;partial&apos;.

&gt; interface NamedFlowCollection {
&gt;     readonly attribute unsigned long length;
&gt;     caller getter NamedFlow item (in unsigned long index);
&gt; }

Trailing semicolon is missing.

&apos;caller&apos; should not be used, as it should only be used for legacy features (document.all). See &lt;http://dev.w3.org/2006/webapi/WebIDL/#idl-legacy-callers&gt;.

The specification does not list the &apos;supported property indices&apos;, as required by the WebIDL specification (&lt;http://dev.w3.org/2006/webapi/WebIDL/#idl-indexed-properties&gt;).

Furthermore, as item() can return null, the return type must be &apos;NamedFlow?&apos;, including the question mark.

&apos;in&apos; is also no longer supported.

&gt; [Supplemental] interface Element {
&gt;     readonly attribute DOMString regionOverflow;
&gt;     getter Range[] getRegionFlowRanges();
&gt; };

Again, &apos;partial&apos;.

&apos;getter&apos;s must take exactly one argument (either unsigned long or DOMString). In fact, this should probably be

|     readonly attribute Range[] regionFlowRanges;

as there doesn&apos;t seem to be a compelling reason to use a function.

Finally, a normative reference to the WebIDL specification is missing, which strictly speaking means that these snippets are meaningless.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>65589</commentid>
    <comment_count>1</comment_count>
    <who name="Vincent Hardy">vhardy</who>
    <bug_when>2012-03-15 01:40:54 +0000</bug_when>
    <thetext>Implemented the requested changes in:

https://dvcs.w3.org/hg/csswg/diff/bde8090375d0/css3-regions/Overview.src.html

The only difference is for regionFlowRanges which I re-specified as:

sequence&lt;Range&gt;getRegionFlowRanges()

Because this is meant to return a new array instance on each call and it is not meant to be a live list.

I&apos;ll close this after 48h if you (Ms2ger) have no objection.

Thanks!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>65611</commentid>
    <comment_count>2</comment_count>
    <who name="Ms2ger">Ms2ger</who>
    <bug_when>2012-03-15 17:37:47 +0000</bug_when>
    <thetext>Looks good, thanks.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>65613</commentid>
    <comment_count>3</comment_count>
    <who name="Vincent Hardy">vhardy</who>
    <bug_when>2012-03-15 17:58:22 +0000</bug_when>
    <thetext>Thanks for the review. Closing the bug now.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>