Changeset 2441


Ignore:
Timestamp:
Oct 29, 2013, 7:27:52 AM (6 years ago)
Author:
julian.reschke@…
Message:

move the multipart/byteranges media type registration into the IANA Considerations section (see #506)

Location:
draft-ietf-httpbis/latest
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p5-range.html

    r2438 r2441  
    601601               <li><a href="#rfc.section.5.2">5.2</a>&nbsp;&nbsp;&nbsp;<a href="#status.code.registration">Status Code Registration</a></li>
    602602               <li><a href="#rfc.section.5.3">5.3</a>&nbsp;&nbsp;&nbsp;<a href="#header.field.registration">Header Field Registration</a></li>
     603               <li><a href="#rfc.section.5.4">5.4</a>&nbsp;&nbsp;&nbsp;<a href="#internet.media.type.http">Internet Media Type Registration</a><ul>
     604                     <li><a href="#rfc.section.5.4.1">5.4.1</a>&nbsp;&nbsp;&nbsp;<a href="#internet.media.type.multipart.byteranges.reg">Internet Media Type multipart/byteranges</a></li>
     605                  </ul>
     606               </li>
    603607            </ul>
    604608         </li>
     
    10921096            </div>
    10931097            <p id="rfc.section.5.3.p.3">The change controller is: "IETF (iesg@ietf.org) - Internet Engineering Task Force".</p>
     1098         </div>
     1099         <div id="internet.media.type.http">
     1100            <h2 id="rfc.section.5.4"><a href="#rfc.section.5.4">5.4</a>&nbsp;<a href="#internet.media.type.http">Internet Media Type Registration</a></h2>
     1101            <p id="rfc.section.5.4.p.1">IANA maintains the registry of Internet media types <a href="#BCP13" id="rfc.xref.BCP13.1"><cite title="Media Type Specifications and Registration Procedures">[BCP13]</cite></a> at &lt;<a href="http://www.iana.org/assignments/media-types">http://www.iana.org/assignments/media-types</a>&gt;.
     1102            </p>
     1103            <p id="rfc.section.5.4.p.2">This document serves as the specification for the Internet media type "multipart/byteranges". The following is to be registered
     1104               with IANA.
     1105            </p>
     1106            <div id="internet.media.type.multipart.byteranges.reg">
     1107               <div id="rfc.iref.m.1"></div>
     1108               <div id="rfc.iref.m.2"></div>
     1109               <h3 id="rfc.section.5.4.1"><a href="#rfc.section.5.4.1">5.4.1</a>&nbsp;<a href="#internet.media.type.multipart.byteranges.reg">Internet Media Type multipart/byteranges</a></h3>
     1110               <p id="rfc.section.5.4.1.p.1"></p>
     1111               <dl>
     1112                  <dt>Type name:</dt>
     1113                  <dd>multipart</dd>
     1114                  <dt>Subtype name:</dt>
     1115                  <dd>byteranges</dd>
     1116                  <dt>Required parameters:</dt>
     1117                  <dd>boundary</dd>
     1118                  <dt>Optional parameters:</dt>
     1119                  <dd>none</dd>
     1120                  <dt>Encoding considerations:</dt>
     1121                  <dd>only "7bit", "8bit", or "binary" are permitted</dd>
     1122                  <dt>Security considerations:</dt>
     1123                  <dd>none</dd>
     1124                  <dt>Interoperability considerations:</dt>
     1125                  <dd>none</dd>
     1126                  <dt>Published specification:</dt>
     1127                  <dd>This specification (see <a href="#internet.media.type.multipart.byteranges" title="Internet Media Type multipart/byteranges">Appendix&nbsp;A</a>).
     1128                  </dd>
     1129                  <dt>Applications that use this media type:</dt>
     1130                  <dd>HTTP components supporting multiple ranges in a single request.</dd>
     1131                  <dt>Additional information:</dt>
     1132                  <dd>
     1133                     <dl>
     1134                        <dt>Magic number(s):</dt>
     1135                        <dd>none</dd>
     1136                        <dt>File extension(s):</dt>
     1137                        <dd>none</dd>
     1138                        <dt>Macintosh file type code(s):</dt>
     1139                        <dd>none</dd>
     1140                     </dl>
     1141                  </dd>
     1142                  <dt>Person and email address to contact for further information:</dt>
     1143                  <dd>See Authors Section.</dd>
     1144                  <dt>Intended usage:</dt>
     1145                  <dd>COMMON</dd>
     1146                  <dt>Restrictions on usage:</dt>
     1147                  <dd>none</dd>
     1148                  <dt>Author:</dt>
     1149                  <dd>See Authors Section.</dd>
     1150                  <dt>Change controller:</dt>
     1151                  <dd>IESG</dd>
     1152               </dl>
     1153            </div>
    10941154         </div>
    10951155      </div>
     
    11921252      </div>
    11931253      <div id="internet.media.type.multipart.byteranges">
    1194          <div id="rfc.iref.m.1"></div>
    1195          <div id="rfc.iref.m.2"></div>
     1254         <div id="rfc.iref.m.3"></div>
     1255         <div id="rfc.iref.m.4"></div>
    11961256         <h1 id="rfc.section.A" class="np"><a href="#rfc.section.A">A.</a>&nbsp;<a href="#internet.media.type.multipart.byteranges">Internet Media Type multipart/byteranges</a></h1>
    1197          <p id="rfc.section.A.p.1">When a <a href="#status.206" class="smpl">206 (Partial Content)</a> response message includes the content of multiple ranges, they are transmitted as body parts in a multipart message body (<a href="#RFC2046" id="rfc.xref.RFC2046.1"><cite title="Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types">[RFC2046]</cite></a>, <a href="http://tools.ietf.org/html/rfc2046#section-5.1">Section 5.1</a>) with the media type of "multipart/byteranges". The following definition is to be registered with IANA <a href="#BCP13" id="rfc.xref.BCP13.1"><cite title="Media Type Specifications and Registration Procedures">[BCP13]</cite></a>.
     1257         <p id="rfc.section.A.p.1">When a <a href="#status.206" class="smpl">206 (Partial Content)</a> response message includes the content of multiple ranges, they are transmitted as body parts in a multipart message body (<a href="#RFC2046" id="rfc.xref.RFC2046.1"><cite title="Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types">[RFC2046]</cite></a>, <a href="http://tools.ietf.org/html/rfc2046#section-5.1">Section 5.1</a>) with the media type of "multipart/byteranges".
    11981258         </p>
    11991259         <p id="rfc.section.A.p.2">The multipart/byteranges media type includes one or more body parts, each with its own <a href="p2-semantics.html#header.content-type" class="smpl">Content-Type</a> and <a href="#header.content-range" class="smpl">Content-Range</a> fields. The required boundary parameter specifies the boundary string used to separate each body part.
    12001260         </p>
    1201          <p id="rfc.section.A.p.3"></p>
    1202          <dl>
    1203             <dt>Type name:</dt>
    1204             <dd>multipart</dd>
    1205             <dt>Subtype name:</dt>
    1206             <dd>byteranges</dd>
    1207             <dt>Required parameters:</dt>
    1208             <dd>boundary</dd>
    1209             <dt>Optional parameters:</dt>
    1210             <dd>none</dd>
    1211             <dt>Encoding considerations:</dt>
    1212             <dd>only "7bit", "8bit", or "binary" are permitted</dd>
    1213             <dt>Security considerations:</dt>
    1214             <dd>none</dd>
    1215             <dt>Interoperability considerations:</dt>
    1216             <dd>none</dd>
    1217             <dt>Published specification:</dt>
    1218             <dd>This specification (see <a href="#internet.media.type.multipart.byteranges" title="Internet Media Type multipart/byteranges">Appendix&nbsp;A</a>).
    1219             </dd>
    1220             <dt>Applications that use this media type:</dt>
    1221             <dd>HTTP components supporting multiple ranges in a single request.</dd>
    1222             <dt>Additional information:</dt>
    1223             <dd>
    1224                <dl>
    1225                   <dt>Magic number(s):</dt>
    1226                   <dd>none</dd>
    1227                   <dt>File extension(s):</dt>
    1228                   <dd>none</dd>
    1229                   <dt>Macintosh file type code(s):</dt>
    1230                   <dd>none</dd>
    1231                </dl>
    1232             </dd>
    1233             <dt>Person and email address to contact for further information:</dt>
    1234             <dd>See Authors Section.</dd>
    1235             <dt>Intended usage:</dt>
    1236             <dd>COMMON</dd>
    1237             <dt>Restrictions on usage:</dt>
    1238             <dd>none</dd>
    1239             <dt>Author:</dt>
    1240             <dd>See Authors Section.</dd>
    1241             <dt>Change controller:</dt>
    1242             <dd>IESG</dd>
    1243          </dl>
    1244          <p id="rfc.section.A.p.4">Implementation Notes: </p>
     1261         <p id="rfc.section.A.p.3">Implementation Notes: </p>
    12451262         <ol>
    12461263            <li>Additional CRLFs might precede the first boundary string in the body.</li>
    12471264            <li>Although <a href="#RFC2046" id="rfc.xref.RFC2046.2"><cite title="Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types">[RFC2046]</cite></a> permits the boundary string to be quoted, some existing implementations handle a quoted boundary string incorrectly.
    12481265            </li>
    1249             <li>A number of clients and servers were coded to an early draft of the byteranges specification that used a media type of multipart/x-byteranges<span id="rfc.iref.m.3"></span><span id="rfc.iref.m.4"></span>, which is almost (but not quite) compatible with this type.
     1266            <li>A number of clients and servers were coded to an early draft of the byteranges specification that used a media type of multipart/x-byteranges<span id="rfc.iref.m.5"></span><span id="rfc.iref.m.6"></span>, which is almost (but not quite) compatible with this type.
    12501267            </li>
    12511268         </ol>
    1252          <p id="rfc.section.A.p.5">Despite the name, the "multipart/byteranges" media type is not limited to byte ranges. The following example uses an "exampleunit"
     1269         <p id="rfc.section.A.p.4">Despite the name, the "multipart/byteranges" media type is not limited to byte ranges. The following example uses an "exampleunit"
    12531270            range unit:
    12541271         </p>
     
    13851402            </li>
    13861403            <li><a id="rfc.index.B" href="#rfc.index.B"><b>B</b></a><ul>
    1387                   <li><em>BCP13</em>&nbsp;&nbsp;<a href="#BCP13"><b>8.2</b></a>, <a href="#rfc.xref.BCP13.1">A</a></li>
     1404                  <li><em>BCP13</em>&nbsp;&nbsp;<a href="#rfc.xref.BCP13.1">5.4</a>, <a href="#BCP13"><b>8.2</b></a></li>
    13881405                  <li><em>BCP90</em>&nbsp;&nbsp;<a href="#rfc.xref.BCP90.1">5.3</a>, <a href="#BCP90"><b>8.2</b></a></li>
    13891406               </ul>
     
    14301447                  <li>Media Type&nbsp;&nbsp;
    14311448                     <ul>
    1432                         <li>multipart/byteranges&nbsp;&nbsp;<a href="#rfc.iref.m.1"><b>A</b></a></li>
    1433                         <li>multipart/x-byteranges&nbsp;&nbsp;<a href="#rfc.iref.m.4">A</a></li>
     1449                        <li>multipart/byteranges&nbsp;&nbsp;<a href="#rfc.iref.m.1"><b>5.4.1</b></a>, <a href="#rfc.iref.m.3"><b>A</b></a></li>
     1450                        <li>multipart/x-byteranges&nbsp;&nbsp;<a href="#rfc.iref.m.6">A</a></li>
    14341451                     </ul>
    14351452                  </li>
    1436                   <li>multipart/byteranges Media Type&nbsp;&nbsp;<a href="#rfc.iref.m.2"><b>A</b></a></li>
    1437                   <li>multipart/x-byteranges Media Type&nbsp;&nbsp;<a href="#rfc.iref.m.3">A</a></li>
     1453                  <li>multipart/byteranges Media Type&nbsp;&nbsp;<a href="#rfc.iref.m.2"><b>5.4.1</b></a>, <a href="#rfc.iref.m.4"><b>A</b></a></li>
     1454                  <li>multipart/x-byteranges Media Type&nbsp;&nbsp;<a href="#rfc.iref.m.5">A</a></li>
    14381455               </ul>
    14391456            </li>
  • draft-ietf-httpbis/latest/p5-range.xml

    r2438 r2441  
    962962</section>
    963963
     964<section title="Internet Media Type Registration" anchor="internet.media.type.http">
     965<t>
     966   IANA maintains the registry of Internet media types <xref target="BCP13"/> at
     967   <eref target="http://www.iana.org/assignments/media-types"/>.
     968</t>
     969<t>
     970   This document serves as the specification for the Internet media type
     971   "multipart/byteranges". The following is to be registered with
     972   IANA.
     973</t>
     974<section title="Internet Media Type multipart/byteranges" anchor="internet.media.type.multipart.byteranges.reg">
     975<iref item="Media Type" subitem="multipart/byteranges" primary="true"/>
     976<iref item="multipart/byteranges Media Type" primary="true"/>
     977<t>
     978  <list style="hanging" x:indent="12em">
     979    <t hangText="Type name:">
     980      multipart
     981    </t>
     982    <t hangText="Subtype name:">
     983      byteranges
     984    </t>
     985    <t hangText="Required parameters:">
     986      boundary
     987    </t>
     988    <t hangText="Optional parameters:">
     989      none
     990    </t>
     991    <t hangText="Encoding considerations:">
     992      only "7bit", "8bit", or "binary" are permitted
     993    </t>
     994    <t hangText="Security considerations:">
     995      none
     996    </t>
     997    <t hangText="Interoperability considerations:">
     998      none
     999    </t>
     1000    <t hangText="Published specification:">
     1001      This specification (see <xref target="internet.media.type.multipart.byteranges"/>).
     1002    </t>
     1003    <t hangText="Applications that use this media type:">
     1004      HTTP components supporting multiple ranges in a single request.
     1005    </t>
     1006    <t hangText="Additional information:">
     1007      <list style="hanging">
     1008        <t hangText="Magic number(s):">none</t>
     1009        <t hangText="File extension(s):">none</t>
     1010        <t hangText="Macintosh file type code(s):">none</t>
     1011      </list>
     1012    </t>
     1013    <t hangText="Person and email address to contact for further information:">
     1014      See Authors Section.
     1015    </t>
     1016    <t hangText="Intended usage:">
     1017      COMMON
     1018    </t>
     1019    <t hangText="Restrictions on usage:">
     1020      none
     1021    </t>
     1022    <t hangText="Author:">
     1023      See Authors Section.
     1024    </t>
     1025    <t hangText="Change controller:">
     1026      IESG
     1027    </t>
     1028  </list>
     1029</t>
     1030</section>
     1031</section>
     1032
    9641033</section>
    9651034
     
    12531322   content of multiple ranges, they are transmitted as body parts in a
    12541323   multipart message body (<xref target="RFC2046" x:fmt="," x:sec="5.1"/>)
    1255    with the media type of "multipart/byteranges".  The following definition is
    1256    to be registered with IANA <xref target="BCP13"/>.
     1324   with the media type of "multipart/byteranges".
    12571325</t>
    12581326<t>
     
    12611329   fields. The required boundary parameter specifies the boundary string used
    12621330   to separate each body part.
    1263 </t>
    1264 <t>
    1265   <list style="hanging" x:indent="12em">
    1266     <t hangText="Type name:">
    1267       multipart
    1268     </t>
    1269     <t hangText="Subtype name:">
    1270       byteranges
    1271     </t>
    1272     <t hangText="Required parameters:">
    1273       boundary
    1274     </t>
    1275     <t hangText="Optional parameters:">
    1276       none
    1277     </t>
    1278     <t hangText="Encoding considerations:">
    1279       only "7bit", "8bit", or "binary" are permitted
    1280     </t>
    1281     <t hangText="Security considerations:">
    1282       none
    1283     </t>
    1284     <t hangText="Interoperability considerations:">
    1285       none
    1286     </t>
    1287     <t hangText="Published specification:">
    1288       This specification (see <xref target="internet.media.type.multipart.byteranges"/>).
    1289     </t>
    1290     <t hangText="Applications that use this media type:">
    1291       HTTP components supporting multiple ranges in a single request.
    1292     </t>
    1293     <t hangText="Additional information:">
    1294       <list style="hanging">
    1295         <t hangText="Magic number(s):">none</t>
    1296         <t hangText="File extension(s):">none</t>
    1297         <t hangText="Macintosh file type code(s):">none</t>
    1298       </list>
    1299     </t>
    1300     <t hangText="Person and email address to contact for further information:">
    1301       See Authors Section.
    1302     </t>
    1303     <t hangText="Intended usage:">
    1304       COMMON
    1305     </t>
    1306     <t hangText="Restrictions on usage:">
    1307       none
    1308     </t>
    1309     <t hangText="Author:">
    1310       See Authors Section.
    1311     </t>
    1312     <t hangText="Change controller:">
    1313       IESG
    1314     </t>
    1315   </list>
    13161331</t>
    13171332<t>
Note: See TracChangeset for help on using the changeset viewer.