From 849493eafbd549a909c79b1619f5cb98f6533cf0 Mon Sep 17 00:00:00 2001
From: Havoc Pennington <hp@redhat.com>
Date: Sat, 5 Feb 2005 03:24:54 +0000
Subject: 2005-02-04  Havoc Pennington  <hp@redhat.com>

	* doc/Makefile.am (EXTRA_DIST): add DTDs to makefile

	* doc/introspect.dtd: add introspect.dtd from David A. Wheeler
	(with some minor changes)

	* doc/dbus-specification.xml: add deprecated attribute to
	introspection format
---
 doc/Makefile.am            |  2 ++
 doc/dbus-specification.xml |  9 +++++++++
 doc/introspect.dtd         | 35 +++++++++++++++++++++++++++++++++++
 3 files changed, 46 insertions(+)
 create mode 100644 doc/introspect.dtd

(limited to 'doc')

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 11f7db96..3032c866 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,4 +1,6 @@
 EXTRA_DIST= 					\
+	busconfig.dtd				\
+	introspect.dtd				\
 	dbus-faq.xml				\
 	dbus-specification.xml			\
 	dbus-test-plan.xml			\
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 7a90e664..fdea2b42 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -2245,6 +2245,15 @@
             one &lt;node&gt;.
           </para>
         </listitem>
+        <listitem>
+          <para>
+            The method, interface, property, and signal elements may have 
+            an attribute deprecated="yes|no". If the attribute is not 
+            present, the default value for an interface is "no", and 
+            the default value for methods, properties, and signals is 
+            the deprecation status of the interface.
+          </para>
+        </listitem>
       </itemizedlist>
     </para>
 
diff --git a/doc/introspect.dtd b/doc/introspect.dtd
new file mode 100644
index 00000000..5e1c96df
--- /dev/null
+++ b/doc/introspect.dtd
@@ -0,0 +1,35 @@
+<!-- DTD for D-BUS Introspection data -->
+<!-- (C) 2005-02-02 David A. Wheeler; released under the D-BUS licenses,
+         GNU GPL version 2 (or greater) and AFL 1.1 (or greater) -->
+
+<!-- see D-BUS specification for documentation -->
+
+<!ELEMENT node (interface,node)>
+<!ATTLIST node name CDATA #REQUIRED>
+
+<!ELEMENT interface (method,signal,property)>
+<!ATTLIST interface name CDATA #REQUIRED>
+<!ATTLIST interface deprecated CDATA "no">
+
+<!ATTLIST method name CDATA #REQUIRED>
+<!ATTLIST method deprecated #IMPLIED>
+
+<!ELEMENT arg EMPTY>
+<!ATTLIST arg name CDATA #REQUIRED>
+<!ATTLIST arg type CDATA #REQUIRED>
+<!-- Method arguments SHOULD include "direction",
+     while signal and error arguments SHOULD not (since there's no point).
+     The DTD format can't express that subtlety. -->
+<!ATTLIST arg direction "in|out" #IMPLIED>
+
+<!ELEMENT signal (arg)>
+<!ATTLIST signal name CDATA #REQUIRED>
+<!ATTLIST signal deprecated #IMPLIED>
+
+<!ELEMENT property>  <!-- AKA "attribute" -->
+<!ATTLIST property name CDATA #REQUIRED>
+<!ATTLIST property type CDATA #REQUIRED>
+<!ATTLIST property access "read|write|readwrite" #REQUIRED>
+<!ATTLIST property deprecated #IMPLIED>
+
+
-- 
cgit