aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJuanma Barranquero2010-06-05 22:36:27 +0200
committerJuanma Barranquero2010-06-05 22:36:27 +0200
commit35b148ee23a71d8a1e2c585eded278fa32208f8b (patch)
tree6eddbd5ad2258c8f74e9ae0b677a0ea6ad809f0b
parent86253dc05d5fd22d837806b4deecedbe8f5f09c6 (diff)
downloademacs-35b148ee23a71d8a1e2c585eded278fa32208f8b.tar.gz
emacs-35b148ee23a71d8a1e2c585eded278fa32208f8b.zip
* net/dbus.el: Fix typos and declare function.
-rw-r--r--lisp/ChangeLog10
-rw-r--r--lisp/net/dbus.el19
2 files changed, 18 insertions, 11 deletions
diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 8a10343171a..f4ba9e0fb40 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,11 @@
12010-06-05 Juanma Barranquero <lekktu@gmail.com>
2
3 * net/dbus.el (dbus-register-method): Declare function.
4 (dbus-handle-event, dbus-property-handler): Fix typos in docstrings.
5 (dbus-introspect): Doc fix.
6 (dbus-event-bus-name, dbus-introspect-get-interface)
7 (dbus-introspect-get-argument): Reflow docstrings.
8
12010-06-04 Chong Yidong <cyd@stupidchicken.com> 92010-06-04 Chong Yidong <cyd@stupidchicken.com>
2 10
3 * term/common-win.el (x-colors): Add "dark green" and "dark 11 * term/common-win.el (x-colors): Add "dark green" and "dark
@@ -424,7 +432,7 @@
424 432
425 * files.el (auto-mode-alist): Accept more verilog file patterns. 433 * files.el (auto-mode-alist): Accept more verilog file patterns.
426 434
4272010-03-09 Miles Bader <miles@gnu.org>> 4352010-03-09 Miles Bader <miles@gnu.org>
428 436
429 * vc-git.el (vc-git-print-log): Use "tformat:" for shortlog, 437 * vc-git.el (vc-git-print-log): Use "tformat:" for shortlog,
430 instead of "format:"; this ensures that the output is 438 instead of "format:"; this ensures that the output is
diff --git a/lisp/net/dbus.el b/lisp/net/dbus.el
index 5635640cd4c..46cbb723d76 100644
--- a/lisp/net/dbus.el
+++ b/lisp/net/dbus.el
@@ -38,6 +38,7 @@
38(declare-function dbus-method-return-internal "dbusbind.c") 38(declare-function dbus-method-return-internal "dbusbind.c")
39(declare-function dbus-method-error-internal "dbusbind.c") 39(declare-function dbus-method-error-internal "dbusbind.c")
40(declare-function dbus-register-signal "dbusbind.c") 40(declare-function dbus-register-signal "dbusbind.c")
41(declare-function dbus-register-method "dbusbind.c")
41(defvar dbus-debug) 42(defvar dbus-debug)
42(defvar dbus-registered-objects-table) 43(defvar dbus-registered-objects-table)
43 44
@@ -398,7 +399,7 @@ not well formed."
398 "Handle events from the D-Bus. 399 "Handle events from the D-Bus.
399EVENT is a D-Bus event, see `dbus-check-event'. HANDLER, being 400EVENT is a D-Bus event, see `dbus-check-event'. HANDLER, being
400part of the event, is called with arguments ARGS. 401part of the event, is called with arguments ARGS.
401If the HANDLER returns an `dbus-error', it is propagated as return message." 402If the HANDLER returns a `dbus-error', it is propagated as return message."
402 (interactive "e") 403 (interactive "e")
403 (condition-case err 404 (condition-case err
404 (let (result) 405 (let (result)
@@ -434,8 +435,7 @@ If the HANDLER returns an `dbus-error', it is propagated as return message."
434 "Return the bus name the event is coming from. 435 "Return the bus name the event is coming from.
435The result is either the symbol `:system' or the symbol `:session'. 436The result is either the symbol `:system' or the symbol `:session'.
436EVENT is a D-Bus event, see `dbus-check-event'. This function 437EVENT is a D-Bus event, see `dbus-check-event'. This function
437raises a `dbus-error' signal in case the event is not well 438raises a `dbus-error' signal in case the event is not well formed."
438formed."
439 (dbus-check-event event) 439 (dbus-check-event event)
440 (nth 1 event)) 440 (nth 1 event))
441 441
@@ -562,7 +562,7 @@ apply
562;;; D-Bus introspection. 562;;; D-Bus introspection.
563 563
564(defun dbus-introspect (bus service path) 564(defun dbus-introspect (bus service path)
565 "This function returns all interfaces and sub-nodes of SERVICE, 565 "Return all interfaces and sub-nodes of SERVICE,
566registered at object path PATH at bus BUS. 566registered at object path PATH at bus BUS.
567 567
568BUS must be either the symbol `:system' or the symbol `:session'. 568BUS must be either the symbol `:system' or the symbol `:session'.
@@ -634,9 +634,8 @@ children, beside \"method\" and \"signal\" objects."
634(defun dbus-introspect-get-interface (bus service path interface) 634(defun dbus-introspect-get-interface (bus service path interface)
635 "Return the INTERFACE of SERVICE in D-Bus BUS at object path PATH. 635 "Return the INTERFACE of SERVICE in D-Bus BUS at object path PATH.
636The return value is an XML object. INTERFACE must be a string, 636The return value is an XML object. INTERFACE must be a string,
637element of the list returned by 637element of the list returned by `dbus-introspect-get-interface-names'.
638`dbus-introspect-get-interface-names'. The resulting 638The resulting \"interface\" object can contain \"method\", \"signal\",
639\"interface\" object can contain \"method\", \"signal\",
640\"property\" and \"annotation\" children." 639\"property\" and \"annotation\" children."
641 (let ((elt (xml-get-children 640 (let ((elt (xml-get-children
642 (dbus-introspect-xml bus service path) 'interface))) 641 (dbus-introspect-xml bus service path) 'interface)))
@@ -776,8 +775,8 @@ therefore, even if the method or signal has arguments."
776 775
777(defun dbus-introspect-get-argument (bus service path interface name arg) 776(defun dbus-introspect-get-argument (bus service path interface name arg)
778 "Return argument ARG as XML object. 777 "Return argument ARG as XML object.
779NAME must be a \"method\" or \"signal\" object. ARG must be a 778NAME must be a \"method\" or \"signal\" object. ARG must be a string,
780string, element of the list returned by `dbus-introspect-get-argument-names'." 779element of the list returned by `dbus-introspect-get-argument-names'."
781 (let ((elt (xml-get-children 780 (let ((elt (xml-get-children
782 (or (dbus-introspect-get-method bus service path interface name) 781 (or (dbus-introspect-get-method bus service path interface name)
783 (dbus-introspect-get-signal bus service path interface name)) 782 (dbus-introspect-get-signal bus service path interface name))
@@ -922,7 +921,7 @@ PATH, including a default handler for the \"Get\", \"GetAll\" and
922 (list key (list service path)))) 921 (list key (list service path))))
923 922
924(defun dbus-property-handler (&rest args) 923(defun dbus-property-handler (&rest args)
925 "Default Handler for the \"org.freedesktop.DBus.Properties\" interface. 924 "Default handler for the \"org.freedesktop.DBus.Properties\" interface.
926It will be registered for all objects created by `dbus-register-object'." 925It will be registered for all objects created by `dbus-register-object'."
927 (let ((bus (dbus-event-bus-name last-input-event)) 926 (let ((bus (dbus-event-bus-name last-input-event))
928 (path (dbus-event-path-name last-input-event)) 927 (path (dbus-event-path-name last-input-event))