idnits 2.17.1 draft-miller-media-type-cellml-03.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** It looks like you're using RFC 3978 boilerplate. You should update this to the boilerplate described in the IETF Trust License Policy document (see https://trustee.ietf.org/license-info), which is required now. -- Found old boilerplate from RFC 3978, Section 5.1 on line 16. -- Found old boilerplate from RFC 3978, Section 5.5 on line 298. ** This document has an original RFC 3978 Section 5.4 Copyright Line, instead of the newer IETF Trust Copyright according to RFC 4748. ** This document has an original RFC 3978 Section 5.5 Disclaimer, instead of the newer disclaimer which includes the IETF Trust according to RFC 4748. ** The document seems to lack an RFC 3979 Section 5, para. 1 IPR Disclosure Acknowledgement. ** The document seems to lack an RFC 3979 Section 5, para. 2 IPR Disclosure Acknowledgement. ** The document seems to lack an RFC 3979 Section 5, para. 3 IPR Disclosure Invitation. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- ** Missing expiration date. The document expiration date should appear on the first and last page. == No 'Intended status' indicated for this document; assuming Proposed Standard == The page length should not exceed 58 lines per page, but there was 1 longer page, the longest (page 3) being 64 lines Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** There is 1 instance of too long lines in the document, the longest one being 1 character in excess of 72. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the RFC 3978 Section 5.4 Copyright Line does not match the current year -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (May 2006) is 6549 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) -- Possible downref: Non-RFC (?) normative reference: ref. 'CELLML-UMBRELLA' -- Possible downref: Non-RFC (?) normative reference: ref. 'NAMESPACES' ** Obsolete normative reference: RFC 3023 (Obsoleted by RFC 7303) -- Possible downref: Non-RFC (?) normative reference: ref. 'XML' -- Obsolete informational reference (is this intentional?): RFC 4288 (Obsoleted by RFC 6838) Summary: 9 errors (**), 0 flaws (~~), 3 warnings (==), 8 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 Internet Draft 2 draft-miller-media-type-cellml-03.txt 4 Intended Status: 5 Network Working Group A. K. Miller 6 Request for Comments: nnnn The University of Auckland 7 Standards Track May 2006 9 CellML Media Type 11 Status of this Memo 13 By submitting this Internet-Draft, each author represents that any 14 applicable patent or other IPR claims of which he or she is aware 15 have been or will be disclosed, and any of which he or she becomes 16 aware will be disclosed, in accordance with Section 6 of BCP 79. 18 Internet-Drafts are working documents of the Internet Engineering 19 Task Force (IETF), its areas, and its working groups. Note that 20 other groups may also distribute working documents as Internet- 21 Drafts. 23 Internet-Drafts are draft documents valid for a maximum of six 24 months and may be updated, replaced, or obsoleted by other documents 25 at any time. It is inappropriate to use Internet-Drafts as 26 reference material or to cite them other than as "work in progress. 28 The list of current Internet-Drafts can be accessed at 29 http://www.ietf.org/1id-abstracts.html 31 The list of Internet-Draft Shadow Directories can be accessed at 32 http://www.ietf.org/shadow.html 34 Copyright Notice 36 Copyright (C) The Internet Society (2006). 38 Abstract 40 This document standardises a new media type -- 41 application/cellml+xml -- for use in exchanging mathematical models 42 represented in a CellML Umbrella 1.0 compliant markup language. 44 1. Introduction 46 CellML Umbrella format is a standardised markup meta-language for the 47 interchange of mathematical models. CellML Umbrella Format provides 48 a common base which is supported by a number of specific formats 49 used in the interchange of mathematical models. CellML Umbrella 50 Format provides enough information to determine which specific 51 language is used to express the model. The syntax and semantics of 52 the CellML Umbrella format are defined by [CELLML-UMBRELLA]. 54 This document standardises a new media type -- 55 application/cellml+xml -- for use in exchanging mathematical models 56 represented in a specific CellML Umbrella compliant language. 58 2. Notational Conventions 60 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 61 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 62 document are to be interpreted as described in [RFC2119]. 64 The terms "element" and "document element" in this document are to be 65 interpreted as in [XML]. 67 The term "XML namespace" is to be interpreted as in [NAMESPACES]. 69 3. Discussion 71 CellML Umbrella is an XML-based markup meta-language for the 72 interchange of mathmatical models. 74 CellML Umbrella format is an actual media format. Although 75 CellML Umbrella documents contain elements in namespaces defined by 76 other specifications such as [RDF] and [MATHML], the information in 77 these namespaces do not contain sufficient information to define a 78 mathematical model, and so CellML provides the information required 79 to interconnect the different CellML components, as well as the 80 information required to link CellML components to their metadata. As 81 such, CellML Umbrella documents are more than just a collection of 82 entities defined elsewhere, and so a new media type is required to 83 identify CellML. 85 As all well-formed CellML Umbrella documents are also well-formed 86 XML documents, the convention described in Section 7 of [RFC3023] 87 has been observed by use of the +xml suffix. 89 The information in CellML Umbrella documents cannot be interpreted 90 without understanding the semantics of the XML elements used to mark 91 up the model structure. Therefore, the application top-level type is 92 used instead of the text top-level type. 94 4. Media Type Registration for CellML Umbrella 96 MIME media type name: application 98 MIME subtype name: cellml+xml 100 Mandatory parameters: none 102 Optional parameters: charset 104 The charset parameter of application/cellml+xml is handled in 105 the same fashion as for application/xml, as specified in Section 106 3.2 of [RFC3023]. 108 Encoding considerations: As per Section 3.2 of [RFC3023]. 110 Security considerations: As per Section 6 of this document. 112 Interoperability considerations: As per Section 5.1 of this 113 document. 115 Published specification: 117 CellML Umbrella Specification[CELLML-UMBRELLA]. 119 Applications which use this media type: As per Section 5.2 of this 120 document. 122 Additional information: 124 Magic number(s): None. 125 XML processing software may identify CellML Umbrella documents 126 as XML documents which contain a document element with local 127 name "model". 129 File extension(s): 130 The recommended file extension for CellML Umbrella documents is 131 .cellml 133 Some older software uses the file extension .xml. Software 134 vendors have also used the non-standard extension .cml. In 135 contexts where the MIME type is available, or where the type has 136 already been determined as CellML, implementations SHOULD allow 137 files to be opened regardless of the extension. Implementations 138 transferring models to an environment which uses file extensions 139 SHOULD use the .cellml extension. 141 Macintosh File Type Code(s): "TEXT" 143 Person & email address to contact for further information: 144 See the Author's Address section of this document. 146 Intended usage: COMMON 148 Author/Change controller: The CellML Umbrella 1.0 specification 149 was authored by Andrew Miller. 151 The CellML Umbrella 1.0 specification itself will not change. 152 However, the umbrella specification defines the process for new 153 specific formats to be registered. The Bioengineering Institute 154 at The University of Auckland, with input from the CellML 155 Community via the cellml-discussion@cellml.org mailing list, 156 has control over the CellML Umbrella Format Registry. 158 5. Interoperability and usage 159 5.1. Interoperability Considerations 160 The interoperability considerations in Section 3.1 of [RFC3023] 161 also apply to CellML Umbrella documents. CellML Umbrella documents 162 contain XML elements defined by each specific format, all of which 163 are published specifications. In addition to the ability to 164 parse XML, user agents require software support for the semantics of 165 [RDF] and/or part or all of a specific format. As efforts are made 166 to keep the number of specific formats small, user agents SHOULD 167 implement all specific formats listed in the registry at the time 168 they were developed. 170 5.2. Applications which use CellML Umbrella Format 171 CellML Umbrella is device-, platform-, and vendor-neutral and is 172 supported by a wide range of CellML processing tools, including 173 those designed to validate, edit, and/or visualise CellML models, 174 extract MathML or RDF, translate to or from other related 175 specifications, evaluate mathematics and ordinary differential 176 equations, fit parameters to models, and serve, archive and annotate 177 models. 179 6. Security Considerations 181 As CellML Umbrella is an XML based markup language, all the security 182 considerations presented in section 10 of [RFC3023] also apply to 183 CellML Umbrella. 185 Some types of CellML Umbrella documents can refer to other Uniform 186 Resource Locators (URLs) in a number of places: 187 i) References to XML document type definitions or schemas. 188 ii) References to other models using the import features of some 189 specific formats. 190 iii) References to other documents embedded in user-defined data. 192 Some types of CellML processing software may then 193 automatically attempt to access the URL and retrieve the document. 194 This retrieval could have several consequences, specifically, 195 i) if a CellML document is transferred via e-mail, the fact that 196 the recipient has opened the CellML document could be 197 disclosed to the sender without the recipient's knowledge or 198 consent. 200 ii) where the recipient of a document transfers the document to 201 another location using the MIME type defined in this 202 document, the original author of the document may be notified 203 of the second address by the attempted retrieval of further 204 documents. 205 iii) by performing requests on the recipient's behalf, the CellML 206 processing software may cause actions to be performed with 207 privileges granted to the recipient, without the recipient's 208 knowledge or consent. 210 CellML processing software can mitigate this threat when running in 211 an environment where it is a concern by requiring explicit 212 confirmation from the user before attempting to load any external 213 documents. 215 7. IANA Considerations 217 This document specifies a new media type. IANA will add this media 218 type to the media types registry as specified in [RFC4288]. 220 8. References 221 8.1. Normative References 223 [CELLML-UMBRELLA] Miller, A.K., "CellML Umbrella Specification 1.0", 224 20 April 2006, 225 228 [NAMESPACES] Bray, T., et. al., "Namespaces in XML 1.1", 229 4 February 2004, 230 232 [RFC2119] Bradner, S., "Key words for use in RFCs to 233 Indicate Requirement Levels", RFC 2119, BCP 14, 234 March 1997 236 [RFC3023] Murata, M., Simon, S.L., Kohn, D., "XML Media 237 Types", RFC 3023, January 2001 239 [XML] Bray, T., et. al., "Extensible Markup Language 240 (XML) 1.0 (Third Edition)", 4 February 2004, 241 243 8.2. Informative References 244 [MATHML] Ion, P. and Miner, R.(editors) "Mathematical 245 Markup Language (MathML) 1.01 Specification", 7 246 July 1999, 248 [RDF] Beckett, D.(editor) "RDF/XML Syntax Specification 249 (Revised)", 10 February 2004, 250 252 [RFC4288] Freed, N. and Klensin, J.C., "Media Type 253 Specifications and Registration Procedures", 254 RFC 4288, BCP 13, December 2005 256 Author's Address 258 Andrew Miller 259 The Bioengineering Institute at The University of Auckland 260 Level 6, 70 Symonds St 261 Auckland Central 262 Auckland 264 E-mail: ak.miller@auckland.ac.nz 266 Full Copyright Statement 268 Copyright (C) The Internet Society (2006). 270 This document is subject to the rights, licenses and restrictions 271 contained in BCP 78, and except as set forth therein, the authors 272 retain all their rights. 274 This document and translations of it may be copied and furnished 275 to others, and derivative works that comment on or otherwise 276 explain it or assist in its implementation may be prepared, copied, 277 published and distributed, in whole or in part, without 278 restriction of any kind, provided that the above copyright notice 279 and this paragraph are included on all such copies and derivative 280 works. However, this document itself may not be modified in any 281 way, such as by removing the copyright notice or references to the 282 Internet Society or other Internet organizations, except as needed 283 for the purpose of developing Internet standards in which case the 284 procedures for copyrights defined in the Internet Standards 285 process must be followed, or as required to translate it into 286 languages other than English. 288 The limited permissions granted above are perpetual and will not 289 be revoked by the Internet Society or its successors or assigns. 291 This document and the information contained herein 292 are provided on an "AS IS" basis and THE CONTRIBUTOR, THE 293 ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE 294 INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM 295 ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO 296 ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT 297 INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY 298 OR FITNESS FOR A PARTICULAR PURPOSE.