summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthew Johnson <mjj29@hecate.trinhall.cam.ac.uk>2006-11-22 17:31:46 +0000
committerMatthew Johnson <mjj29@hecate.trinhall.cam.ac.uk>2006-11-22 17:31:46 +0000
commit95b17300b6ea8c5ff7c8641559f7cb6f3b81285a (patch)
tree9739451440a765ce2f49d06a9972e3a7bb2097f2
parent862796d03cd897baf51557a7013c37025a482084 (diff)
documentation for Path
-rw-r--r--TODO1
-rw-r--r--dbus-java.tex9
2 files changed, 9 insertions, 1 deletions
diff --git a/TODO b/TODO
index e723e8b..322cdab 100644
--- a/TODO
+++ b/TODO
@@ -1,4 +1,3 @@
- * add Path to documentation
* support Enums as UInt32s
* use native java backend
* allow 'virtual' object handlers, so that all object paths under a certain hierarchy are handled by the same object
diff --git a/dbus-java.tex b/dbus-java.tex
index 400f956..f30bd12 100644
--- a/dbus-java.tex
+++ b/dbus-java.tex
@@ -540,6 +540,14 @@ receive an object path they will automatically convert it into the object you
are exporting with that object path. You can pass remote objects back to their
processes in a similar fashion.
+Using a parameter of type {\tt DBusInterface} can cause the automatic creation
+of a proxy object using introspection. If the remote app does not support
+introspection, or the object does not exist at the time you receive the message
+then this will fail. In that case the parameter can be declared to be of type
+{\tt Path}. In this case no automatic creation will be performed and you can
+get the path as a string with either the {\tt getPath} or {\tt toString} methods
+on the {\tt Path} object.
+
\subsection{Multiple Return Values}
@@ -609,6 +617,7 @@ UInt64 & DBUS\_TYPE\_UINT64 \\
double & DBUS\_TYPE\_DOUBLE \\
Double & DBUS\_TYPE\_DOUBLE \\
String & DBUS\_TYPE\_STRING \\
+Path & DBUS\_TYPE\_OBJECT\_PATH \\
$<$T$>$ & DBUS\_TYPE\_VARIANT \\
Variant & DBUS\_TYPE\_VARIANT \\
? extends Struct & DBUS\_TYPE\_STRUCT \\