Ignore:
Timestamp:
Mar 2, 2008, 9:21:57 AM (12 years ago)
Author:
julian.reschke@…
Message:

add linking between ABNF rules (does not affect TXT version), relates to #36.

File:
1 edited

Legend:

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

    r228 r229  
    429429
    430430<section title="Notational Conventions and Generic Grammar" anchor="notation">
     431  <x:anchor-alias value="DIGIT"/>
     432  <x:anchor-alias value="DQUOTE"/>
     433  <x:anchor-alias value="quoted-string"/>
     434  <x:anchor-alias value="SP"/>
     435  <x:anchor-alias value="token"/>
    431436<t>
    432437  This specification uses the ABNF syntax defined in &notation-abnf; and
     
    436441</t>
    437442<figure><artwork type="abnf2616">
    438   DIGIT         = &lt;DIGIT, defined in &basic-rules;&gt;
    439   DQUOTE        = &lt;DQUOTE, defined in &basic-rules;&gt;
    440   SP            = &lt;SP, defined in &basic-rules;&gt;
     443  <x:ref>DIGIT</x:ref>         = &lt;DIGIT, defined in &basic-rules;&gt;
     444  <x:ref>DQUOTE</x:ref>        = &lt;DQUOTE, defined in &basic-rules;&gt;
     445  <x:ref>SP</x:ref>            = &lt;SP, defined in &basic-rules;&gt;
    441446</artwork></figure>
    442447<figure><artwork type="abnf2616">
    443   quoted-string = &lt;quoted-string, defined in &basic-rules;&gt;
    444   token         = &lt;token, defined in &basic-rules;&gt;
     448  <x:ref>quoted-string</x:ref> = &lt;quoted-string, defined in &basic-rules;&gt;
     449  <x:ref>token</x:ref>         = &lt;token, defined in &basic-rules;&gt;
    445450</artwork></figure>
    446451<t anchor="abnf.dependencies">
     452  <x:anchor-alias value="field-name"/>
     453  <x:anchor-alias value="HTTP-date"/>
     454  <x:anchor-alias value="port"/>
     455  <x:anchor-alias value="pseudonym"/>
     456  <x:anchor-alias value="uri-host"/>
    447457  The ABNF rules below are defined in other parts:
    448458</t>
    449459<figure><!--Part1--><artwork type="abnf2616">
    450   field-name    = &lt;field-name, defined in &message-headers;&gt;
    451   HTTP-date     = &lt;HTTP-date, defined in &full-date;&gt;
    452   port          = &lt;port, defined in &general-syntax;&gt;
    453   pseudonym     = &lt;pseudonym, defined in &header-via;&gt;
    454   uri-host      = &lt;uri-host, defined in &general-syntax;&gt;
     460  <x:ref>field-name</x:ref>    = &lt;field-name, defined in &message-headers;&gt;
     461  <x:ref>HTTP-date</x:ref>     = &lt;HTTP-date, defined in &full-date;&gt;
     462  <x:ref>port</x:ref>          = &lt;port, defined in &general-syntax;&gt;
     463  <x:ref>pseudonym</x:ref>     = &lt;pseudonym, defined in &header-via;&gt;
     464  <x:ref>uri-host</x:ref>      = &lt;uri-host, defined in &general-syntax;&gt;
    455465</artwork></figure>
    456466</section>
     
    14931503  <iref primary="true" item="Age header" x:for-anchor=""/>
    14941504  <iref primary="true" item="Headers" subitem="Age" x:for-anchor=""/>
     1505  <x:anchor-alias value="Age"/>
     1506  <x:anchor-alias value="age-value"/>
    14951507<t>
    14961508      The Age response-header field conveys the sender's estimate of the
     
    15011513</t>
    15021514<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Age"/><iref primary="true" item="Grammar" subitem="age-value"/>
    1503   Age = "Age" ":" age-value
    1504   age-value = delta-seconds
     1515  <x:ref>Age</x:ref> = "Age" ":" <x:ref>age-value</x:ref>
     1516  <x:ref>age-value</x:ref> = <x:ref>delta-seconds</x:ref>
    15051517</artwork></figure>
    1506 <t>
     1518<t anchor="rule.delta-seconds">
     1519  <x:anchor-alias value="delta-seconds"/>
    15071520      Age values are non-negative decimal integers, representing time in
    15081521      seconds.
    15091522</t>
    15101523<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="delta-seconds"/>
    1511   delta-seconds  = 1*DIGIT
     1524  <x:ref>delta-seconds</x:ref>  = 1*<x:ref>DIGIT</x:ref>
    15121525</artwork></figure>
    15131526<t>
     
    15251538  <iref primary="true" item="Cache-Control header" x:for-anchor=""/>
    15261539  <iref primary="true" item="Headers" subitem="Cache-Control" x:for-anchor=""/>
     1540  <x:anchor-alias value="Cache-Control"/>
     1541  <x:anchor-alias value="cache-directive"/>
     1542  <x:anchor-alias value="cache-extension"/>
     1543  <x:anchor-alias value="cache-request-directive"/>
     1544  <x:anchor-alias value="cache-response-directive"/>
    15271545<t>
    15281546   The Cache-Control general-header field is used to specify directives
     
    15471565</t>
    15481566<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Cache-Control"/><iref primary="true" item="Grammar" subitem="cache-directive"/><iref primary="true" item="Grammar" subitem="cache-request-directive"/><iref primary="true" item="Grammar" subitem="cache-response-directive"/><iref primary="true" item="Grammar" subitem="cache-extension"/>
    1549   Cache-Control   = "Cache-Control" ":" 1#cache-directive
    1550 
    1551   cache-directive = cache-request-directive
    1552      | cache-response-directive
    1553 
    1554   cache-request-directive =
     1567  <x:ref>Cache-Control</x:ref>   = "Cache-Control" ":" 1#<x:ref>cache-directive</x:ref>
     1568
     1569  <x:ref>cache-directive</x:ref> = <x:ref>cache-request-directive</x:ref>
     1570     | <x:ref>cache-response-directive</x:ref>
     1571
     1572  <x:ref>cache-request-directive</x:ref> =
    15551573       "no-cache"                          ; <xref target="what.is.cacheable"/>
    15561574     | "no-store"                          ; <xref target="what.may.be.stored.by.caches"/>
    1557      | "max-age" "=" delta-seconds         ; <xref target="modifications.of.the.basic.expiration.mechanism"/>, <xref format="counter" target="cache.revalidation.and.reload.controls"/>
    1558      | "max-stale" [ "=" delta-seconds ]   ; <xref target="modifications.of.the.basic.expiration.mechanism"/>
    1559      | "min-fresh" "=" delta-seconds       ; <xref target="modifications.of.the.basic.expiration.mechanism"/>
     1575     | "max-age" "=" <x:ref>delta-seconds</x:ref>         ; <xref target="modifications.of.the.basic.expiration.mechanism"/>, <xref format="counter" target="cache.revalidation.and.reload.controls"/>
     1576     | "max-stale" [ "=" <x:ref>delta-seconds</x:ref> ]   ; <xref target="modifications.of.the.basic.expiration.mechanism"/>
     1577     | "min-fresh" "=" <x:ref>delta-seconds</x:ref>       ; <xref target="modifications.of.the.basic.expiration.mechanism"/>
    15601578     | "no-transform"                      ; <xref target="no-transform.directive"/>
    15611579     | "only-if-cached"                    ; <xref target="cache.revalidation.and.reload.controls"/>
    1562      | cache-extension                     ; <xref target="cache.control.extensions"/>
    1563 
    1564   cache-response-directive =
     1580     | <x:ref>cache-extension</x:ref>                     ; <xref target="cache.control.extensions"/>
     1581
     1582  <x:ref>cache-response-directive</x:ref> =
    15651583       "public"                               ; <xref target="what.is.cacheable"/>
    1566      | "private" [ "=" DQUOTE 1#field-name DQUOTE ] ; <xref target="what.is.cacheable"/>
    1567      | "no-cache" [ "=" DQUOTE 1#field-name DQUOTE ] ; <xref target="what.is.cacheable"/>
     1584     | "private" [ "=" <x:ref>DQUOTE</x:ref> 1#<x:ref>field-name</x:ref> <x:ref>DQUOTE</x:ref> ] ; <xref target="what.is.cacheable"/>
     1585     | "no-cache" [ "=" <x:ref>DQUOTE</x:ref> 1#<x:ref>field-name</x:ref> <x:ref>DQUOTE</x:ref> ] ; <xref target="what.is.cacheable"/>
    15681586     | "no-store"                             ; <xref target="what.may.be.stored.by.caches"/>
    15691587     | "no-transform"                         ; <xref target="no-transform.directive"/>
    15701588     | "must-revalidate"                      ; <xref target="cache.revalidation.and.reload.controls"/>
    15711589     | "proxy-revalidate"                     ; <xref target="cache.revalidation.and.reload.controls"/>
    1572      | "max-age" "=" delta-seconds            ; <xref target="modifications.of.the.basic.expiration.mechanism"/>
    1573      | "s-maxage" "=" delta-seconds           ; <xref target="modifications.of.the.basic.expiration.mechanism"/>
    1574      | cache-extension                        ; <xref target="cache.control.extensions"/>
    1575 
    1576   cache-extension = token [ "=" ( token | quoted-string ) ]
     1590     | "max-age" "=" <x:ref>delta-seconds</x:ref>            ; <xref target="modifications.of.the.basic.expiration.mechanism"/>
     1591     | "s-maxage" "=" <x:ref>delta-seconds</x:ref>           ; <xref target="modifications.of.the.basic.expiration.mechanism"/>
     1592     | <x:ref>cache-extension</x:ref>                        ; <xref target="cache.control.extensions"/>
     1593
     1594  <x:ref>cache-extension</x:ref> = <x:ref>token</x:ref> [ "=" ( <x:ref>token</x:ref> | <x:ref>quoted-string</x:ref> ) ]
    15771595</artwork></figure>
    15781596<t>
     
    20692087  <iref primary="true" item="Expires header" x:for-anchor=""/>
    20702088  <iref primary="true" item="Headers" subitem="Expires" x:for-anchor=""/>
     2089  <x:anchor-alias value="Expires"/>
    20712090<t>
    20722091   The Expires entity-header field gives the date/time after which the
     
    20872106</t>
    20882107<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Expires"/>
    2089   Expires = "Expires" ":" HTTP-date
     2108  <x:ref>Expires</x:ref> = "Expires" ":" <x:ref>HTTP-date</x:ref>
    20902109</artwork></figure>
    20912110<t>
     
    21292148  <iref primary="true" item="Pragma header" x:for-anchor=""/>
    21302149  <iref primary="true" item="Headers" subitem="Pragma" x:for-anchor=""/>
     2150  <x:anchor-alias value="extension-pragma"/>
     2151  <x:anchor-alias value="Pragma"/>
     2152  <x:anchor-alias value="pragma-directive"/>
    21312153<t>
    21322154   The Pragma general-header field is used to include implementation-specific
     
    21372159</t>
    21382160<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Pragma"/><iref primary="true" item="Grammar" subitem="pragma-directive"/><iref primary="true" item="Grammar" subitem="extension-pragma"/>
    2139   Pragma            = "Pragma" ":" 1#pragma-directive
    2140   pragma-directive  = "no-cache" | extension-pragma
    2141   extension-pragma  = token [ "=" ( token | quoted-string ) ]
     2161  <x:ref>Pragma</x:ref>            = "Pragma" ":" 1#<x:ref>pragma-directive</x:ref>
     2162  <x:ref>pragma-directive</x:ref>  = "no-cache" | <x:ref>extension-pragma</x:ref>
     2163  <x:ref>extension-pragma</x:ref>  = <x:ref>token</x:ref> [ "=" ( <x:ref>token</x:ref> | <x:ref>quoted-string</x:ref> ) ]
    21422164</artwork></figure>
    21432165<t>
     
    21732195  <iref primary="true" item="Vary header" x:for-anchor=""/>
    21742196  <iref primary="true" item="Headers" subitem="Vary" x:for-anchor=""/>
     2197  <x:anchor-alias value="Vary"/>
    21752198<t>
    21762199   The Vary field value indicates the set of request-header fields that
     
    21852208</t>
    21862209<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Vary"/>
    2187   Vary  = "Vary" ":" ( "*" | 1#field-name )
     2210  <x:ref>Vary</x:ref>  = "Vary" ":" ( "*" | 1#<x:ref>field-name</x:ref> )
    21882211</artwork></figure>
    21892212<t>
     
    22242247  <iref primary="true" item="Warning header" x:for-anchor=""/>
    22252248  <iref primary="true" item="Headers" subitem="Warning" x:for-anchor=""/>
     2249  <x:anchor-alias value="Warning"/>
     2250  <x:anchor-alias value="warning-value"/>
     2251  <x:anchor-alias value="warn-agent"/>
     2252  <x:anchor-alias value="warn-code"/>
     2253  <x:anchor-alias value="warn-date"/>
     2254  <x:anchor-alias value="warn-text"/>
    22262255<t>
    22272256   The Warning general-header field is used to carry additional
     
    22362265</t>
    22372266<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Warning"/><iref primary="true" item="Grammar" subitem="warning-value"/><iref primary="true" item="Grammar" subitem="warn-code"/><iref primary="true" item="Grammar" subitem="warn-agent"/><iref primary="true" item="Grammar" subitem="warn-text"/><iref primary="true" item="Grammar" subitem="warn-date"/>
    2238   Warning    = "Warning" ":" 1#warning-value
     2267  <x:ref>Warning</x:ref>    = "Warning" ":" 1#<x:ref>warning-value</x:ref>
    22392268 
    2240   warning-value = warn-code SP warn-agent SP warn-text
    2241                                         [SP warn-date]
     2269  <x:ref>warning-value</x:ref> = <x:ref>warn-code</x:ref> <x:ref>SP</x:ref> <x:ref>warn-agent</x:ref> <x:ref>SP</x:ref> <x:ref>warn-text</x:ref>
     2270                                        [<x:ref>SP</x:ref> <x:ref>warn-date</x:ref>]
    22422271 
    2243   warn-code  = 3DIGIT
    2244   warn-agent = ( uri-host [ ":" port ] ) | pseudonym
     2272  <x:ref>warn-code</x:ref>  = 3<x:ref>DIGIT</x:ref>
     2273  <x:ref>warn-agent</x:ref> = ( <x:ref>uri-host</x:ref> [ ":" <x:ref>port</x:ref> ] ) | <x:ref>pseudonym</x:ref>
    22452274                  ; the name or pseudonym of the server adding
    22462275                  ; the Warning header, for use in debugging
    2247   warn-text  = quoted-string
    2248   warn-date  = DQUOTE HTTP-date DQUOTE
     2276  <x:ref>warn-text</x:ref>  = <x:ref>quoted-string</x:ref>
     2277  <x:ref>warn-date</x:ref>  = <x:ref>DQUOTE</x:ref> <x:ref>HTTP-date</x:ref> <x:ref>DQUOTE</x:ref>
    22492278</artwork></figure>
    22502279<t>
Note: See TracChangeset for help on using the changeset viewer.