Ignore:
Timestamp:
Nov 21, 2008, 12:25:09 PM (11 years ago)
Author:
julian.reschke@…
Message:

reference RFC5234 core rules directly, fix line end bug in appendix generation (related to #36)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p6-cache.xml

    r424 r425  
    425425
    426426<section title="Syntax Notation" anchor="notation">
    427 <t>
    428   This specification uses the ABNF syntax defined in &notation;.
    429 </t>
    430 
    431 <section title="Core Rules" anchor="core.rules">
     427  <x:anchor-alias value="ALPHA"/>
     428  <x:anchor-alias value="CR"/>
    432429  <x:anchor-alias value="DIGIT"/>
    433430  <x:anchor-alias value="DQUOTE"/>
     431  <x:anchor-alias value="LF"/>
     432  <x:anchor-alias value="OCTET"/>
     433  <x:anchor-alias value="SP"/>
     434  <x:anchor-alias value="VCHAR"/>
     435  <x:anchor-alias value="WSP"/>
     436<t>
     437  This specification uses the ABNF syntax defined in &notation;.
     438  The following core rules are included by
     439  reference, as defined in <xref target="RFC5234" x:fmt="," x:sec="B.1"/>:
     440  ALPHA (letters), CR (carriage return), CRLF (CR LF), CTL (controls),
     441  DIGIT (decimal 0-9), DQUOTE (double quote),
     442  HEXDIG (hexadecimal 0-9/A-F/a-f), LF (line feed),
     443  OCTET (any 8-bit sequence of data), SP (space),
     444  VCHAR (any visible USASCII character),
     445  and WSP (whitespace).
     446</t>
     447
     448<section title="Core Rules" anchor="core.rules">
    434449  <x:anchor-alias value="quoted-string"/>
    435   <x:anchor-alias value="SP"/>
    436450  <x:anchor-alias value="token"/>
    437451  <x:anchor-alias value="OWS"/>
     
    439453  The core rules below are defined in &basic-rules;:
    440454</t>
    441 <figure><artwork type="abnf2616">
    442   <x:ref>DIGIT</x:ref>         = &lt;DIGIT, defined in &basic-rules;&gt;
    443   <x:ref>DQUOTE</x:ref>        = &lt;DQUOTE, defined in &basic-rules;&gt;
    444   <x:ref>SP</x:ref>            = &lt;SP, defined in &basic-rules;&gt;
    445 </artwork></figure>
    446455<figure><artwork type="abnf2616">
    447456  <x:ref>quoted-string</x:ref> = &lt;quoted-string, defined in &basic-rules;&gt;
     
    28132822</reference>
    28142823
     2824<reference anchor="RFC5234">
     2825  <front>
     2826    <title abbrev="ABNF for Syntax Specifications">Augmented BNF for Syntax Specifications: ABNF</title>
     2827    <author initials="D." surname="Crocker" fullname="Dave Crocker" role="editor">
     2828      <organization>Brandenburg InternetWorking</organization>
     2829      <address>
     2830      <postal>
     2831      <street>675 Spruce Dr.</street>
     2832      <city>Sunnyvale</city>
     2833      <region>CA</region>
     2834      <code>94086</code>
     2835      <country>US</country></postal>
     2836      <phone>+1.408.246.8253</phone>
     2837      <email>dcrocker@bbiw.net</email></address> 
     2838    </author>
     2839    <author initials="P." surname="Overell" fullname="Paul Overell">
     2840      <organization>THUS plc.</organization>
     2841      <address>
     2842      <postal>
     2843      <street>1/2 Berkeley Square</street>
     2844      <street>99 Berkely Street</street>
     2845      <city>Glasgow</city>
     2846      <code>G3 7HR</code>
     2847      <country>UK</country></postal>
     2848      <email>paul.overell@thus.net</email></address>
     2849    </author>
     2850    <date month="January" year="2008"/>
     2851  </front>
     2852  <seriesInfo name="STD" value="68"/>
     2853  <seriesInfo name="RFC" value="5234"/>
     2854</reference>
     2855
    28152856</references>
    28162857
     
    29402981<section title="Collected ABNF" anchor="collected.abnf">
    29412982   <figure>
    2942       <artwork type="abnf" name="p6-cache.parsed-abnf">Age = "Age:" OWS Age-v&#xD;
    2943 Age-v = delta-seconds&#xD;
    2944 Cache-Control = "Cache-Control:" OWS Cache-Control-v&#xD;
    2945 Cache-Control-v = *( "," OWS ) cache-directive *( OWS "," [ OWS&#xD;
    2946  cache-directive ] )&#xD;
    2947 DIGIT = &lt;DIGIT, defined in [Part1], Section 1.2.2&gt;&#xD;
    2948 DQUOTE = &lt;DQUOTE, defined in [Part1], Section 1.2.2&gt;&#xD;
    2949 Expires = "Expires:" OWS Expires-v&#xD;
    2950 Expires-v = HTTP-date&#xD;
    2951 HTTP-date = &lt;HTTP-date, defined in [Part1], Section 3.2.1&gt;&#xD;
    2952 OWS = &lt;OWS, defined in [Part1], Section 1.2.2&gt;&#xD;
    2953 Pragma = "Pragma:" OWS Pragma-v&#xD;
    2954 Pragma-v = *( "," OWS ) pragma-directive *( OWS "," [ OWS&#xD;
    2955  pragma-directive ] )&#xD;
    2956 SP = &lt;SP, defined in [Part1], Section 1.2.2&gt;&#xD;
    2957 Vary = "Vary:" OWS Vary-v&#xD;
    2958 Vary-v = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name&#xD;
    2959  ] ) )&#xD;
    2960 Warning = "Warning:" OWS Warning-v&#xD;
    2961 Warning-v = *( "," OWS ) warning-value *( OWS "," [ OWS warning-value&#xD;
    2962  ] )&#xD;
    2963 cache-directive = cache-request-directive / cache-response-directive&#xD;
    2964 cache-extension = token [ "=" ( token / quoted-string ) ]&#xD;
    2965 cache-request-directive = "no-cache" / "no-store" / ( "max-age="&#xD;
    2966  delta-seconds ) / ( "max-stale" [ "=" delta-seconds ] ) / (&#xD;
    2967  "min-fresh=" delta-seconds ) / "no-transform" / "only-if-cached" /&#xD;
    2968  cache-extension&#xD;
    2969 cache-response-directive = "public" / ( "private" [ "=" DQUOTE *( ","&#xD;
    2970  OWS ) field-name *( OWS "," [ OWS field-name ] ) DQUOTE ] ) / (&#xD;
    2971  "no-cache" [ "=" DQUOTE *( "," OWS ) field-name *( OWS "," [ OWS&#xD;
    2972  field-name ] ) DQUOTE ] ) / "no-store" / "no-transform" /&#xD;
    2973  "must-revalidate" / "proxy-revalidate" / ( "max-age=" delta-seconds&#xD;
    2974  ) / ( "s-maxage=" delta-seconds ) / cache-extension&#xD;
    2975 delta-seconds = 1*DIGIT&#xD;
    2976 extension-pragma = token [ "=" ( token / quoted-string ) ]&#xD;
    2977 field-name = &lt;field-name, defined in [Part1], Section 4.2&gt;&#xD;
    2978 port = &lt;port, defined in [Part1], Section 2.1&gt;&#xD;
    2979 pragma-directive = "no-cache" / extension-pragma&#xD;
    2980 pseudonym = &lt;pseudonym, defined in [Part1], Section 8.9&gt;&#xD;
    2981 quoted-string = &lt;quoted-string, defined in [Part1], Section 1.2.2&gt;&#xD;
    2982 token = &lt;token, defined in [Part1], Section 1.2.2&gt;&#xD;
    2983 uri-host = &lt;uri-host, defined in [Part1], Section 2.1&gt;&#xD;
    2984 warn-agent = ( uri-host [ ":" port ] ) / pseudonym&#xD;
    2985 warn-code = 3DIGIT&#xD;
    2986 warn-date = DQUOTE HTTP-date DQUOTE&#xD;
    2987 warn-text = quoted-string&#xD;
    2988 warning-value = warn-code SP warn-agent SP warn-text [ SP warn-date&#xD;
    2989  ]&#xD;
    2990 ; Age defined but not used&#xD;
    2991 ; Cache-Control defined but not used&#xD;
    2992 ; Expires defined but not used&#xD;
    2993 ; Pragma defined but not used&#xD;
    2994 ; Vary defined but not used&#xD;
    2995 ; Warning defined but not used&#xD;
     2983      <artwork type="abnf" name="p6-cache.parsed-abnf">
     2984Age = "Age:" OWS Age-v
     2985Age-v = delta-seconds
     2986Cache-Control = "Cache-Control:" OWS Cache-Control-v
     2987Cache-Control-v = *( "," OWS ) cache-directive *( OWS "," [ OWS
     2988 cache-directive ] )
     2989Expires = "Expires:" OWS Expires-v
     2990Expires-v = HTTP-date
     2991HTTP-date = &lt;HTTP-date, defined in [Part1], Section 3.2.1&gt;
     2992OWS = &lt;OWS, defined in [Part1], Section 1.2.2&gt;
     2993Pragma = "Pragma:" OWS Pragma-v
     2994Pragma-v = *( "," OWS ) pragma-directive *( OWS "," [ OWS
     2995 pragma-directive ] )
     2996Vary = "Vary:" OWS Vary-v
     2997Vary-v = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name
     2998 ] ) )
     2999Warning = "Warning:" OWS Warning-v
     3000Warning-v = *( "," OWS ) warning-value *( OWS "," [ OWS warning-value
     3001 ] )
     3002cache-directive = cache-request-directive / cache-response-directive
     3003cache-extension = token [ "=" ( token / quoted-string ) ]
     3004cache-request-directive = "no-cache" / "no-store" / ( "max-age="
     3005 delta-seconds ) / ( "max-stale" [ "=" delta-seconds ] ) / (
     3006 "min-fresh=" delta-seconds ) / "no-transform" / "only-if-cached" /
     3007 cache-extension
     3008cache-response-directive = "public" / ( "private" [ "=" DQUOTE *( ","
     3009 OWS ) field-name *( OWS "," [ OWS field-name ] ) DQUOTE ] ) / (
     3010 "no-cache" [ "=" DQUOTE *( "," OWS ) field-name *( OWS "," [ OWS
     3011 field-name ] ) DQUOTE ] ) / "no-store" / "no-transform" /
     3012 "must-revalidate" / "proxy-revalidate" / ( "max-age=" delta-seconds
     3013 ) / ( "s-maxage=" delta-seconds ) / cache-extension
     3014delta-seconds = 1*DIGIT
     3015extension-pragma = token [ "=" ( token / quoted-string ) ]
     3016field-name = &lt;field-name, defined in [Part1], Section 4.2&gt;
     3017port = &lt;port, defined in [Part1], Section 2.1&gt;
     3018pragma-directive = "no-cache" / extension-pragma
     3019pseudonym = &lt;pseudonym, defined in [Part1], Section 8.9&gt;
     3020quoted-string = &lt;quoted-string, defined in [Part1], Section 1.2.2&gt;
     3021token = &lt;token, defined in [Part1], Section 1.2.2&gt;
     3022uri-host = &lt;uri-host, defined in [Part1], Section 2.1&gt;
     3023warn-agent = ( uri-host [ ":" port ] ) / pseudonym
     3024warn-code = 3DIGIT
     3025warn-date = DQUOTE HTTP-date DQUOTE
     3026warn-text = quoted-string
     3027warning-value = warn-code SP warn-agent SP warn-text [ SP warn-date
     3028 ]
     3029; Age defined but not used
     3030; Cache-Control defined but not used
     3031; Expires defined but not used
     3032; Pragma defined but not used
     3033; Vary defined but not used
     3034; Warning defined but not used
    29963035</artwork>
    29973036   </figure>
Note: See TracChangeset for help on using the changeset viewer.