Changeset 2073


Ignore:
Timestamp:
Dec 31, 2012, 3:02:54 AM (7 years ago)
Author:
fielding@…
Message:

fix several more cases of include being used instead of send or generate, and a few requirements that are simply facts

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

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p2-semantics.html

    r2072 r2073  
    20982098      <p id="rfc.section.5.5.3.p.1">The "User-Agent" header field contains information about the user agent originating the request, which is often used by servers
    20992099         to help identify the scope of reported interoperability problems, to work around or tailor responses to avoid particular user
    2100          agent limitations, and for analytics regarding browser or operating system use. A user agent <em class="bcp14">SHOULD</em> include a User-Agent field in each request unless specifically configured not to do so.
     2100         agent limitations, and for analytics regarding browser or operating system use. A user agent <em class="bcp14">SHOULD</em> send a User-Agent field in each request unless specifically configured not to do so.
    21012101      </p>
    21022102      <div id="rfc.figure.u.38"></div><pre class="inline"><span id="rfc.iref.g.36"></span>  <a href="#header.user-agent" class="smpl">User-Agent</a> = <a href="#header.user-agent" class="smpl">product</a> *( <a href="#imported.abnf" class="smpl">RWS</a> ( <a href="#header.user-agent" class="smpl">product</a> / <a href="#imported.abnf" class="smpl">comment</a> ) )
     
    27262726      <div id="rfc.iref.s.6"></div>
    27272727      <p id="rfc.section.6.6.p.1">The <dfn>5xx (Server Error)</dfn> class of status code indicates that the server is aware that it has erred or is incapable of performing the requested method.
    2728          Except when responding to a HEAD request, the server <em class="bcp14">SHOULD</em> include a representation containing an explanation of the error situation, and whether it is a temporary or permanent condition.
     2728         Except when responding to a HEAD request, the server <em class="bcp14">SHOULD</em> send a representation containing an explanation of the error situation, and whether it is a temporary or permanent condition.
    27292729         User agents <em class="bcp14">SHOULD</em> display any included representation to the user. These response codes are applicable to any request method.
    27302730      </p>
     
    28132813</pre><p id="rfc.section.7.1.1.1.p.5">HTTP/1.1 clients and servers that parse a date value <em class="bcp14">MUST</em> accept all three formats (for compatibility with HTTP/1.0), though they <em class="bcp14">MUST</em> only generate the RFC 1123 format for representing HTTP-date values in header fields.
    28142814      </p>
    2815       <p id="rfc.section.7.1.1.1.p.6">All HTTP date/time stamps <em class="bcp14">MUST</em> be represented in Greenwich Mean Time (GMT), without exception. For the purposes of HTTP, GMT is exactly equal to UTC (Coordinated
    2816          Universal Time). This is indicated in the first two formats by the inclusion of "GMT" as the three-letter abbreviation for
    2817          time zone, and <em class="bcp14">MUST</em> be assumed when reading the asctime format. HTTP-date is case sensitive and <em class="bcp14">MUST NOT</em> include additional whitespace beyond that specifically included as SP in the grammar.
     2815      <p id="rfc.section.7.1.1.1.p.6">All HTTP date/time stamps are represented in Greenwich Mean Time (GMT), without exception. For the purposes of HTTP, GMT is
     2816         exactly equal to UTC (Coordinated Universal Time). This is indicated in the first two formats by the inclusion of "GMT" as
     2817         the three-letter abbreviation for time zone, and is assumed when reading the asctime format. HTTP-date is case sensitive.
     2818         A sender <em class="bcp14">MUST NOT</em> generate additional whitespace in an HTTP-date beyond that specifically included as SP in the grammar.
    28182819      </p>
    28192820      <div id="rfc.figure.u.44"></div><pre class="inline"><span id="rfc.iref.g.39"></span>  <a href="#http.date" class="smpl">HTTP-date</a>    = <a href="#preferred.date.format" class="smpl">rfc1123-date</a> / <a href="#obsolete.date.formats" class="smpl">obs-date</a>
  • draft-ietf-httpbis/latest/p2-semantics.xml

    r2072 r2073  
    24392439   the scope of reported interoperability problems, to work around or tailor
    24402440   responses to avoid particular user agent limitations, and for analytics
    2441    regarding browser or operating system use. A user agent &SHOULD; include
     2441   regarding browser or operating system use. A user agent &SHOULD; send
    24422442   a User-Agent field in each request unless specifically configured not
    24432443   to do so.
     
    33893389<t>
    33903390   The <x:dfn>5xx (Server Error)</x:dfn> class of status code indicates that
    3391    the server is aware that it has erred or is incapable of
    3392    performing the requested method. Except when responding to a HEAD request, the
    3393    server &SHOULD; include a representation containing an explanation of the
    3394    error situation, and whether it is a temporary or permanent
    3395    condition. User agents &SHOULD; display any included representation to the
    3396    user. These response codes are applicable to any request method.
     3391   the server is aware that it has erred or is incapable of performing the
     3392   requested method.
     3393   Except when responding to a HEAD request, the server &SHOULD; send a
     3394   representation containing an explanation of the error situation, and
     3395   whether it is a temporary or permanent condition.
     3396   User agents &SHOULD; display any included representation to the user.
     3397   These response codes are applicable to any request method.
    33973398</t>
    33983399
     
    35323533</t>
    35333534<t>
    3534    All HTTP date/time stamps &MUST; be represented in Greenwich Mean Time
     3535   All HTTP date/time stamps are represented in Greenwich Mean Time
    35353536   (GMT), without exception. For the purposes of HTTP, GMT is exactly
    35363537   equal to UTC (Coordinated Universal Time). This is indicated in the
    35373538   first two formats by the inclusion of "GMT" as the three-letter
    3538    abbreviation for time zone, and &MUST; be assumed when reading the
    3539    asctime format. HTTP-date is case sensitive and &MUST-NOT; include
    3540    additional whitespace beyond that specifically included as SP in the
    3541    grammar.
     3539   abbreviation for time zone, and is assumed when reading the
     3540   asctime format. HTTP-date is case sensitive. A sender &MUST-NOT; generate
     3541   additional whitespace in an HTTP-date beyond that specifically included as
     3542   SP in the grammar.
    35423543</t>
    35433544<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="HTTP-date"/>
  • draft-ietf-httpbis/latest/p5-range.html

    r2069 r2073  
    449449  }
    450450  @bottom-center {
    451        content: "Expires July 3, 2013";
     451       content: "Expires July 4, 2013";
    452452  }
    453453  @bottom-right {
     
    493493      <meta name="dct.creator" content="Reschke, J. F.">
    494494      <meta name="dct.identifier" content="urn:ietf:id:draft-ietf-httpbis-p5-range-latest">
    495       <meta name="dct.issued" scheme="ISO8601" content="2012-12-30">
     495      <meta name="dct.issued" scheme="ISO8601" content="2012-12-31">
    496496      <meta name="dct.replaces" content="urn:ietf:rfc:2616">
    497497      <meta name="dct.abstract" content="The Hypertext Transfer Protocol (HTTP) is an application-level protocol for distributed, collaborative, hypertext information systems. This document defines range requests and the rules for constructing and combining responses to those requests.">
     
    519519            </tr>
    520520            <tr>
    521                <td class="left">Expires: July 3, 2013</td>
     521               <td class="left">Expires: July 4, 2013</td>
    522522               <td class="right">J. Reschke, Editor</td>
    523523            </tr>
     
    528528            <tr>
    529529               <td class="left"></td>
    530                <td class="right">December 30, 2012</td>
     530               <td class="right">December 31, 2012</td>
    531531            </tr>
    532532         </tbody>
     
    553553         in progress”.
    554554      </p>
    555       <p>This Internet-Draft will expire on July 3, 2013.</p>
     555      <p>This Internet-Draft will expire on July 4, 2013.</p>
    556556      <h1><a id="rfc.copyrightnotice" href="#rfc.copyrightnotice">Copyright Notice</a></h1>
    557557      <p>Copyright © 2012 IETF Trust and the persons identified as the document authors. All rights reserved.</p>
     
    803803      </p>
    804804      <p id="rfc.section.5.2.p.7">In the case of a byte range request: a server sending a response with status code <a href="#status.416" class="smpl">416 (Requested Range Not
    805             Satisfiable)</a>  <em class="bcp14">SHOULD</em> include a Content-Range field with a byte-range-resp-spec of "*". The instance-length specifies the current length of the
    806          selected resource. A response with status code <a href="#status.206" class="smpl">206 (Partial Content)</a>  <em class="bcp14">MUST NOT</em> include a Content-Range field with a byte-range-resp-spec of "*".
     805            Satisfiable)</a>  <em class="bcp14">SHOULD</em> send a Content-Range field with a byte-range-resp-spec of "*". The instance-length specifies the current length of the selected
     806         resource. A response with status code <a href="#status.206" class="smpl">206 (Partial Content)</a>  <em class="bcp14">MUST NOT</em> send a Content-Range field with a byte-range-resp-spec of "*".
    807807      </p>
    808808      <p id="rfc.section.5.2.p.8">The "Content-Range" header field has no meaning for status codes that do not explicitly describe its semantic. Currently,
  • draft-ietf-httpbis/latest/p5-range.xml

    r2069 r2073  
    522522   In the case of a byte range request:
    523523   a server sending a response with status code <x:ref>416 (Requested Range Not
    524    Satisfiable)</x:ref> &SHOULD; include a Content-Range field with a byte-range-resp-spec
     524   Satisfiable)</x:ref> &SHOULD; send a Content-Range field with a byte-range-resp-spec
    525525   of "*". The instance-length specifies the current length of
    526526   the selected resource. A response with status code <x:ref>206 (Partial Content)</x:ref>
    527    &MUST-NOT; include a Content-Range field with a byte-range-resp-spec of "*".
     527   &MUST-NOT; send a Content-Range field with a byte-range-resp-spec of "*".
    528528</t>
    529529<t>
  • draft-ietf-httpbis/latest/p6-cache.html

    r2069 r2073  
    452452  }
    453453  @bottom-center {
    454        content: "Expires July 3, 2013";
     454       content: "Expires July 4, 2013";
    455455  }
    456456  @bottom-right {
     
    498498      <meta name="dct.creator" content="Reschke, J. F.">
    499499      <meta name="dct.identifier" content="urn:ietf:id:draft-ietf-httpbis-p6-cache-latest">
    500       <meta name="dct.issued" scheme="ISO8601" content="2012-12-30">
     500      <meta name="dct.issued" scheme="ISO8601" content="2012-12-31">
    501501      <meta name="dct.replaces" content="urn:ietf:rfc:2616">
    502502      <meta name="dct.abstract" content="The Hypertext Transfer Protocol (HTTP) is an application-level protocol for distributed, collaborative, hypertext information systems. This document defines requirements on HTTP caches and the associated header fields that control cache behavior or indicate cacheable response messages.">
     
    524524            </tr>
    525525            <tr>
    526                <td class="left">Expires: July 3, 2013</td>
     526               <td class="left">Expires: July 4, 2013</td>
    527527               <td class="right">J. Reschke, Editor</td>
    528528            </tr>
     
    533533            <tr>
    534534               <td class="left"></td>
    535                <td class="right">December 30, 2012</td>
     535               <td class="right">December 31, 2012</td>
    536536            </tr>
    537537         </tbody>
     
    559559         in progress”.
    560560      </p>
    561       <p>This Internet-Draft will expire on July 3, 2013.</p>
     561      <p>This Internet-Draft will expire on July 4, 2013.</p>
    562562      <h1><a id="rfc.copyrightnotice" href="#rfc.copyrightnotice">Copyright Notice</a></h1>
    563563      <p>Copyright © 2012 IETF Trust and the persons identified as the document authors. All rights reserved.</p>
     
    15241524      <div id="rfc.iref.52"></div>
    15251525      <h3 id="rfc.section.7.5.1"><a href="#rfc.section.7.5.1">7.5.1</a>&nbsp;<a id="warn.110" href="#warn.110">110 Response is Stale</a></h3>
    1526       <p id="rfc.section.7.5.1.p.1">A cache <em class="bcp14">SHOULD</em> include this whenever the sent response is stale.
     1526      <p id="rfc.section.7.5.1.p.1">A cache <em class="bcp14">SHOULD</em> generate this whenever the sent response is stale.
    15271527      </p>
    15281528      <div id="rfc.iref.52"></div>
    15291529      <h3 id="rfc.section.7.5.2"><a href="#rfc.section.7.5.2">7.5.2</a>&nbsp;<a id="warn.111" href="#warn.111">111 Revalidation Failed</a></h3>
    1530       <p id="rfc.section.7.5.2.p.1">A cache <em class="bcp14">SHOULD</em> include this when sending a stale response because an attempt to validate the response failed, due to an inability to reach
     1530      <p id="rfc.section.7.5.2.p.1">A cache <em class="bcp14">SHOULD</em> generate this when sending a stale response because an attempt to validate the response failed, due to an inability to reach
    15311531         the server.
    15321532      </p>
    15331533      <div id="rfc.iref.52"></div>
    15341534      <h3 id="rfc.section.7.5.3"><a href="#rfc.section.7.5.3">7.5.3</a>&nbsp;<a id="warn.112" href="#warn.112">112 Disconnected Operation</a></h3>
    1535       <p id="rfc.section.7.5.3.p.1">A cache <em class="bcp14">SHOULD</em> include this if it is intentionally disconnected from the rest of the network for a period of time.
     1535      <p id="rfc.section.7.5.3.p.1">A cache <em class="bcp14">SHOULD</em> generate this if it is intentionally disconnected from the rest of the network for a period of time.
    15361536      </p>
    15371537      <div id="rfc.iref.52"></div>
    15381538      <h3 id="rfc.section.7.5.4"><a href="#rfc.section.7.5.4">7.5.4</a>&nbsp;<a id="warn.113" href="#warn.113">113 Heuristic Expiration</a></h3>
    1539       <p id="rfc.section.7.5.4.p.1">A cache <em class="bcp14">SHOULD</em> include this if it heuristically chose a freshness lifetime greater than 24 hours and the response's age is greater than 24
    1540          hours.
     1539      <p id="rfc.section.7.5.4.p.1">A cache <em class="bcp14">SHOULD</em> generate this if it heuristically chose a freshness lifetime greater than 24 hours and the response's age is greater than
     1540         24 hours.
    15411541      </p>
    15421542      <div id="rfc.iref.52"></div>
  • draft-ietf-httpbis/latest/p6-cache.xml

    r2069 r2073  
    17831783  <iref primary="true" item="110 Response is Stale (warn code)" x:for-anchor=""/>
    17841784<t>
    1785    A cache &SHOULD; include this whenever the sent response is stale.
     1785   A cache &SHOULD; generate this whenever the sent response is stale.
    17861786</t>
    17871787</section>
     
    17901790  <iref primary="true" item="111 Revalidation Failed (warn code)" x:for-anchor=""/>
    17911791<t>
    1792    A cache &SHOULD; include this when sending a stale response because an
     1792   A cache &SHOULD; generate this when sending a stale response because an
    17931793   attempt to validate the response failed, due to an inability to reach
    17941794   the server.
     
    17991799  <iref primary="true" item="112 Disconnected Operation (warn code)" x:for-anchor=""/>
    18001800<t>
    1801    A cache &SHOULD; include this if it is intentionally disconnected from
     1801   A cache &SHOULD; generate this if it is intentionally disconnected from
    18021802   the rest of the network for a period of time.
    18031803</t>
     
    18071807  <iref primary="true" item="113 Heuristic Expiration (warn code)" x:for-anchor=""/>
    18081808<t>
    1809    A cache &SHOULD; include this if it heuristically chose a freshness
     1809   A cache &SHOULD; generate this if it heuristically chose a freshness
    18101810   lifetime greater than 24 hours and the response's age is greater than 24
    18111811   hours.
Note: See TracChangeset for help on using the changeset viewer.