<?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>18852</bug_id>
          
          <creation_ts>2012-09-12 07:42:23 +0000</creation_ts>
          <short_desc>FileList says it&apos;s a Collection but that doesn&apos;t make sense</short_desc>
          <delta_ts>2012-09-13 19:25:12 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WebAppsWG</product>
          <component>File API</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Ian &apos;Hixie&apos; Hickson">ian</reporter>
          <assigned_to name="Arun">arun</assigned_to>
          <cc>annevk</cc>
    
    <cc>public-webapps</cc>
          
          <qa_contact>public-webapps-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>73685</commentid>
    <comment_count>0</comment_count>
    <who name="Ian &apos;Hixie&apos; Hickson">ian</who>
    <bug_when>2012-09-12 07:42:23 +0000</bug_when>
    <thetext>FileList says it&apos;s a Collection and links to DOM4 for the definition of Collection, but that doesn&apos;t make sense, because DOM4 says a Collection is a list of DOM nodes.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73704</commentid>
    <comment_count>1</comment_count>
    <who name="Arun">arun</who>
    <bug_when>2012-09-12 17:13:29 +0000</bug_when>
    <thetext>What *should* FileList be described as in prose?  Should I NOT describe FileList as a Collection?  An earlier comment on the public-webapps listserv by AnneVK suggested that FileList should be described as a collection.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73712</commentid>
    <comment_count>2</comment_count>
    <who name="Arun">arun</who>
    <bug_when>2012-09-12 18:31:53 +0000</bug_when>
    <thetext>I think this *does* actually make sense.

http://dev.w3.org/2006/webapi/FileAPI/#dfn-filelist

But I&apos;ve Cc&apos;d the editor of DOM4 to ask for clarification.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73713</commentid>
    <comment_count>3</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2012-09-12 18:41:51 +0000</bug_when>
    <thetext>It does not make sense.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73714</commentid>
    <comment_count>4</comment_count>
    <who name="Arun">arun</who>
    <bug_when>2012-09-12 18:48:35 +0000</bug_when>
    <thetext>OK.  In that case:

1. FileList is NOT a Collection, and it is a bug to say it is.  That&apos;s fine; my reading of this thread by Anne resulted in FileList being defined as a Collection of File objects: 

http://lists.w3.org/Archives/Public/public-webapps/2011JulSep/0855.html 

What is a better way to refer to FileList?

2. FileList is a Collection, but the prose as written does not make sense.

Which is it?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73722</commentid>
    <comment_count>5</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2012-09-12 20:21:14 +0000</bug_when>
    <thetext>Well it&apos;s obviously a collection of some kind, just not in the narrow way defined by DOM.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73727</commentid>
    <comment_count>6</comment_count>
    <who name="Arun">arun</who>
    <bug_when>2012-09-12 21:48:56 +0000</bug_when>
    <thetext>OK, since a collection is best defined in DOM4, can we have a more expansive concept?  File objects are not DOM nodes, but are objects referenced through the DOM.  Maybe include them as a permissible type to have a collection of?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73741</commentid>
    <comment_count>7</comment_count>
    <who name="Simon Pieters">zcorpan</who>
    <bug_when>2012-09-13 06:03:19 +0000</bug_when>
    <thetext>Why do you need to reference anything? Just say &quot;This interface is a collection of File objects&quot; or &quot;This interface is a list of File objects&quot; and be done with it. You don&apos;t want to hook into any implementation requirements here, this should just be a non-normative statement describing what the interface is used for.

Maybe better yet: drop the paragraph altogether and refer to the thing as just &quot;FileList&quot; or &quot;FileList object&quot;.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>73806</commentid>
    <comment_count>8</comment_count>
    <who name="Arun">arun</who>
    <bug_when>2012-09-13 19:25:12 +0000</bug_when>
    <thetext>Done.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>