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

Timestamp:

Feb 3, 2008, 11:07:03 AM (12 years ago)

Author:

julian.reschke@…

Message:

Move Section "Product Tokens" from P2 into P1 (back below "Protocol Parameters") ("token" is used in the definition of the Upgrade header); addresses #36.

File:

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

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

@@ -56 +56 @@
   <!ENTITY header-www-authenticate    "<xref target='Part7' x:rel='#header.www-authenticate' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY message-body               "<xref target='Part1' x:rel='#message.body' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
+  <!ENTITY product-tokens             "<xref target='Part1' x:rel='#product.tokens' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
 ]>
 <?rfc toc="yes" ?>
@@ -283 +284 @@
 </section>
 
-<section title="Product Tokens" anchor="product.tokens">
-<t>
-   Product tokens are used to allow communicating applications to
-   identify themselves by software name and version. Most fields using
-   product tokens also allow sub-products which form a significant part
-   of the application to be listed, separated by white space. By
-   convention, the products are listed in order of their significance
-   for identifying the application.
-</t>
-<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="product"/><iref primary="true" item="Grammar" subitem="product-version"/>
-  product         = token ["/" product-version]
-  product-version = token
-</artwork></figure>
-<t>
-   Examples:
-</t>
-<figure><artwork type="example">
-    User-Agent: CERN-LineMode/2.15 libwww/2.17b3
-    Server: Apache/0.8.4
-</artwork></figure>
-<t>
-   Product tokens &SHOULD; be short and to the point. They &MUST-NOT; be
-   used for advertising or other non-essential information. Although any
-   token character &MAY; appear in a product-version, this token &SHOULD;
-   only be used for a version identifier (i.e., successive versions of
-   the same product &SHOULD; only differ in the product-version portion of
-   the product value).
-</t>
-</section>
-
 <section title="Method" anchor="method">
 <t>
@@ -1921 +1892 @@
    The Server response-header field contains information about the
    software used by the origin server to handle the request. The field
-   can contain multiple product tokens (<xref target="product.tokens"/>) and comments
+   can contain multiple product tokens (&product-tokens;) and comments
    identifying the server and any significant subproducts. The product
    tokens are listed in order of their significance for identifying the
@@ -1958 +1929 @@
    agents for the sake of tailoring responses to avoid particular user
    agent limitations. User agents &SHOULD; include this field with
-   requests. The field can contain multiple product tokens (<xref target="product.tokens"/>)
+   requests. The field can contain multiple product tokens (&product-tokens;)
    and comments identifying the agent and any subproducts which form a
    significant part of the user agent. By convention, the product tokens
@@ -2637 +2608 @@
   </list>
 </t>
+<t>
+  Ongoing work on ABNF conversion (<eref target="http://www3.tools.ietf.org/wg/httpbis/trac/ticket/36"/>):
+  <list style="symbols"> 
+    <t>
+      Move "Product Tokens" section (back) into Part 1, as "token" is used
+      in the definition of the Upgrade header.
+    </t>
+  </list>
+</t>
 </section>