Ignore:
Timestamp:
02/09/12 21:05:07 (10 years ago)
Author:
fielding@…
Message:

(editorial) add intros for request field categories

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

Legend:

Unmodified
Added
Removed

  • draft-ietf-httpbis/latest/p2-semantics.html

    r1852 r1853  
    619619               <li><a href="#rfc.section.5.3">5.3</a>&nbsp;&nbsp;&nbsp;<a href="#request.conneg">Content Negotiation</a></li>
    620620               <li><a href="#rfc.section.5.4">5.4</a>&nbsp;&nbsp;&nbsp;<a href="#request.auth">Authentication</a></li>
    621                <li><a href="#rfc.section.5.5">5.5</a>&nbsp;&nbsp;&nbsp;<a href="#request.inform">Information</a></li>
     621               <li><a href="#rfc.section.5.5">5.5</a>&nbsp;&nbsp;&nbsp;<a href="#request.context">Context</a></li>
    622622            </ul>
    623623         </li>
    … …  
    13321332      </p>
    13331333      <h1 id="rfc.section.5"><a href="#rfc.section.5">5.</a>&nbsp;<a id="request.header.fields" href="#request.header.fields">Request Header Fields</a></h1>
    1334       <p id="rfc.section.5.p.1">The request header fields allow the client to pass additional information about the request, and about the client itself,
    1335          to the server. These fields act as request modifiers, with semantics equivalent to the parameters on a programming language
    1336          method invocation.
     1334      <p id="rfc.section.5.p.1">A client sends request header fields to provide more information about the request context, make the request conditional based
     1335         on the target resource state, suggest preferred formats for the response, supply authentication credentials, or modify the
     1336         expected request processing. These fields act as request modifiers, similar to the parameters on a programming language method
     1337         invocation.
    13371338      </p>
    13381339      <h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a>&nbsp;<a id="request.controls" href="#request.controls">Controls</a></h2>
     1340      <p id="rfc.section.5.1.p.1">Controls are request header fields that direct specific handling of the request.</p>
    13391341      <div id="rfc.table.u.3">
    13401342         <table class="tt full left" cellpadding="3" cellspacing="0">
    … …  
    13661368      </div>
    13671369      <h2 id="rfc.section.5.2"><a href="#rfc.section.5.2">5.2</a>&nbsp;<a id="request.conditionals" href="#request.conditionals">Conditionals</a></h2>
     1370      <p id="rfc.section.5.2.p.1">Conditionals are request header fields that indicate a precondition to be tested before applying the method semantics to the
     1371         target resource. Each precondition is based on metadata that is expected to change if the selected representation of the target
     1372         resource is changed. The HTTP/1.1 conditional request mechanisms are defined in <a href="#Part4" id="rfc.xref.Part4.4"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>.
     1373      </p>
    13681374      <div id="rfc.table.u.4">
    13691375         <table class="tt full left" cellpadding="3" cellspacing="0">
    … …  
    13771383               <tr>
    13781384                  <td class="left">If-Match</td>
    1379                   <td class="left"><a href="p4-conditional.html#header.if-match" title="If-Match">Section 3.1</a> of <a href="#Part4" id="rfc.xref.Part4.4"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
     1385                  <td class="left"><a href="p4-conditional.html#header.if-match" title="If-Match">Section 3.1</a> of <a href="#Part4" id="rfc.xref.Part4.5"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
    13801386               </tr>
    13811387               <tr>
    13821388                  <td class="left">If-None-Match</td>
    1383                   <td class="left"><a href="p4-conditional.html#header.if-none-match" title="If-None-Match">Section 3.2</a> of <a href="#Part4" id="rfc.xref.Part4.5"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
     1389                  <td class="left"><a href="p4-conditional.html#header.if-none-match" title="If-None-Match">Section 3.2</a> of <a href="#Part4" id="rfc.xref.Part4.6"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
    13841390               </tr>
    13851391               <tr>
    13861392                  <td class="left">If-Modified-Since</td>
    1387                   <td class="left"><a href="p4-conditional.html#header.if-modified-since" title="If-Modified-Since">Section 3.3</a> of <a href="#Part4" id="rfc.xref.Part4.6"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
     1393                  <td class="left"><a href="p4-conditional.html#header.if-modified-since" title="If-Modified-Since">Section 3.3</a> of <a href="#Part4" id="rfc.xref.Part4.7"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
    13881394               </tr>
    13891395               <tr>
    13901396                  <td class="left">If-Unmodified-Since</td>
    1391                   <td class="left"><a href="p4-conditional.html#header.if-unmodified-since" title="If-Unmodified-Since">Section 3.4</a> of <a href="#Part4" id="rfc.xref.Part4.7"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
     1397                  <td class="left"><a href="p4-conditional.html#header.if-unmodified-since" title="If-Unmodified-Since">Section 3.4</a> of <a href="#Part4" id="rfc.xref.Part4.8"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
    13921398               </tr>
    13931399               <tr>
    … …  
    14481454         </table>
    14491455      </div>
    1450       <h2 id="rfc.section.5.5"><a href="#rfc.section.5.5">5.5</a>&nbsp;<a id="request.inform" href="#request.inform">Information</a></h2>
     1456      <h2 id="rfc.section.5.5"><a href="#rfc.section.5.5">5.5</a>&nbsp;<a id="request.context" href="#request.context">Context</a></h2>
    14511457      <div id="rfc.table.u.7">
    14521458         <table class="tt full left" cellpadding="3" cellspacing="0">
    … …  
    15031509      </p>
    15041510      <h2 id="rfc.section.6.1"><a href="#rfc.section.6.1">6.1</a>&nbsp;<a id="overview.of.status.codes" href="#overview.of.status.codes">Overview of Status Codes</a></h2>
    1505       <p id="rfc.section.6.1.p.1">The status codes listed below are defined in this specification, <a href="p4-conditional.html#status.code.definitions" title="Status Code Definitions">Section 4</a> of <a href="#Part4" id="rfc.xref.Part4.8"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>, <a href="p5-range.html#status.code.definitions" title="Status Code Definitions">Section 3</a> of <a href="#Part5" id="rfc.xref.Part5.6"><cite title="HTTP/1.1, part 5: Range Requests">[Part5]</cite></a>, and <a href="p7-auth.html#status.code.definitions" title="Status Code Definitions">Section 3</a> of <a href="#Part7" id="rfc.xref.Part7.3"><cite title="HTTP/1.1, part 7: Authentication">[Part7]</cite></a>. The reason phrases listed here are only recommendations — they can be replaced by local equivalents without affecting the
     1511      <p id="rfc.section.6.1.p.1">The status codes listed below are defined in this specification, <a href="p4-conditional.html#status.code.definitions" title="Status Code Definitions">Section 4</a> of <a href="#Part4" id="rfc.xref.Part4.9"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>, <a href="p5-range.html#status.code.definitions" title="Status Code Definitions">Section 3</a> of <a href="#Part5" id="rfc.xref.Part5.6"><cite title="HTTP/1.1, part 5: Range Requests">[Part5]</cite></a>, and <a href="p7-auth.html#status.code.definitions" title="Status Code Definitions">Section 3</a> of <a href="#Part7" id="rfc.xref.Part7.3"><cite title="HTTP/1.1, part 7: Authentication">[Part7]</cite></a>. The reason phrases listed here are only recommendations — they can be replaced by local equivalents without affecting the
    15061512         protocol.
    15071513      </p>
    … …  
    15841590                  <td class="left">304</td>
    15851591                  <td class="left">Not Modified</td>
    1586                   <td id="status.304" class="left"><a href="p4-conditional.html#status.304" title="304 Not Modified">Section 4.1</a> of <a href="#Part4" id="rfc.xref.Part4.9"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
     1592                  <td id="status.304" class="left"><a href="p4-conditional.html#status.304" title="304 Not Modified">Section 4.1</a> of <a href="#Part4" id="rfc.xref.Part4.10"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
    15871593               </tr>
    15881594               <tr>
    … …  
    16591665                  <td class="left">412</td>
    16601666                  <td class="left">Precondition Failed</td>
    1661                   <td id="status.412" class="left"><a href="p4-conditional.html#status.412" title="412 Precondition Failed">Section 4.2</a> of <a href="#Part4" id="rfc.xref.Part4.10"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
     1667                  <td id="status.412" class="left"><a href="p4-conditional.html#status.412" title="412 Precondition Failed">Section 4.2</a> of <a href="#Part4" id="rfc.xref.Part4.11"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
    16621668               </tr>
    16631669               <tr>
    … …  
    17871793      </p>
    17881794      <p id="rfc.section.6.3.2.p.4">A 201 response <em class="bcp14">MAY</em> contain an <a href="p4-conditional.html#header.etag" class="smpl">ETag</a> response header field indicating the current value of the entity-tag for the representation of the resource identified by
    1789          the <a href="#header.location" class="smpl">Location</a> header field or, in case the Location header field was omitted, by the Effective Request URI (see <a href="p4-conditional.html#header.etag" title="ETag">Section 2.3</a> of <a href="#Part4" id="rfc.xref.Part4.11"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>).
     1795         the <a href="#header.location" class="smpl">Location</a> header field or, in case the Location header field was omitted, by the Effective Request URI (see <a href="p4-conditional.html#header.etag" title="ETag">Section 2.3</a> of <a href="#Part4" id="rfc.xref.Part4.12"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>).
    17901796      </p>
    17911797      <div id="rfc.iref.29"></div>
    … …  
    18671873         <li>
    18681874            <p>Other kinds of redirection, such as to a cached result (status code <a href="p4-conditional.html#status.304" class="smpl">304
    1869                   (Not Modified)</a>, see <a href="p4-conditional.html#status.304" title="304 Not Modified">Section 4.1</a> of <a href="#Part4" id="rfc.xref.Part4.12"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>).
     1875                  (Not Modified)</a>, see <a href="p4-conditional.html#status.304" title="304 Not Modified">Section 4.1</a> of <a href="#Part4" id="rfc.xref.Part4.13"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>).
    18701876            </p>
    18711877         </li>
    … …  
    21962202               <tr>
    21972203                  <td class="left">ETag</td>
    2198                   <td class="left"><a href="p4-conditional.html#header.etag" title="ETag">Section 2.3</a> of <a href="#Part4" id="rfc.xref.Part4.13"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
     2204                  <td class="left"><a href="p4-conditional.html#header.etag" title="ETag">Section 2.3</a> of <a href="#Part4" id="rfc.xref.Part4.14"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
    21992205               </tr>
    22002206               <tr>
    … …  
    43104316      <p id="rfc.section.F.2.p.2">Other changes: </p>
    43114317      <ul>
    4312          <li>Move definitions of 304 and 412 condition codes to <a href="#Part4" id="rfc.xref.Part4.14"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>
     4318         <li>Move definitions of 304 and 412 condition codes to <a href="#Part4" id="rfc.xref.Part4.15"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>
    43134319         </li>
    43144320      </ul>
    … …  
    51125118                     </ul>
    51135119                  </li>
    5114                   <li><em>Part4</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.1">3.2</a>, <a href="#rfc.xref.Part4.2">3.2</a>, <a href="#rfc.xref.Part4.3">4.3.1</a>, <a href="#rfc.xref.Part4.4">5.2</a>, <a href="#rfc.xref.Part4.5">5.2</a>, <a href="#rfc.xref.Part4.6">5.2</a>, <a href="#rfc.xref.Part4.7">5.2</a>, <a href="#rfc.xref.Part4.8">6.1</a>, <a href="#rfc.xref.Part4.9">6.1</a>, <a href="#rfc.xref.Part4.10">6.1</a>, <a href="#rfc.xref.Part4.11">6.3.2</a>, <a href="#rfc.xref.Part4.12">6.4</a>, <a href="#rfc.xref.Part4.13">7</a>, <a href="#Part4"><b>15.1</b></a>, <a href="#rfc.xref.Part4.14">F.2</a><ul>
     5120                  <li><em>Part4</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.1">3.2</a>, <a href="#rfc.xref.Part4.2">3.2</a>, <a href="#rfc.xref.Part4.3">4.3.1</a>, <a href="#rfc.xref.Part4.4">5.2</a>, <a href="#rfc.xref.Part4.5">5.2</a>, <a href="#rfc.xref.Part4.6">5.2</a>, <a href="#rfc.xref.Part4.7">5.2</a>, <a href="#rfc.xref.Part4.8">5.2</a>, <a href="#rfc.xref.Part4.9">6.1</a>, <a href="#rfc.xref.Part4.10">6.1</a>, <a href="#rfc.xref.Part4.11">6.1</a>, <a href="#rfc.xref.Part4.12">6.3.2</a>, <a href="#rfc.xref.Part4.13">6.4</a>, <a href="#rfc.xref.Part4.14">7</a>, <a href="#Part4"><b>15.1</b></a>, <a href="#rfc.xref.Part4.15">F.2</a><ul>
    51155121                        <li><em>Section 2.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.2">3.2</a></li>
    5116                         <li><em>Section 2.3</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.1">3.2</a>, <a href="#rfc.xref.Part4.11">6.3.2</a>, <a href="#rfc.xref.Part4.13">7</a></li>
    5117                         <li><em>Section 3.1</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.4">5.2</a></li>
    5118                         <li><em>Section 3.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.5">5.2</a></li>
    5119                         <li><em>Section 3.3</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.6">5.2</a></li>
    5120                         <li><em>Section 3.4</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.7">5.2</a></li>
    5121                         <li><em>Section 4</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.8">6.1</a></li>
    5122                         <li><em>Section 4.1</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.9">6.1</a>, <a href="#rfc.xref.Part4.12">6.4</a></li>
    5123                         <li><em>Section 4.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.10">6.1</a></li>
     5122                        <li><em>Section 2.3</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.1">3.2</a>, <a href="#rfc.xref.Part4.12">6.3.2</a>, <a href="#rfc.xref.Part4.14">7</a></li>
     5123                        <li><em>Section 3.1</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.5">5.2</a></li>
     5124                        <li><em>Section 3.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.6">5.2</a></li>
     5125                        <li><em>Section 3.3</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.7">5.2</a></li>
     5126                        <li><em>Section 3.4</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.8">5.2</a></li>
     5127                        <li><em>Section 4</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.9">6.1</a></li>
     5128                        <li><em>Section 4.1</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.10">6.1</a>, <a href="#rfc.xref.Part4.13">6.4</a></li>
     5129                        <li><em>Section 4.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.11">6.1</a></li>
    51245130                     </ul>
    51255131                  </li>

  • draft-ietf-httpbis/latest/p2-semantics.xml

    r1852 r1853  
    11351135  <x:anchor-alias value="request-header"/>
    11361136<t>
    1137    The request header fields allow the client to pass additional
    1138    information about the request, and about the client itself, to the
    1139    server. These fields act as request modifiers, with semantics
    1140    equivalent to the parameters on a programming language method
    1141    invocation.
     1137   A client sends request header fields to provide more information about
     1138   the request context, make the request conditional based on the target
     1139   resource state, suggest preferred formats for the response, supply
     1140   authentication credentials, or modify the expected request processing.
     1141   These fields act as request modifiers, similar to the parameters on a
     1142   programming language method invocation.
    11421143</t>
    11431144<section title="Controls" anchor="request.controls">
     1145<t>
     1146   Controls are request header fields that direct specific handling of the
     1147   request.
     1148</t>
    11441149<texttable align="left">
    11451150  <ttcol>Header Field Name</ttcol>
    … …  
    11541159
    11551160<section title="Conditionals" anchor="request.conditionals">
     1161<t>
     1162   Conditionals are request header fields that indicate a precondition to be
     1163   tested before applying the method semantics to the target resource.
     1164   Each precondition is based on metadata that is expected to change if the
     1165   selected representation of the target resource is changed.  The HTTP/1.1
     1166   conditional request mechanisms are defined in <xref target="Part4"/>.
     1167</t>
    11561168<texttable align="left">
    11571169  <ttcol>Header Field Name</ttcol>
    … …  
    11881200</section>
    11891201
    1190 <section title="Information" anchor="request.inform">
     1202<section title="Context" anchor="request.context">
    11911203<texttable align="left">
    11921204  <ttcol>Header Field Name</ttcol>
Note: See TracChangeset for help on using the changeset viewer.