Changeset 1518 for draft-ietf-httpbis/latest/p2-semantics.xml

Timestamp:

30/01/12 01:48:21 (10 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:

• draft-ietf-httpbis/latest/p2-semantics.xml (modified) (6 diffs)

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

@@ -27 +27 @@
   <!ENTITY content-negotiation        "<xref target='Part3' x:rel='#content.negotiation' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY agent-driven-negotiation   "<xref target='Part3' x:rel='#agent-driven.negotiation' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
-  <!ENTITY notation-abnf              "<xref target='Part1' x:rel='#notation.abnf' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
-  <!ENTITY basic-rules                "<xref target='Part1' x:rel='#basic.rules' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
-  <!ENTITY field-rules                "<xref target='Part1' x:rel='#field.rules' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
+  <!ENTITY abnf-extension             "<xref target='Part1' x:rel='#abnf.extension' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
+  <!ENTITY whitespace                 "<xref target='Part1' x:rel='#whitespace' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
+  <!ENTITY field-components           "<xref target='Part1' x:rel='#field.components' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY uri                        "<xref target='Part1' x:rel='#uri' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY effective-request-uri      "<xref target='Part1' x:rel='#effective.request.uri' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
@@ -346 +346 @@
   <x:anchor-alias value="SP"/>
 <t>
-  This specification uses the ABNF syntax defined in &notation; (which
-  extends the syntax defined in <xref target="RFC5234"/> with a list rule).
-  <xref target="collected.abnf"/> shows the collected ABNF, with the list
-  rule expanded.
+   This specification uses the Augmented Backus-Naur Form (ABNF) notation
+   of <xref target="RFC5234"/> with the list rule extension defined in
+   &notation;.  <xref target="collected.abnf"/> shows the collected ABNF
+   with the list rule expanded.
 </t>
 <t>
@@ -372 +372 @@
 </t>
 <figure><artwork type="abnf2616">
-  <x:ref>BWS</x:ref>           = &lt;BWS, defined in &basic-rules;&gt;
-  <x:ref>OWS</x:ref>           = &lt;OWS, defined in &basic-rules;&gt;
-  <x:ref>RWS</x:ref>           = &lt;RWS, defined in &basic-rules;&gt;
-  <x:ref>obs-text</x:ref>      = &lt;obs-text, defined in &basic-rules;&gt;
-  <x:ref>quoted-string</x:ref> = &lt;quoted-string, defined in &field-rules;&gt;
-  <x:ref>token</x:ref>         = &lt;token, defined in &field-rules;&gt;
+  <x:ref>BWS</x:ref>           = &lt;BWS, defined in &whitespace;&gt;
+  <x:ref>OWS</x:ref>           = &lt;OWS, defined in &whitespace;&gt;
+  <x:ref>RWS</x:ref>           = &lt;RWS, defined in &whitespace;&gt;
+  <x:ref>obs-text</x:ref>      = &lt;obs-text, defined in &field-components;&gt;
+  <x:ref>quoted-string</x:ref> = &lt;quoted-string, defined in &field-components;&gt;
+  <x:ref>token</x:ref>         = &lt;token, defined in &field-components;&gt;
 </artwork></figure>
 </section>
@@ -392 +392 @@
 <figure><!--Part1--><artwork type="abnf2616">
   <x:ref>absolute-URI</x:ref>  = &lt;absolute-URI, defined in &uri;&gt;
-  <x:ref>comment</x:ref>       = &lt;comment, defined in &field-rules;&gt;
+  <x:ref>comment</x:ref>       = &lt;comment, defined in &field-components;&gt;
   <x:ref>partial-URI</x:ref>   = &lt;partial-URI, defined in &uri;&gt;
   <x:ref>product</x:ref>       = &lt;product, defined in &product-tokens;&gt;
@@ -525 +525 @@
 <t>
    New header field values typically have their syntax defined using ABNF
-   (<xref target="RFC5234"/>), using the extensions defined in &notation-abnf;
+   (<xref target="RFC5234"/>), using the extension defined in &abnf-extension;
    as necessary, and are usually constrained to the range of ASCII characters.
    Header fields needing a greater range of characters can use an encoding
@@ -534 +534 @@
    they need to be treated with care if they are allowed in the field-value's
    payload. Typically, components that might contain a comma are protected with
-   double-quotes using the quoted-string ABNF production (&field-rules;). 
+   double-quotes using the quoted-string ABNF production (&field-components;). 
 </t>
 <t>