Changeset 310 for draft-ietf-httpbis


Ignore:
Timestamp:
Aug 21, 2008, 1:13:46 AM (11 years ago)
Author:
julian.reschke@…
Message:

Resolve #129: mention that Set-Cookie requires special handling with respect to list syntax, add references to RFCs and historical information (closes #129).

Location:
draft-ietf-httpbis/latest
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • draft-ietf-httpbis/latest/p1-messaging.html

    r309 r310  
    476476         <tr>
    477477            <td class="header left"></td>
    478             <td class="header right">August 11, 2008</td>
     478            <td class="header right">August 21, 2008</td>
    479479         </tr>
    480480      </table>
    … …  
    13641364         thus a proxy <em class="bcp14">MUST NOT</em> change the order of these field values when a message is forwarded.
    13651365      </p>
     1366      <p id="rfc.section.4.2.p.6"> </p>
     1367      <dl class="empty">
     1368         <dd> <b>Note:</b> the "Set-Cookie" header as implemented in practice (as opposed to how it is specified in <a href="#RFC2109" id="rfc.xref.RFC2109.1"><cite title="HTTP State Management Mechanism">[RFC2109]</cite></a>) can occur multiple times, but does not use the list syntax, and thus cannot be combined into a single line. (See Appendix
     1369            A.2.3 of <a href="#Kri2001" id="rfc.xref.Kri2001.1"><cite title="HTTP Cookies: Standards, Privacy, and Politics">[Kri2001]</cite></a> for details.) Also note that the Set-Cookie2 header specified in <a href="#RFC2965" id="rfc.xref.RFC2965.1"><cite title="HTTP State Management Mechanism">[RFC2965]</cite></a> does not share this problem.
     1370         </dd>
     1371      </dl>
    13661372      <h2 id="rfc.section.4.3"><a href="#rfc.section.4.3">4.3</a>&nbsp;<a id="message.body" href="#message.body">Message Body</a></h2>
    13671373      <p id="rfc.section.4.3.p.1">The message-body (if any) of an HTTP message is used to carry the entity-body associated with the request or response. The
    … …  
    23552361      <h2 id="rfc.references.2"><a href="#rfc.section.12.2" id="rfc.section.12.2">12.2</a> Informative References
    23562362      </h2>
    2357       <table summary="Informative References">                                                   
     2363      <table summary="Informative References">                                                         
     2364         <tr>
     2365            <td class="reference"><b id="Kri2001">[Kri2001]</b></td>
     2366            <td class="top">Kristol, D., “<a href="http://arxiv.org/abs/cs.SE/0105018">HTTP Cookies: Standards, Privacy, and Politics</a>”, ACM Transactions on Internet Technology&nbsp;Vol. 1, #2, November&nbsp;2001, &lt;<a href="http://arxiv.org/abs/cs.SE/0105018">http://arxiv.org/abs/cs.SE/0105018</a>&gt;.
     2367            </td>
     2368         </tr>
    23582369         <tr>
    23592370            <td class="reference"><b id="Nie1997">[Nie1997]</b></td>
    … …  
    24192430         </tr>
    24202431         <tr>
     2432            <td class="reference"><b id="RFC2109">[RFC2109]</b></td>
     2433            <td class="top"><a title="Bell Laboratories, Lucent Technologies">Kristol, D.M.</a> and <a title="Netscape Communications Corp.">L. Montulli</a>, “<a href="http://tools.ietf.org/html/rfc2109">HTTP State Management Mechanism</a>”, RFC&nbsp;2109, February&nbsp;1997.
     2434            </td>
     2435         </tr>
     2436         <tr>
    24212437            <td class="reference"><b id="RFC2145">[RFC2145]</b></td>
    24222438            <td class="top"><a title="Western Research Laboratory">Mogul, J.C.</a>, <a title="Department of Information and Computer Science">Fielding, R.T.</a>, <a title="MIT Laboratory for Computer Science">Gettys, J.</a>, and <a title="W3 Consortium">H.F. Nielsen</a>, “<a href="http://tools.ietf.org/html/rfc2145">Use and Interpretation of HTTP Version Numbers</a>”, RFC&nbsp;2145, May&nbsp;1997.
    … …  
    24412457            <td class="reference"><b id="RFC2822">[RFC2822]</b></td>
    24422458            <td class="top">Resnick, P., “<a href="http://tools.ietf.org/html/rfc2822">Internet Message Format</a>”, RFC&nbsp;2822, April&nbsp;2001.
     2459            </td>
     2460         </tr>
     2461         <tr>
     2462            <td class="reference"><b id="RFC2965">[RFC2965]</b></td>
     2463            <td class="top"><a title="Bell Laboratories, Lucent Technologies">Kristol, D. M.</a> and <a title="Epinions.com, Inc.">L. Montulli</a>, “<a href="http://tools.ietf.org/html/rfc2965">HTTP State Management Mechanism</a>”, RFC&nbsp;2965, October&nbsp;2000.
    24432464            </td>
    24442465         </tr>
    … …  
    27342755         <li> &lt;<a href="http://www3.tools.ietf.org/wg/httpbis/trac/ticket/127">http://www3.tools.ietf.org/wg/httpbis/trac/ticket/127</a>&gt;: "IANA Considerations: update HTTP URI scheme registration"
    27352756         </li>
     2757         <li> &lt;<a href="http://www3.tools.ietf.org/wg/httpbis/trac/ticket/129">http://www3.tools.ietf.org/wg/httpbis/trac/ticket/129</a>&gt;: "List-type headers vs Set-Cookie"
     2758         </li>
    27362759      </ul>
    27372760      <p id="rfc.section.D.5.p.2">Ongoing work on ABNF conversion (&lt;<a href="http://www3.tools.ietf.org/wg/httpbis/trac/ticket/36">http://www3.tools.ietf.org/wg/httpbis/trac/ticket/36</a>&gt;):
    … …  
    27662789      </p>
    27672790      <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1>
    2768       <p class="noprint"><a href="#rfc.index.A">A</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.D">D</a> <a href="#rfc.index.E">E</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.I">I</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.N">N</a> <a href="#rfc.index.O">O</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a> <a href="#rfc.index.T">T</a> <a href="#rfc.index.U">U</a> <a href="#rfc.index.V">V</a> <a href="#rfc.index.W">W</a>
     2791      <p class="noprint"><a href="#rfc.index.A">A</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.D">D</a> <a href="#rfc.index.E">E</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.I">I</a> <a href="#rfc.index.K">K</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.N">N</a> <a href="#rfc.index.O">O</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a> <a href="#rfc.index.T">T</a> <a href="#rfc.index.U">U</a> <a href="#rfc.index.V">V</a> <a href="#rfc.index.W">W</a>
    27692792      </p>
    27702793      <div class="print2col">
    … …  
    29202943               </ul>
    29212944            </li>
     2945            <li class="indline0"><a id="rfc.index.K" href="#rfc.index.K"><b>K</b></a><ul class="ind">
     2946                  <li class="indline1"><em>Kri2001</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.Kri2001.1">4.2</a>, <a class="iref" href="#Kri2001"><b>12.2</b></a></li>
     2947               </ul>
     2948            </li>
    29222949            <li class="indline0"><a id="rfc.index.M" href="#rfc.index.M"><b>M</b></a><ul class="ind">
    29232950                  <li class="indline1">Media Type&nbsp;&nbsp;
    … …  
    29983025                     </ul>
    29993026                  </li>
     3027                  <li class="indline1"><em>RFC2109</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC2109.1">4.2</a>, <a class="iref" href="#RFC2109"><b>12.2</b></a></li>
    30003028                  <li class="indline1"><em>RFC2119</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC2119.1">1.2</a>, <a class="iref" href="#RFC2119"><b>12.1</b></a>, <a class="iref" href="#rfc.xref.RFC2119.2">C.3</a></li>
    30013029                  <li class="indline1"><em>RFC2145</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC2145.1">3.1</a>, <a class="iref" href="#rfc.xref.RFC2145.2">3.1</a>, <a class="iref" href="#RFC2145"><b>12.2</b></a>, <a class="iref" href="#rfc.xref.RFC2145.3">C.3</a></li>
    … …  
    30203048                     </ul>
    30213049                  </li>
     3050                  <li class="indline1"><em>RFC2965</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC2965.1">4.2</a>, <a class="iref" href="#RFC2965"><b>12.2</b></a></li>
    30223051                  <li class="indline1"><em>RFC3864</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC3864.1">9.1</a>, <a class="iref" href="#RFC3864"><b>12.2</b></a></li>
    30233052                  <li class="indline1"><em>RFC3977</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC3977.1">1.1</a>, <a class="iref" href="#RFC3977"><b>12.2</b></a></li>

  • draft-ietf-httpbis/latest/p1-messaging.xml

    r309 r310  
    15791579   change the order of these field values when a message is forwarded.
    15801580</t>
     1581<t>
     1582  <list><t>
     1583   <x:h>Note:</x:h> the "Set-Cookie" header as implemented in
     1584   practice (as opposed to how it is specified in <xref target="RFC2109"/>)
     1585   can occur multiple times, but does not use the list syntax, and thus cannot
     1586   be combined into a single line. (See Appendix A.2.3 of <xref target="Kri2001"/>
     1587   for details.) Also note that the Set-Cookie2 header specified in
     1588   <xref target="RFC2965"/> does not share this problem.
     1589  </t></list>
     1590</t>
     1591 
    15811592</section>
    15821593
    … …  
    38913902</reference>
    38923903
     3904<reference anchor='RFC2109'>
     3905  <front>
     3906    <title>HTTP State Management Mechanism</title>
     3907    <author initials='D.M.' surname='Kristol' fullname='David M. Kristol'>
     3908      <organization>Bell Laboratories, Lucent Technologies</organization>
     3909      <address><email>dmk@bell-labs.com</email></address>
     3910    </author>
     3911    <author initials='L.' surname='Montulli' fullname='Lou Montulli'>
     3912      <organization>Netscape Communications Corp.</organization>
     3913      <address><email>montulli@netscape.com</email></address>
     3914    </author>
     3915    <date year='1997' month='February' />
     3916  </front>
     3917  <seriesInfo name='RFC' value='2109' />
     3918</reference>
     3919
    38933920<reference anchor="RFC2145">
    38943921  <front>
    … …  
    39844011  </front>
    39854012  <seriesInfo name="RFC" value="2822"/>
     4013</reference>
     4014
     4015<reference anchor='RFC2965'>
     4016  <front>
     4017    <title>HTTP State Management Mechanism</title>
     4018    <author initials='D. M.' surname='Kristol' fullname='David M. Kristol'>
     4019      <organization>Bell Laboratories, Lucent Technologies</organization>
     4020      <address><email>dmk@bell-labs.com</email></address>
     4021    </author>
     4022    <author initials='L.' surname='Montulli' fullname='Lou Montulli'>
     4023      <organization>Epinions.com, Inc.</organization>
     4024      <address><email>lou@montulli.org</email></address>
     4025    </author>
     4026    <date year='2000' month='October' />
     4027  </front>
     4028  <seriesInfo name='RFC' value='2965' />
    39864029</reference>
    39874030
    … …  
    40654108  <seriesInfo name='BCP' value='115' />
    40664109  <seriesInfo name='RFC' value='4395' />
     4110</reference>
     4111
     4112<reference anchor="Kri2001" target="http://arxiv.org/abs/cs.SE/0105018">
     4113  <front>
     4114    <title>HTTP Cookies: Standards, Privacy, and Politics</title>
     4115    <author initials="D." surname="Kristol" fullname="David M. Kristol">
     4116      <organization/>
     4117    </author>
     4118    <date year="2001" month="November"/>
     4119  </front>
     4120  <seriesInfo name="ACM Transactions on Internet Technology" value="Vol. 1, #2"/>
    40674121</reference>
    40684122
    … …  
    46014655      "IANA Considerations: update HTTP URI scheme registration"
    46024656    </t>
     4657    <t>
     4658      <eref target="http://www3.tools.ietf.org/wg/httpbis/trac/ticket/129"/>:
     4659      "List-type headers vs Set-Cookie"
     4660    </t>
    46034661  </list>
    46044662</t>
Note: See TracChangeset for help on using the changeset viewer.