<?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>26062</bug_id>
          
          <creation_ts>2014-06-11 17:16:14 +0000</creation_ts>
          <short_desc>fixing the description of the &quot;_readonly&quot; attribute on MediaStreamTrack</short_desc>
          <delta_ts>2014-07-01 09:53:03 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WebRTC Working Group</product>
          <component>Media Capture and Streams</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows NT</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>WONTFIX</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="Shijun Sun">shijuns</reporter>
          <assigned_to name="public-media-capture@w3.org">public-media-capture</assigned_to>
          <cc>harald</cc>
    
    <cc>public-media-capture</cc>
          
          

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>107670</commentid>
    <comment_count>0</comment_count>
    <who name="Shijun Sun">shijuns</who>
    <bug_when>2014-06-11 17:16:14 +0000</bug_when>
    <thetext>MediaStreamTrack has an attribute in its interface definition called &quot;_readonly&quot; (including the underscore).  However, the description refers to it as simply &quot;readonly&quot;.

Re the underscore, we had this explained as being a workaround for the fact that readonly is a reserved word in WebIDL.

With a bit digging: the May-29-2013 version of the GUM spec has the underscore in the description.  It was removed in the July-2013 update.  

It should be added back to make the spec self-consistent.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>107672</commentid>
    <comment_count>1</comment_count>
    <who name="Shijun Sun">shijuns</who>
    <bug_when>2014-06-11 17:44:10 +0000</bug_when>
    <thetext>An alternative option is to define the attribute as readOnly.  The camelCase definition has been used in other W3C specs, e.g. HTMLInputElement, and HTMLTextAreaElement.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>108593</commentid>
    <comment_count>2</comment_count>
    <who name="Harald Alvestrand">harald</who>
    <bug_when>2014-07-01 09:53:03 +0000</bug_when>
    <thetext>Relevant WebIDL spec: http://www.w3.org/TR/WebIDL/ section 3.1

For all of these constructs, the identifier is the value of the identifier token with any single leading U+005F LOW LINE (&quot;_&quot;) character (underscore) removed.

Note
A leading &quot;_&quot; is used to escape an identifier from looking like a reserved word so that, for example, an interface named “interface” can be defined. The leading &quot;_&quot; is dropped to unescape the identifier.

While this is irritating, it&apos;s self-consistent.
Closing as &quot;no change needed&quot;.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>