<?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>25214</bug_id>
          
          <creation_ts>2014-03-31 09:44:35 +0000</creation_ts>
          <short_desc>Note for pointerType mentions non-existent &quot;appendix&quot; + reinforce best practice of accepting unknown pointer types</short_desc>
          <delta_ts>2014-06-02 22:58:33 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>PointerEventsWG</product>
          <component>Pointer Events specification</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows NT</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          <see_also>https://www.w3.org/Bugs/Public/show_bug.cgi?id=25220</see_also>
          <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="Patrick H. Lauke">redux</reporter>
          <assigned_to name="Jacob Rossi [MSFT]">jrossi</assigned_to>
          <cc>public-pointer-events</cc>
          
          <qa_contact name="Pointer Events Bugzilla list">public-pointer-events-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>103159</commentid>
    <comment_count>0</comment_count>
    <who name="Patrick H. Lauke">redux</who>
    <bug_when>2014-03-31 09:44:35 +0000</bug_when>
    <thetext>Currently, the note in 5.1 PointerEvent Interface &gt; pointerType definition reads:

NOTE
See the examples in the appendix for sample code.

the link jumps to earlier in the document (3. Examples). So, not really an appendix (which is generally at the end, and called that). The note is also a bit wishy-washy...I&apos;m guessing we want to draw attention to example 2 which shows how pointerType can be used to determine what kind of input we&apos;re dealing with. Suggest changing to just:

NOTE
See example 2 for a basic demonstration of how the &lt;code&gt;pointerType&lt;/code&gt; can be used. Also note that developers should include some form of default handling to cover user agents that may have implemented their own custom &lt;code&gt;pointerType&lt;/code&gt; values and for situations where &lt;code&gt;pointerType&lt;/code&gt; is simply an empty string.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>103213</commentid>
    <comment_count>1</comment_count>
    <who name="Patrick H. Lauke">redux</who>
    <bug_when>2014-04-01 00:55:09 +0000</bug_when>
    <thetext>Possibly, in concert with this, may be worth adding a comment to the code in example 2

default:
    alert(&quot;Not sure what device was used!&quot;);


to reinforce it once more?

default:
    /* pointerType empty string or UA-specific custom type */
    alert(&quot;Not sure what device was used!&quot;);</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>107093</commentid>
    <comment_count>2</comment_count>
    <who name="Patrick H. Lauke">redux</who>
    <bug_when>2014-06-01 05:21:55 +0000</bug_when>
    <thetext>disregard the previous comment, as that is now resolved (and better) by https://www.w3.org/Bugs/Public/show_bug.cgi?id=25220</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>107163</commentid>
    <comment_count>3</comment_count>
    <who name="Jacob Rossi [MSFT]">jrossi</who>
    <bug_when>2014-06-02 22:58:33 +0000</bug_when>
    <thetext>Fixed as suggested: https://dvcs.w3.org/hg/pointerevents/rev/cf0fa520068d</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>