<?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>8069</bug_id>
          
          <creation_ts>2009-10-26 13:52:55 +0000</creation_ts>
          <short_desc>Enum: intro text needs updating</short_desc>
          <delta_ts>2009-12-08 22:10:31 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WS-Resource Access</product>
          <component>Enumeration</component>
          <version>FPWD</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows XP</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>REMIND</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>hasProposal</keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Doug Davis">dug</reporter>
          <assigned_to name="Doug Davis">dug</assigned_to>
          
          
          <qa_contact name="notifications mailing list for WS Resource Access">public-ws-resource-access-notifications</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>29023</commentid>
    <comment_count>0</comment_count>
    <who name="Doug Davis">dug</who>
    <bug_when>2009-10-26 13:52:55 +0000</bug_when>
    <thetext>In the intro of WS-Enum there&apos;s a bit that says:

In its simplest form, WS-Enumeration defines a single operation, Pull, which allows a data source, in the context of a specific enumeration, to produce a sequence of XML elements in the body of a SOAP message.

In the submitted version of the spec this was true because Enumerate() was
not required to be supported.  In the latest version of the spec Enumerate()
is no longer optional.  So the above paragraph should be changed to something
more like:

In its simplest form, WS-Enumeration defines an operation, Enumerate, used to
establish the creation of an enumeration session and a single operation, Pull, which allows a data source, in the context of a specific enumeration, to produce a sequence of XML elements in the body of a SOAP message.

Also, in the next paragraph, there&apos;s a sentence that reads:
This specification defines such an operation, Enumerate, that data sources MAY implement for starting a new enumeration of a data source.

Based on recent changes the MAY should be a MUST.

Proposal: see above</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>29362</commentid>
    <comment_count>1</comment_count>
    <who name="Doug Davis">dug</who>
    <bug_when>2009-11-05 21:24:58 +0000</bug_when>
    <thetext>In its simplest form, WS-Enumeration defines an operation, Enumerate, used to
establish the creation of an enumeration session and another operation, Pull,
which allows a data source, in the context of a specific enumeration, to
produce a sequence of XML elements in the body of a SOAP message.
</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>29363</commentid>
    <comment_count>2</comment_count>
    <who name="Doug Davis">dug</who>
    <bug_when>2009-11-05 21:25:57 +0000</bug_when>
    <thetext>Proposal:
new paragraph:
In its simplest form, WS-Enumeration defines an operation, Enumerate, used to
establish the creation of an enumeration session and another operation, Pull,
which allows a data source, in the context of a specific enumeration, to
produce a sequence of XML elements in the body of a SOAP message.


and in following para s/MAY/MUST/:
This specification defines such an operation, Enumerate, that data sources *MAY*
implement for starting a new enumeration of a data source.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>29364</commentid>
    <comment_count>3</comment_count>
    <who name="Robert Freund">bob</who>
    <bug_when>2009-11-05 21:27:29 +0000</bug_when>
    <thetext>resolved with comment #2</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>