<?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>3738</bug_id>
          
          <creation_ts>2006-09-18 19:17:26 +0000</creation_ts>
          <short_desc>[FT] Organization -- FTMatchOptions</short_desc>
          <delta_ts>2007-04-20 15:15:20 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>XPath / XQuery / XSLT</product>
          <component>Full Text 1.0</component>
          <version>Working drafts</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows XP</op_sys>
          <bug_status>CLOSED</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="Mary Holstege">holstege</reporter>
          <assigned_to name="Mary Holstege">holstege</assigned_to>
          
          
          <qa_contact name="Mailing list for public feedback on specs from XSL and XML Query WGs">public-qt-comments</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>11825</commentid>
    <comment_count>0</comment_count>
    <who name="Mary Holstege">holstege</who>
    <bug_when>2006-09-18 19:17:26 +0000</bug_when>
    <thetext>Organizational (Major editorial)
Read section 2.4 (Extensions to Static Context) and then into section 3
(FTSelections).  There is a discussion of FTMatchOption as prolog settings, but
you don&apos;t find out anything about what those match options are for another 20
pages or so.  You don&apos;t even get a list of what those options are.  The minimal
fix is to also include the FTMatchOption production in section 2.4 or with the
first set in section 3, but I don&apos;t think that is enough. Since we have recast
the semantics of match options so that mainly that apply to how tokenization
and matching is done, I think they can move much further up into section 3.  I
can see two ways to slice this: (A) right after FTWords and shift the compound
query operators to later different major subsection (this is how regular folks
tend to think about this: tell me what a basic word query looks like, tell me
the bells and whistles on that, now tell me about your fancy compound queries)
or (B) flip sections 3.1 and 3.2. I think option A is better, but requires more
work. 

Similarly in section 4:
As with section 3, I found myself wanting to know about match options much
sooner. Having to wade through all the oddball operators to get to basic match
options just feels wrong. Add to that the complication of having to redefine
the semantics of what you thought you understood up to that point, and it seems
even worse to me.  And if you look at what we actually say about match options
now, I really don&apos;t see a need to postpone them. I suggest moving all of the
match options up to right before the section on FTWords, except put the
fts:applySearchTokensAsPhrase in that section (the real one, not the dumbed
down version).</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>12409</commentid>
    <comment_count>1</comment_count>
    <who name="Jim Melton">jim.melton</who>
    <bug_when>2006-10-12 21:49:14 +0000</bug_when>
    <thetext>One possible editorial change that might make the difficulties somewhat smaller while not requiring major document overhaul is to strategically insert Notes that point people to relevant sections of the document.  Just a thought...</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>14796</commentid>
    <comment_count>2</comment_count>
    <who name="Mary Holstege">holstege</who>
    <bug_when>2007-04-20 15:15:20 +0000</bug_when>
    <thetext>WG agreed; reorganized as proposed.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>