From a61b06aa1aee4743f50024b0695795fe9568d929 Mon Sep 17 00:00:00 2001 From: Waldo Bastian Date: Wed, 23 Mar 2005 21:24:19 +0000 Subject: Clearify DTD conformance and version compatibility --- menu/ChangeLog | 4 ++++ menu/menu-spec.xml | 45 +++++++++++++++++++++++++++++---------------- 2 files changed, 33 insertions(+), 16 deletions(-) (limited to 'menu') diff --git a/menu/ChangeLog b/menu/ChangeLog index c4ff5a5..0a19e5f 100644 --- a/menu/ChangeLog +++ b/menu/ChangeLog @@ -1,3 +1,7 @@ +2005-03-23 Waldo Bastian + + * menu-spec.xml: Clearify DTD conformance and version compatibility + 2005-03-22 Waldo Bastian * menu-spec.xml, menu.dtd: Added type attribute to diff --git a/menu/menu-spec.xml b/menu/menu-spec.xml index b61063e..0da49e7 100644 --- a/menu/menu-spec.xml +++ b/menu/menu-spec.xml @@ -1,10 +1,13 @@ + ]> +
Desktop Menu Specification - Version 0.91 + Version &version; 15 March 2005 @@ -249,11 +252,20 @@ entries: Categories, Format of menu files - Menu files must be well-formed XML files, conform to the menu file DTD, - and end in the extension ".menu". DTD conformance implies that - implementation-specific extensions to the file format are not allowed; - implementations are expected to stop processing if they encounter XML - elements or attributes that are not specified in this document. + Menu files must be well-formed XML files and end in the extension + ".menu". They should also conform to the menu file DTD which implies + that implementation-specific extensions to the file format are not + allowed. Implementations may stop processing if they encounter a menu + file which does not comply with the associated DTD. Note that the + associated DTD may differ in version from the one defined in this document. + + + When an implementation updates an existing menu file it may need to + update the identifier to a newer version of the DTD. Implementations + should never update the identifier of an existing menu file to an + older version. In order to remain compatible with newer versions, + implementations should ignore and preserve any XML elements, + attributes and attribute values that it does not know how to handle. Document Type Declaration @@ -270,18 +282,19 @@ entries: Categories, - Public Identifier for 0.8 + Public Identifier for &version; - PUBLIC "-//freedesktop//DTD Menu 0.8//EN" + PUBLIC "-//freedesktop//DTD Menu &dtd-version;//EN" - System Identifier for 0.8 + System Identifier for &version; - http://www.freedesktop.org/standards/menu-spec/menu-0.8.dtd + +http://www.freedesktop.org/standards/menu-spec/menu-&dtd-version;.dtd @@ -290,8 +303,8 @@ entries: Categories, Here is a sample document type declaration: - <!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu 0.8//EN" - "http://www.freedesktop.org/standards/menu-spec/menu-0.8.dtd"> + <!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu &dtd-version;//EN" + "http://www.freedesktop.org/standards/menu-spec/menu-&dtd-version;.dtd"> @@ -1191,8 +1204,8 @@ entries: Categories, Conceptually that is converted to the following <Menu>: - <!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu 0.8//EN" - "http://www.freedesktop.org/standards/menu-spec/menu-0.8.dtd"> + <!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu &dtd-version;//EN" + "http://www.freedesktop.org/standards/menu-spec/menu-&dtd-version;.dtd"> <Menu> <Name>Applications</Name> @@ -1224,8 +1237,8 @@ entries: Categories, - <!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu 0.8//EN" - "http://www.freedesktop.org/standards/menu-spec/menu-0.8.dtd"> + <!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu &dtd-version;//EN" + "http://www.freedesktop.org/standards/menu-spec/menu-&dtd-version;.dtd"> <Menu> <Name>Applications</Name> -- cgit v1.2.3-70-g09d2