Re: Notes in part 2, section 7.1

I certainly don't insist, but I note that we took some heat from David on 
the last concall for checking in at least one change that he thought went 
past editors' discretion, so I think it can only help to point out areas 
where what we've done may go beyond the obvious.  I do agree that this one 
is within our mandate, but I can see where others might appreciate the 
early heads up.  In any case, thanks for doing it.

------------------------------------------------------------------
Noah Mendelsohn                              Voice: 1-617-693-4036
IBM Corporation                                Fax: 1-617-693-8676
One Rogers Street
Cambridge, MA 02142
------------------------------------------------------------------







"Jean-Jacques Moreau" <moreau@crf.canon.fr>
09/20/02 05:53 AM

 
        To:     noah_mendelsohn@us.ibm.com
        cc:     henrikn@microsoft.com, marc.hadley@sun.com, mgudgin@microsoft.com, 
www-archive@w3.org
        Subject:        Re: Notes in part 2, section 7.1

I don't think we quite need this given the nature of the change, 
but since you insist I'll be sending a short note to dist-app.

Jean-Jacques.

noah_mendelsohn@us.ibm.com wrote:
> I agree this change is at least arguably within our discretion as 
editors, 
> but I think it's broader than many other such changes.  I suggest a 
quick 
> note to "distApp" saying that we did this.  I'd rather hear expressions 
of 
> concern now, than during a final read-through leading to Proposed Rec? 
> What think you all?
> 
> ------------------------------------------------------------------
> Noah Mendelsohn                              Voice: 1-617-693-4036
> IBM Corporation                                Fax: 1-617-693-8676
> One Rogers Street
> Cambridge, MA 02142
> ------------------------------------------------------------------
> 
> 
> 
> 
> 
> 
> 
> "Jean-Jacques Moreau" <moreau@crf.canon.fr>
> 09/19/02 03:26 AM
> 
> 
>         To:     Marc Hadley <marc.hadley@sun.com>
>         cc:     Martin Gudgin <mgudgin@microsoft.com>, Henrik Frystyk 
Nielsen 
> <henrikn@microsoft.com>, noah_mendelsohn@us.ibm.com, W3C Archive 
> <www-archive@w3.org>
>         Subject:        Re: Notes in part 2, section 7.1
> 
> Done.
> 
> Added the following ednote:
> 
>    <ednote>
>      <name>JJM/MJH</name>
>      <date>20020919</date>
>      <edtext>
> This section had grown over time into an unmanageable
> entity, with information spread over several paragraphs
> and notes in an organized manner. The editors felt that
> this situation could be remedied to easily by merely
> shuffling paragraphs around and by creating a clear and
> coherent structure with four new subsections. This
> revised section is the result of that change. Unless
> decorated in green or red (as a result of some other
> issue resolution) the text has otherwise NOT changed.    </edtext>
>    </ednote>
> 
> Jean-Jacques.
> 
> 
> 
> Marc Hadley wrote:
> 
>>Looks good, I'd say go with what you have.
>>
>>Marc.
>>
>>PS. it would appear that the charset you are using is 8859-1 rather 
>>than UTF-16. Looks like my browser believes the first meta header (or 
>>perhaps what the web server tells it) and uses UTF-16 to display the 
>>document - hence the garble.
>>
>>
>>On Wednesday, Sep 18, 2002, at 09:12 US/Eastern, Jean-Jacques Moreau 
>>wrote:
>>
>>
>>>Marc,
>>>
>>>You're probably using Netscape 7.0 or Mozilla 1.1. It's a display 
>>>bug.  The message source is fine, and renders properly in Netscape 
>>>4.79 or  Outlook Express 6.0.
>>>
>>>Here it is inline anyway.
>>>
>>>Jean-Jacques.
>>>
>>>Marc Hadley wrote:
>>>
>>>
>>>>Your ideas for further movement of text sound fine to me. 
>>>>Unfortunately  the attachment you sent out seems to be garbled. I 
>>>>checked in the  archives[1] and it comes out garbled there too. Can 
>>>>you resend.
>>>
>>>
>>>
>>>----------------
>>><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html 
>>>lang="en"><head>
>>><META http-equiv="Content-Type" content="text/html; charset=UTF-16">
>>><meta http-equiv="Content-Type" content="text/html; 
>>>charset=ISO-8859-1"><title>SOAP Version 1.2 Part 2: 
>>>Adjuncts</title><style type="text/css">
>>>code           { font-family: monospace; }
>>>
>>>div.constraint,
>>>div.issue,
>>>div.note,
>>>div.notice     { margin-left: 2em; }
>>>
>>>dt.label       { display: run-in; }
>>>
>>>li, p           { margin-top: 0.3em;
>>>                 margin-bottom: 0.3em; }
>>>
>>>p.diff-chg,
>>>li.diff-chg,
>>>h1.diff-chg,
>>>h2.diff-chg,
>>>h3.diff-chg,
>>>h4.diff-chg,
>>>h5.diff-chg,
>>>h6.diff-chg,
>>>td.diff-chg,
>>>tr.diff-chg     { background-color: orange; }
>>>p.diff-del,
>>>li.diff-del,
>>>h1.diff-del,
>>>h2.diff-del,
>>>h3.diff-del,
>>>h4.diff-del,
>>>h5.diff-del,
>>>h6.diff-del,
>>>td.diff-del,
>>>tr.diff-del     { background-color: red; text-decoration: 
>>
> line-through;}
> 
>>>p.diff-add,
>>>p.diff-add,
>>>h1.diff-add,
>>>h2.diff-add,
>>>h3.diff-add,
>>>h4.diff-add,
>>>h5.diff-add,
>>>h6.diff-add,
>>>td.diff-add,
>>>tr.diff-add    { background-color: lime; }
>>>table          { empty-cells: show; }
>>>
>>>
>>>div.exampleInner pre { margin-left: 1em;
>>>                       margin-top: 0em; margin-bottom: 0em}
>>>div.exampleOuter {border: 4px double gray;
>>>                  margin: 0em; padding: 0em}
>>>div.exampleInner { background-color: #d5dee3;
>>>                   border-top-width: 4px;
>>>                   border-top-style: double;
>>>                   border-top-color: #d3d3d3;
>>>                   border-bottom-width: 4px;
>>>                   border-bottom-style: double;
>>>                   border-bottom-color: #d3d3d3;
>>>                   padding: 4px; margin: 0em }
>>>div.exampleWrapper { margin: 4px }
>>>div.exampleHeader { font-weight: bold;
>>>                    margin: 4px}
>>></style><link rel="stylesheet" type="text/css" 
>>>href="http://www.w3.org/StyleSheets/TR/base.css"></head><body><div 
>>>class="head">
>>><h1>SOAP Version 1.2 Part 2: Adjuncts</h1>
>>><h2>Editors Copy $Date: 2002/09/16 14:57:37 $ @@ @@ 
>>>@@</h2><dl><dt>This version:</dt><dd></dd><dt>Latest 
>>>version:</dt><dd></dd><dt>Previous 
>>>versions:</dt><dd></dd><dt>Editors:</dt><dd>Martin Gudgin, 
>>>DevelopMentor</dd><dd>Marc Hadley, Sun Microsystems</dd><dd>Noah 
>>>Mendelsohn, IBM</dd><dd>Jean-Jacques Moreau, Canon</dd><dd>Henrik 
>>>Frystyk Nielsen, Microsoft</dd></dl><p class="copyright"><a 
>>>href="http://www.w3.org/Consortium/Legal/ipr-notice- 
>>>20000612#Copyright">Copyright</a> © @@ <a 
>>>href="http://www.w3.org/"><abbr title="World Wide Web 
>>>Consortium">W3C</abbr></a><sup>®</sup> (<a 
>>>href="http://www.lcs.mit.edu/"><abbr title="Massachusetts Institute 
>>>of  Technology">MIT</abbr></a>, <a href="http://www.inria.fr/"><abbr 
>>>lang="fr" title="Institut National de Recherche en Informatique et 
>>>Automatique">INRIA</abbr></a>, <a 
>>>href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a 
>>>href="http://www.w3.org/Consortium/Legal/ipr-notice- 
>>>20000612#Legal_Disclaimer">liability</a>, <a 
>>>href="http://www.w3.org/Consortium/Legal/ipr-notice- 
>>>20000612#W3C_Trademarks">trademark</a>, <a 
>>>href="http://www.w3.org/Consortium/Legal/copyright-documents- 
>>>19990405">document use</a>, and <a 
>>>href="http://www.w3.org/Consortium/Legal/copyright-software- 
>>>19980720">software licensing</a> rules apply.</p></div><hr><div>
>>><h2><a name="abstract">Abstract</a></h2></div><div>
>>><h2><a name="status">Status of this Document</a></h2><p><strong>This 
>>>document is an editors' copy that has
>>>        no official standing.</strong></p><p></p></div><hr><div 
>>>class="toc">
>>><h2><a name="shortcontents">Short Table of Contents</a></h2><p 
>>>class="toc">1. <a href="#soapinhttp">SOAP HTTP Binding</a><br>2. <a 
>>>href="#IDAELAW">Placeholder</a><br></p></div><hr><div class="toc">
>>><h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a 
>>>href="#soapinhttp">SOAP HTTP Binding</a><br>    1.1 <a 
>>>href="#http-intro">Introduction</a><br>        1.1.1 <a 
>>>href="#httpoptionality">Optionality</a><br>        1.1.2 <a 
>>>href="#httpuse">Use of HTTP</a><br>        1.1.3 <a 
>>>href="#httpinterop">HTTP Interoperability</a><br>        1.1.4 <a 
>>>href="#httpmediatype">HTTP Media-Type</a><br>    1.2 <a 
>>>href="#http-bindname">Binding Name</a><br>2. <a 
>>>href="#IDAELAW">Placeholder</a><br>    2.1 <a href="#ietf-draft">IETF 
>>>Draft</a><br>    2.2 <a href="#soap-media-type">SOAP Media 
>>>Type</a><br>    2.3 <a href="#soapresmep">SOAP Response 
>>>MEP</a><br>     2.4 <a href="#singlereqrespmep">Requet-Response 
>>>MEP</a><br>    2.5 <a  href="#soapfeatspec">SOAP Feature</a><br> 
>>>2.6 <a  href="#SOAP-PART1">SOAP Part1</a><br>    2.7 <a 
>>>href="#RFC2616">RFC2616</a><br></p></div><hr><div class="body"><div 
>>>class="div1">
>>><h2><a name="soapinhttp"></a>1. SOAP HTTP Binding</h2><div 
>>
> class="div2">
> 
>>><h3><a name="http-intro"></a>1.1 Introduction</h3><p>The SOAP HTTP 
>>>Binding provides a binding of SOAP to HTTP. The
>>>    binding conforms to the SOAP Protocol Binding Framework (see <a 
>>>href="#SOAP-PART1">[SOAP-PART1]</a><a 
>>>href="soap12-part1.html/#transpbindframew">SOAP Protocol Binding
>>>    Framework</a>). It uses abstract binding properties as a 
>>
> descriptive
> 
>>>    tool for defining the functionality of certain 
>>>features.</p><p>The  SOAP Protocol Binding Framework (see <a 
>>>href="#SOAP-PART1">[SOAP-PART1]</a><a 
>>>href="soap12-part1.html/#transpbindframew">SOAP Protocol Binding
>>>    Framework</a>), the Message Exchange Pattern Specifications
>>>    (see <a href="#SOAP-PART1">[SOAP-PART1]</a><a 
>>>href="soap12-part1.html/#soapmep">SOAP Message Exchange
>>>    Patterns</a>) and Feature Specifications (see <a 
>>>href="#soapfeatspec"><b>2.5 SOAP Feature</b></a>) each describe the 
>>>properties they expect to be
>>>    present in a message exchange context when control of that context
>>>    passes between a local SOAP node and a binding 
>>>instance.</p><p>Properties are named with XML qualified names. > 
>>
> Property
> 
>>>    values are determined by the Schema type of the property, as 
>>
> defined
> 
>>>    in the specification which introduces the property.</p><div 
>>>class="div3">
>>><h4><a name="httpoptionality"></a>1.1.1 Optionality</h4><p>The SOAP 
>>>HTTP Binding is optional and SOAP nodes are NOT
>>>        required to implement it. A SOAP node that correctly and
>>>        completely implements the SOAP HTTP Binding may to be said
>>>        to "conform to the SOAP 1.2 HTTP Binding."</p><p>The SOAP 
>>>version  1.2 specification does not preclude
>>>        development of other bindings to HTTP or bindings to other
>>>        protocols, but communication with nodes using such other
>>>        bindings is not a goal. Note that other bindings of SOAP
>>>        to HTTP MAY be written to provide support for SOAP Message
>>>        exchange patterns other than <a 
>>>href="#singlereqrespmep"><b>2.4  Requet-Response MEP</b></a> or the <a 
>>>href="#soapresmep"><b>2.3 SOAP  Response MEP</b></a>. Such alternate 
>>>bindings MAY therefore
>>>        make use of HTTP features and status codes not required
>>>        for this binding. For example, another binding might
>>>        provide for a 202 or 204 HTTP response status to be
>>>        returned in response to an HTTP POST or PUT (e.g. a
>>>        one-way "push" MEP with confirmation).</p></div><div 
>>>class="div3">
>>><h4><a name="httpuse"></a>1.1.2 Use of HTTP</h4><p>This binding of 
>>>SOAP to HTTP is intended to make
>>>        appropriate use of HTTP as an application protocol. For
>>>        example, successful responses are sent with status code
>>>        200, and failures are indicated as 4XX or 5XX. This
>>>        binding is not intended to fully exploit the features of
>>>        HTTP, but rather to use HTTP specifically for the purpose
>>>        of communicating with other SOAP nodes implementing the
>>>        same binding. Therefore, this HTTP binding for SOAP does
>>>        not specify the use and/or meaning of all possible HTTP
>>>        methods, header fields and status responses. It specifies
>>>        only those which are pertinent to the <a 
>>>href="#singlereqrespmep"><b>2.4 Requet-Response MEP</b></a> or the <a 
>>>href="#soapresmep"><b>2.3 SOAP Response MEP</b></a>, or which are 
>>>likely to be introduced
>>>        by HTTP mechanisms (such as proxies) acting between the
>>>        SOAP nodes.</p><p>Certain
>>>        optional features provided by this binding depend on 
>>>capabilities  provided by
>>>        HTTP/1.1, for example content
>>>        negotiation. Implementations SHOULD thus use HTTP/1.1
>>>        <a href="#RFC2616">[RFC2616]</a> (or later compatible 
>>>versions  that share the
>>>        same major version number). Implementations MAY also be
>>>        deployed using HTTP/1.0, although in this case certain 
>>>optional  binding features
>>>        may not be provided.</p><div class="note"><p 
>>>class="prefix"><b>Note:</b></p><p>SOAP HTTP Binding implementations 
>>>need to account for the
>>>        fact that HTTP/1.0 intermediaries</p><p 
>>>class="diff-add">(which  may or may
>>>        not also be SOAP intermediaries)</p><p> may alter the 
>>>representation of
>>>        SOAP messages, even in situations where both the initial SOAP 
>>>sender and
>>>        ultimate SOAP receiver use HTTP/1.1.</p></div></div><div 
>>>class="div3">
>>><h4><a name="httpinterop"></a>1.1.3 HTTP Interoperability</h4><p>
>>>        Particularly when used with the <a href="#soapresmep"><b>2.3 
>>>SOAP  Response MEP</b></a>, the HTTP messages
>>>        produced by this binding are likely to be
>>>        indistinguishable from those produced by non-SOAP 
>>
> implementations
> 
>>>        performing similar operations.
>>>        Accordingly, some degree of interoperation can be made 
>>>possible  between SOAP nodes and other HTTP
>>>        implementations when using this binding.
>>>        For example, a conventional Web server (i.e. one not
>>>        written specifically to conform to this specification) might 
>>>be used  to respond
>>>        to SOAP-initiated HTTP GET's with representations of
>>>        <code>Content-Type</code> "application/soap+xml".
>>>        Such interoperation is not a normative feature of this 
>>>specification.
>>>        </p></div><div class="div3">
>>><h4><a name="httpmediatype"></a>1.1.4 HTTP 
>>>Media-Type</h4><p>Conforming implementations of this 
>>>binding:</p><ol><li><p>MUST be capable of sending and receiving 
>>
> messages
> 
>>>        serialized using media type "application/soap+xml" whose proper
>>>        use and parameters are described in </p><p 
>>>class="diff-del"><a 
>>>href="#soap-media-type">[soap-media-type]</a></p><p 
>>>class="diff-add"><a href="#ietf-draft"><b>2.1 IETF 
>>>Draft</b></a></p><p>.</p></li><li><p>MAY send requests and responses 
>>>using other media types
>>>        providing that such media types provide for at least the
>>>        transfer of SOAP XML Infoset.</p></li><li><p>MAY, when 
>>>sending  requests, provide an HTTP Accept
>>>        header field. This header </p><p class="diff-add">field</p><p>:
>>>
>>>            <ul><li><p>SHOULD indicate an ability to accept at minimum
>>>                "application/soap+xml".</p></li><li><p>MAY 
>>>additionally indicate willingness to accept
>>>                other media types that satisfy 2 
>>>above.</p></li></ul></p></li></ol></div></div><div class="div2">
>>><h3><a name="http-bindname"></a>1.2 Binding Name</h3><p>The binding 
>>>is  identified with the 
>>>URI:</p><ul><li><p>"http://www.w3.org/2002/06/soap/bindings/HTTP/"</ 
>>>p></li></ul></div></div><div class="div1">
>>><h2><a name="IDAELAW"></a>2. Placeholder</h2><div class="div2">
>>><h3><a name="ietf-draft"></a>2.1 IETF Draft</h3></div><div 
>>
> class="div2">
> 
>>><h3><a name="soap-media-type"></a>2.2 SOAP Media Type</h3></div><div 
>>>class="div2">
>>><h3><a name="soapresmep"></a>2.3 SOAP Response MEP</h3></div><div 
>>>class="div2">
>>><h3><a name="singlereqrespmep"></a>2.4 Requet-Response 
>>>MEP</h3></div><div class="div2">
>>><h3><a name="soapfeatspec"></a>2.5 SOAP Feature</h3></div><div 
>>>class="div2">
>>><h3><a name="SOAP-PART1"></a>2.6 SOAP Part1</h3></div><div 
>>
> class="div2">
> 
>>><h3><a name="RFC2616"></a>2.7 
>>>RFC2616</h3></div></div></div></body></html>
>>>
>>>
>>-- 
>>Marc Hadley <marc.hadley@sun.com>
>>XML Technology Center, Sun Microsystems.
>>
> 
> 
> 
> 
> 

Received on Friday, 20 September 2002 09:54:15 UTC