dbus/doc Makefile.am, 1.16, 1.17 dbus-specification.xml, 1.21, 1.22 introspect.dtd, NONE, 1.1

[Havoc Pennington]

Update of /cvs/dbus/dbus/doc
In directory gabe:/tmp/cvs-serv14314/doc

Modified Files:
	Makefile.am dbus-specification.xml 
Added Files:
	introspect.dtd 
Log Message:
2005-02-04  Havoc Pennington  <hp at 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



Index: Makefile.am
===================================================================
RCS file: /cvs/dbus/dbus/doc/Makefile.am,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- Makefile.am	23 Jan 2005 00:28:40 -0000	1.16
+++ Makefile.am	5 Feb 2005 03:24:54 -0000	1.17
@@ -1,4 +1,6 @@
 EXTRA_DIST= 					\
+	busconfig.dtd				\
+	introspect.dtd				\
 	dbus-faq.xml				\
 	dbus-specification.xml			\
 	dbus-test-plan.xml			\

Index: dbus-specification.xml
===================================================================
RCS file: /cvs/dbus/dbus/doc/dbus-specification.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- dbus-specification.xml	29 Jan 2005 20:12:21 -0000	1.21
+++ dbus-specification.xml	5 Feb 2005 03:24:54 -0000	1.22
@@ -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>
 

--- NEW FILE: introspect.dtd ---
<!-- 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>