Ignore:
Timestamp:
Aug 7, 2009, 9:46:40 AM (10 years ago)
Author:
julian.reschke@…
Message:

Move definitions of compression codings (compress/deflate/gzip) into Part 1, as they also can be used as Transfer Codings (see #189)

File:
1 edited

Legend:

Unmodified
Added
Removed

  • draft-ietf-httpbis/latest/p3-payload.xml

    r671 r673  
    3333  <!ENTITY qvalue                   "<xref target='Part1' x:rel='#quality.values' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3434  <!ENTITY uri                      "<xref target='Part1' x:rel='#uri' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     35  <!ENTITY compress-coding          "<xref target='Part1' x:rel='#compress.coding' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     36  <!ENTITY deflate-coding           "<xref target='Part1' x:rel='#deflate.coding' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     37  <!ENTITY gzip-coding              "<xref target='Part1' x:rel='#gzip.coding' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3538]>
    3639<?rfc toc="yes" ?>
    … …  
    481484</t>
    482485<t>
    483    The Internet Assigned Numbers Authority (IANA) acts as a registry for
    484    content-coding value tokens. Initially, the registry contains the
    485    following tokens:
    486 </t>
    487 <t>
    488    gzip<iref item="gzip"/>
     486   compress<iref item="compress (Coding Format)"/><iref item="Coding Format" subitem="compress"/>
    489487  <list>
    490488    <t>
    491         An encoding format produced by the file compression program
    492         "gzip" (GNU zip) as described in <xref target="RFC1952"/>. This format is a
    493         Lempel-Ziv coding (LZ77) with a 32 bit CRC.
     489      See &compress-coding;.
    494490    </t>
    495491  </list>
    496492</t>
    497493<t>
    498    compress<iref item="compress"/>
    499   <list><t>
    500         The encoding format produced by the common UNIX file compression
    501         program "compress". This format is an adaptive Lempel-Ziv-Welch
    502         coding (LZW).
    503 </t><t>
    504         Use of program names for the identification of encoding formats
    505         is not desirable and is discouraged for future encodings. Their
    506         use here is representative of historical practice, not good
    507         design. For compatibility with previous implementations of HTTP,
    508         applications &SHOULD; consider "x-gzip" and "x-compress" to be
    509         equivalent to "gzip" and "compress" respectively.
    510   </t></list>
    511 </t>
    512 <t>
    513    deflate<iref item="deflate"/>
    514   <list><t>
    515         The "zlib" format defined in <xref target="RFC1950"/> in combination with
    516         the "deflate" compression mechanism described in <xref target="RFC1951"/>.
    517   </t></list>
    518 </t>
    519 <t>
    520    identity<iref item="identity"/>
     494   deflate<iref item="deflate (Coding Format)"/><iref item="Coding Format" subitem="deflate"/>
     495  <list>
     496    <t>
     497      See &deflate-coding;.
     498    </t>
     499  </list>
     500</t>
     501<t>
     502   gzip<iref item="gzip (Coding Format)"/><iref item="Coding Format" subitem="gzip"/>
     503  <list>
     504    <t>
     505      See &gzip-coding;.
     506    </t>
     507  </list>
     508</t>
     509<t>
     510   identity<iref item="identity (Coding Format)"/><iref item="Coding Format" subitem="identity"/>
    521511  <list><t>
    522512        The default (identity) encoding; the use of no transformation
    … …  
    16911681</section>
    16921682
    1693 <section title="Transfer Coding Registry" anchor="transfer.coding.registration">
    1694 <t>
    1695    The HTTP Transfer Codings Registry located at <eref target="http://www.iana.org/assignments/http-parameters"/>
    1696    should be updated with the registrations below:
    1697 </t>
    1698 <texttable align="left" suppress-title="true" anchor="iana.transfer.coding.registration.table">
    1699    <ttcol>Name</ttcol>
    1700    <ttcol>Description</ttcol>
    1701    <ttcol>Reference</ttcol>
    1702    <c>compress</c>
    1703    <c>UNIX "compress" program method</c>
    1704    <c>
    1705       <xref target="content.codings"/>
    1706    </c>
    1707    <c>deflate</c>
    1708    <c>"zlib" format <xref target="RFC1950"/> with "deflate" compression</c>
    1709    <c>
    1710       <xref target="content.codings"/>
    1711    </c>
    1712    <c>gzip</c>
    1713    <c>Same as GNU zip <xref target="RFC1952"/></c>
    1714    <c>
    1715       <xref target="content.codings"/>
    1716    </c>
    1717 </texttable>
    1718 </section>
    1719 
    17201683<section title="Content Coding Registry" anchor="content.coding.registration">
    17211684<t>
    … …  
    17251688<t>
    17261689   The HTTP Content Codings Registry located at <eref target="http://www.iana.org/assignments/http-parameters"/>
    1727    should be updated with the registrations below:
     1690   should be updated with the registration below:
    17281691</t>
    17291692<texttable align="left" suppress-title="true" anchor="iana.content.coding.registration.table">
    … …  
    17341697   <c>UNIX "compress" program method</c>
    17351698   <c>
    1736       <xref target="content.codings"/>
     1699      &compress-coding;
    17371700   </c>
    17381701   <c>deflate</c>
    17391702   <c>"zlib" format <xref target="RFC1950"/> with "deflate" compression</c>
    17401703   <c>
    1741       <xref target="content.codings"/>
     1704      &deflate-coding;
    17421705   </c>
    17431706   <c>gzip</c>
    17441707   <c>Same as GNU zip <xref target="RFC1952"/></c>
    17451708   <c>
    1746       <xref target="content.codings"/>
     1709      &gzip-coding;
    17471710   </c>
    17481711   <c>identity</c>
    … …  
    20972060  <annotation>
    20982061    RFC 1950 is an Informational RFC, thus it may be less stable than
    2099     this specification. On the other hand, this downward reference was
    2100     present since the publication of RFC 2068 in 1997 (<xref target="RFC2068"/>),
    2101     therefore it is unlikely to cause problems in practice. See also
    2102     <xref target="BCP97"/>.
    2103   </annotation>
    2104 </reference>
    2105 
    2106 <reference anchor="RFC1951">
    2107   <front>
    2108     <title>DEFLATE Compressed Data Format Specification version 1.3</title>
    2109     <author initials="P." surname="Deutsch" fullname="L. Peter Deutsch">
    2110       <organization>Aladdin Enterprises</organization>
    2111       <address><email>ghost@aladdin.com</email></address>
    2112     </author>
    2113     <date month="May" year="1996"/>
    2114   </front>
    2115   <seriesInfo name="RFC" value="1951"/>
    2116   <annotation>
    2117     RFC 1951 is an Informational RFC, thus it may be less stable than
    21182062    this specification. On the other hand, this downward reference was
    21192063    present since the publication of RFC 2068 in 1997 (<xref target="RFC2068"/>),
    … …  
    31353079      "pick IANA policy (RFC5226) for Transfer Coding / Content Coding"
    31363080    </t>
     3081    <t>
     3082      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/189"/>:
     3083      "move definitions of gzip/deflate/compress to part 1"
     3084    </t>
    31373085  </list>
    31383086</t>
Note: See TracChangeset for help on using the changeset viewer.