updated Mime Type section
authorStephan Zednik <zednis@rpi.edu>
Sat, 23 Feb 2013 12:39:11 -0700
changeset 5727 bb81648f65e5
parent 5726 508670ac5f5e
child 5728 2ce9dfc0c687
updated Mime Type section
xml/prov-xml.html
--- a/xml/prov-xml.html	Fri Feb 22 12:17:00 2013 +0000
+++ b/xml/prov-xml.html	Sat Feb 23 12:39:11 2013 -0700
@@ -88,13 +88,23 @@
           for (var k in extraReferences)
               berjon.biblio[k] = extraReferences[k];
       };
+      
       var extraReferences = {
-        
-        "Mappings":
-          "Satya Sahoo and Paul Groth and Olaf Hartig and Simon Miles and Sam Coppens and James Myers and Yolanda Gil and Luc Moreau and Jun Zhao and Michael Panzer and Daniel Garijo "+
-          "<a href=\"http://www.w3.org/2005/Incubator/prov/wiki/Provenance_Vocabulary_Mappings\"><cite>Provenance Vocabulary Mappings</cite></a>. "+
-          "August 2010 "+
-          "URL: <a href=\"http://www.w3.org/2005/Incubator/prov/wiki/Provenance_Vocabulary_Mappings\">http://www.w3.org/2005/Incubator/prov/wiki/Provenance_Vocabulary_Mappings</a>",
+      "Mappings":
+      "Satya Sahoo and Paul Groth and Olaf Hartig and Simon Miles and Sam Coppens and James Myers and Yolanda Gil and Luc Moreau and Jun Zhao and Michael Panzer and Daniel Garijo "+
+      "<a href=\"http://www.w3.org/2005/Incubator/prov/wiki/Provenance_Vocabulary_Mappings\"><cite>Provenance Vocabulary Mappings</cite></a>. "+
+      "August 2010 "+
+      "URL: <a href=\"http://www.w3.org/2005/Incubator/prov/wiki/Provenance_Vocabulary_Mappings\">http://www.w3.org/2005/Incubator/prov/wiki/Provenance_Vocabulary_Mappings</a>",
+      "UNICODE" : 
+      "The Unicode Consortium. "+
+      " <a href=\"http://www.unicode.org/unicode/standard/versions/enumeratedversions.html\"><cite>The Unicode Standard.</cite></a> " +
+      " Defined by: The Unicode Standard, Version 6.2.0, (Mountain View, CA: The Unicode Consortium, 2012. ISBN 978-1-936213-07-8) , as updated from time to time by the publication of new versions "+
+      "URL: <a href=\"http://www.unicode.org/unicode/standard/versions/enumeratedversions.html\">http://www.unicode.org/unicode/standard/versions/enumeratedversions.html</a> ",
+      "UNISEC":
+      " Mark Davis; Michel Suignard. " +
+      "<a href=\"http://www.unicode.org/reports/tr36/\"><cite>Unicode Security Considerations<cite></a>. " +
+      " 4 August 2010. " +
+      "URL: <a href=\"http://www.unicode.org/reports/tr36/\">http://www.unicode.org/reports/tr36/</a>",
         
       };
       var respecConfig = {
@@ -2131,16 +2141,70 @@
 <!-- end sec. 5 -->
 
 
-<section  id="media-type">
+<section id="media-type">
 <h3>Media Type</h3>
 
-<p>
-The internet media type / MIME type for PROV-XML is "<code style="color: black">application/provenance+xml</code>".
-</p>
+<dl>
+	<dt>Contact:</dt>
+	<dd>Ivan Herman</dd>
+	<dt>See also:</dt>
+	<dd><a href="http://www.w3.org/2002/06/registering-mediatype">How to Register a Media Type for a W3C Specification</a></dd>
+	<dd><a href="http://www.w3.org/2001/tag/2002/0129-mime">Internet Media Type registration, consistency of use</a><br />TAG Finding 3 June 2002 (Revised 4 September 2002)</dd>
+</dl>
 
-<p>
-It is recommended that PROV-XML files have the extension "<code style="color: black">.provx</code>" (all lowercase) on all platforms.
-</p>
+<p>The Internet Media Type / MIME type for PROV-XML is "<code style="color: black">application/provenance+xml</code>".</p>
+
+<p>It is recommended that PROV-XML files have the extension "<code style="color: black">.provx</code>" (all lowercase) on all platforms.</p>
+
+<p>It is recommended that PROV-XML files stored on Macintosh HFS file systems be given a file type of <code style="color: black">TEXT</code>.</p>
+
+<p>The information that follows has been <a href="https://lists.w3.org/Archives/Member/w3c-archive/2012Nov/0317.html">submitted to the IESG</a> for review, approval, and registration with IANA.</p>
+
+<dl>
+	<dt>Type name:</dt>
+	<dd>application</dd>
+	<dt>Subtype name:</dt>
+	<dd>provenance+xml</dd>
+	<dt>Required parameters:</dt>
+	<dd>none</dd>
+	<dt>Optional parameters:</dt>
+	<dd>charset - this parameter may be required when transferring non-ASCII data across some protocols.</dd>
+	<dt>Encoding considerations:</dt>
+	<dd>The syntax of PROV-XML is expressed over code points in Unicode [[!UNICODE]]</dd>
+	<dt>Security considerations:</dt>
+	<dd>PROV-XML is an XML language for describing the provenance of things; applications may evaluate given data to dereference URIs, invoking the security considerations of the scheme for that URI. Note in particular, the privacy issues in [[!RFC3023]] section 10 for HTTP URIs. Data obtained from an inaccurate or malicious data source may lead to inaccurate or misleading conclusions, as well as the dereferencing of unintended URIs. Care must be taken to align the trust in consulted resources with the sensitivity of the intended use of the data.</dd>
+	<dd>PROV-XML can express data which is presented to the user, for example, by means of label attributes. Application rendering strings retrieved from untrusted PROV-N documents must ensure that malignant strings may not be used to mislead the reader. The security considerations in the media type registration for XML ([[!RFC3023]] section 10) provide additional guidance around the expression of arbitrary data and markup.</dd>
+	<dd>PROV-XML is a language for describing the provenance of things, and therefore a PROV-XML document is metadata for other resources.  Untrusted PROV-XML documents may mislead its consumers by indicating that a third-party resource has a reputable lineage, when it has not. Provenance of PROV-XML document should be sought. </dd>
+	<dd>PROV-XML uses QNames mappable to IRIs as term identifiers. Applications interpreting data expressed in PROV-XML should address the security issues of
+  <a class="norm" href="http://www.ietf.org/rfc/rfc3987.txt">Internationalized Resource Identifiers (IRIs)</a> [[!RFC3987]] Section 8, as well as
+  <a class="norm" href="http://www.ietf.org/rfc/rfc3986.txt">Uniform Resource Identifier (URI): Generic Syntax</a> [[!RFC3986]] Section 7.</dd>
+  	<dd>Multiple IRIs may have the same appearance. Characters in different scripts may look similar (a Cyrillic &quot;&#1086;&quot; may appear similar to a Latin &quot;o&quot;). A character followed by combining characters may have the same visual representation as another character (LATIN SMALL LETTER E followed by COMBINING ACUTE ACCENT has the same visual representation as LATIN SMALL LETTER E WITH ACUTE).  Any person or application that is writing or interpreting data in PROV-N must take care to use the IRI that matches the intended semantics, and avoid IRIs that make look similar. Further information about matching of similar characters can be found in <a class="inform" href="http://www.unicode.org/reports/tr36/">Unicode Security Considerations</a> [[UNISEC]] and <a class="norm" href="http://www.ietf.org/rfc/rfc3987.txt">Internationalized Resource Identifiers (IRIs)</a> [[!RFC3987]] Section 8.</dd>
+	<dt>Interoperability considerations:</dt>
+	<dd>There are no known interoperability issues.</dd>
+	<dt>Published specification:</dt>
+	<dd>This specification.</dd>
+	<dt>Applications which use this media type:</dt>
+	<dd>It may be used by any application for publishing provenance information.  This format is designed to be an XML form of provenance.</dd>
+	<dt>Additional Information:</dt>
+	<dt>Magic number(s):</dt>
+	<dd>PROV-XML documents are XML documents and thus may have initial strings similar to any XML document.</dd>
+	<dt>File extension(s):</dt>
+	<dd>.provx</dd>
+	<dt>Base URI:</dt>
+	<dd>As in XML.</dd>
+	<dt>Macintosh file type code(s):</dt>
+	<dd>&quot;TEXT&quot;</dd>
+	<dt>Person &amp; email address to contact for further information</dt>
+	<dd>Ivan Herman, ivan@w3.org</dd>
+	<dt>Intended usage:</dt>
+	<dd>COMMON</dd>
+	<dt>Restrictions on usage:</dt>
+	<dd>None</dd>
+	<dt>Author/Change controller:</dt>
+	<dd>The PROV-XML specification is the product of the World Wide Web Consortium's Provenance Working Group. The W3C has change control over this specification.</dd>
+</dl>
+
+
 
 </section> <!-- end media-type -->