Ignore:
Timestamp:
Jan 29, 2012, 5:48:21 PM (8 years ago)
Author:
fielding@…
Message:

Streamline the meaty sections by moving the miscellaneous conformance
and error handling down where it is applicable, and the ABNF stuff only
used by header fields down to the header fields sections. Simplify
the reference to ABNF in all parts.

Clarify what stateless means for HTTP and correct overstatement
about connection-based authentication. Move discussion of streaming
to where it belongs.

Clarify section on request-target by reordering it by common types
and use an example that has path and query. Provide an example
for CONNECT authority-form. Remove obsolete note about the "no rewrite" rule.

File:
1 edited

Legend:

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

    r1516 r1518  
    2727  <!ENTITY content-negotiation        "<xref target='Part3' x:rel='#content.negotiation' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    2828  <!ENTITY agent-driven-negotiation   "<xref target='Part3' x:rel='#agent-driven.negotiation' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    29   <!ENTITY notation-abnf              "<xref target='Part1' x:rel='#notation.abnf' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    30   <!ENTITY basic-rules                "<xref target='Part1' x:rel='#basic.rules' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    31   <!ENTITY field-rules                "<xref target='Part1' x:rel='#field.rules' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     29  <!ENTITY abnf-extension             "<xref target='Part1' x:rel='#abnf.extension' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     30  <!ENTITY whitespace                 "<xref target='Part1' x:rel='#whitespace' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     31  <!ENTITY field-components           "<xref target='Part1' x:rel='#field.components' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3232  <!ENTITY uri                        "<xref target='Part1' x:rel='#uri' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3333  <!ENTITY effective-request-uri      "<xref target='Part1' x:rel='#effective.request.uri' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     
    346346  <x:anchor-alias value="SP"/>
    347347<t>
    348   This specification uses the ABNF syntax defined in &notation; (which
    349   extends the syntax defined in <xref target="RFC5234"/> with a list rule).
    350   <xref target="collected.abnf"/> shows the collected ABNF, with the list
    351   rule expanded.
     348   This specification uses the Augmented Backus-Naur Form (ABNF) notation
     349   of <xref target="RFC5234"/> with the list rule extension defined in
     350   &notation;.  <xref target="collected.abnf"/> shows the collected ABNF
     351   with the list rule expanded.
    352352</t>
    353353<t>
     
    372372</t>
    373373<figure><artwork type="abnf2616">
    374   <x:ref>BWS</x:ref>           = &lt;BWS, defined in &basic-rules;&gt;
    375   <x:ref>OWS</x:ref>           = &lt;OWS, defined in &basic-rules;&gt;
    376   <x:ref>RWS</x:ref>           = &lt;RWS, defined in &basic-rules;&gt;
    377   <x:ref>obs-text</x:ref>      = &lt;obs-text, defined in &basic-rules;&gt;
    378   <x:ref>quoted-string</x:ref> = &lt;quoted-string, defined in &field-rules;&gt;
    379   <x:ref>token</x:ref>         = &lt;token, defined in &field-rules;&gt;
     374  <x:ref>BWS</x:ref>           = &lt;BWS, defined in &whitespace;&gt;
     375  <x:ref>OWS</x:ref>           = &lt;OWS, defined in &whitespace;&gt;
     376  <x:ref>RWS</x:ref>           = &lt;RWS, defined in &whitespace;&gt;
     377  <x:ref>obs-text</x:ref>      = &lt;obs-text, defined in &field-components;&gt;
     378  <x:ref>quoted-string</x:ref> = &lt;quoted-string, defined in &field-components;&gt;
     379  <x:ref>token</x:ref>         = &lt;token, defined in &field-components;&gt;
    380380</artwork></figure>
    381381</section>
     
    392392<figure><!--Part1--><artwork type="abnf2616">
    393393  <x:ref>absolute-URI</x:ref>  = &lt;absolute-URI, defined in &uri;&gt;
    394   <x:ref>comment</x:ref>       = &lt;comment, defined in &field-rules;&gt;
     394  <x:ref>comment</x:ref>       = &lt;comment, defined in &field-components;&gt;
    395395  <x:ref>partial-URI</x:ref>   = &lt;partial-URI, defined in &uri;&gt;
    396396  <x:ref>product</x:ref>       = &lt;product, defined in &product-tokens;&gt;
     
    525525<t>
    526526   New header field values typically have their syntax defined using ABNF
    527    (<xref target="RFC5234"/>), using the extensions defined in &notation-abnf;
     527   (<xref target="RFC5234"/>), using the extension defined in &abnf-extension;
    528528   as necessary, and are usually constrained to the range of ASCII characters.
    529529   Header fields needing a greater range of characters can use an encoding
     
    534534   they need to be treated with care if they are allowed in the field-value's
    535535   payload. Typically, components that might contain a comma are protected with
    536    double-quotes using the quoted-string ABNF production (&field-rules;).
     536   double-quotes using the quoted-string ABNF production (&field-components;).
    537537</t>
    538538<t>
Note: See TracChangeset for help on using the changeset viewer.