Changeset 1518 for draft-ietf-httpbis/latest/p6-cache.xml

Timestamp:

30/01/12 01:48:21 (9 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/p6-cache.xml (modified) (3 diffs)

draft-ietf-httpbis/latest/p6-cache.xml

@@ -15 +15 @@
   <!ENTITY ID-MONTH "January">
   <!ENTITY ID-YEAR "2012">
-  <!ENTITY architecture               "<xref target='Part1' x:rel='#architecture' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
+  <!ENTITY architecture                "<xref target='Part1' x:rel='#architecture' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY notation                    "<xref target='Part1' x:rel='#notation' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY acks                        "<xref target='Part1' x:rel='#acks' 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 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'/>">
@@ -435 +435 @@
    <x:anchor-alias value="VCHAR"/>
 <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>
@@ -456 +456 @@
 </t>
 <figure><artwork type="abnf2616">
-  <x:ref>OWS</x:ref>           = &lt;OWS, 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>OWS</x:ref>           = &lt;OWS, defined in &whitespace;&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>