2003-08-30 Havoc Pennington <hp@pobox.com>
[platform/upstream/dbus.git] / tools / dbus-send.1
index 978ee2e..725507c 100644 (file)
@@ -8,7 +8,8 @@ dbus-send \- Send a message to a message bus
 .SH SYNOPSIS
 .PP
 .B dbus-send
-[\-\-system | \-\-session] [\-\-dest=SERVICE] [\-\-print-reply] [\-\-type=TYPE] <message name> [contents ...]
+[\-\-system | \-\-session] [\-\-dest=SERVICE] [\-\-print-reply]
+[\-\-type=TYPE] <destination object path> <message name> [contents ...]
 
 .SH DESCRIPTION
 
@@ -28,21 +29,22 @@ specified, \fIdbus-send\fP sends to the session bus.
 Nearly all uses of \fIdbus-send\fP must provide the \-\-dest argument
 which is the name of a service on the bus to send the message to. If
 \-\-dest is omitted, a default service name of
-"org.freedesktop.DBus.Broadcast" is used.  
+"org.freedesktop.Broadcast" is used.  
 
 .PP
-The name of the message to send must always be specified. Following
-arguments, if any, are the message contents (message arguments).
-These are given as a type name, a colon, and then the value of the
-argument. The possible type names are: string, int32, uint32, double,
-byte, boolean.  (D-BUS supports more types than these, but
-\fIdbus-send\fP currently does not.)
+The object path and the name of the message to send must always be
+specified. Following arguments, if any, are the message contents
+(message arguments).  These are given as a type name, a colon, and
+then the value of the argument. The possible type names are: string,
+int32, uint32, double, byte, boolean.  (D-BUS supports more types than
+these, but \fIdbus-send\fP currently does not.)
 
 .PP
 Here is an example invocation:
 .nf
 
   dbus-send \-\-dest='org.freedesktop.ExampleService'        \\
+            /org/freedesktop/sample/object/name              \\
             org.freedesktop.ExampleInterface.ExampleMethod   \\
             int32:47 string:'hello world' double:65.32