Changeset 702 for draft-ietf-httpbis/latest/p1-messaging.xml

Timestamp:

Sep 27, 2009, 4:08:05 AM (10 years ago)

Author:

julian.reschke@…

Message:

RECOMMEND not to quote things that do not require quoting; for readability, have a separate grammar for quoted-pair in comment, now called quoted-cpair (see #194)

File:

• draft-ietf-httpbis/latest/p1-messaging.xml (modified) (2 diffs)

draft-ietf-httpbis/latest/p1-messaging.xml

@@ -460 +460 @@
   <x:anchor-alias value="quoted-pair"/>
    The backslash character ("\") can be used as a single-character
-   quoting mechanism only within quoted-string and comment constructs (<xref target="header.fields"/>).
+   quoting mechanism only within quoted-string constructs:
 </t>
 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="quoted-pair"/>
   <x:ref>quoted-pair</x:ref>    = "\" ( <x:ref>WSP</x:ref> / <x:ref>VCHAR</x:ref> / <x:ref>obs-text</x:ref> ) 
 </artwork></figure>
+<t>
+   Producers &SHOULD-NOT; escape characters that do not require escaping
+   (DQUOTE and the backslash character).
+</t>
 </section>
 
@@ -1160 +1164 @@
 </t>
 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="comment"/><iref primary="true" item="Grammar" subitem="ctext"/>
-  <x:ref>comment</x:ref>        = "(" *( <x:ref>ctext</x:ref> / <x:ref>quoted-pair</x:ref> / <x:ref>comment</x:ref> ) ")"
+  <x:ref>comment</x:ref>        = "(" *( <x:ref>ctext</x:ref> / <x:ref>quoted-cpair</x:ref> / <x:ref>comment</x:ref> ) ")"
   <x:ref>ctext</x:ref>          = <x:ref>OWS</x:ref> / %x21-27 / %x2A-5B / %x5D-7E / <x:ref>obs-text</x:ref>
                  ; <x:ref>OWS</x:ref> / &lt;<x:ref>VCHAR</x:ref> except "(", ")", and "\"&gt; / <x:ref>obs-text</x:ref>
 </artwork></figure>
-  
+<t anchor="rule.quoted-cpair">
+  <x:anchor-alias value="quoted-cpair"/>
+   The backslash character ("\") can be used as a single-character
+   quoting mechanism only within comment constructs:
+</t>
+<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="quoted-cpair"/>
+  <x:ref>quoted-cpair</x:ref>    = "\" ( <x:ref>WSP</x:ref> / <x:ref>VCHAR</x:ref> / <x:ref>obs-text</x:ref> ) 
+</artwork></figure>
+<t>
+   Producers &SHOULD-NOT; escape characters that do not require escaping
+   (the backslash character "\" and the parentheses "(" and ")").
+</t>
 </section>