On Wed, 2013-04-03 at 16:39 -0400, Chris Lumens wrote:
> +def dbus_call_safe_sync(service, obj_path, iface, method,
args,
> + connection=None):
> + """
> + Safely all a given method on a given object of a given service over DBus
Typo - should be "call", not "all".
Good catch, fixed locally.
> + @param service: DBus service to use
> + @type service: str
> + @param obj_path: object path of the object to call method on
> + @type obj_path: str
> + @param iface: interface to use
> + @type iface: str
> + @param method: name of the method to call
> + @type method: str
> + @param args: arguments to pass to the method
> + @type args: GVariant
> + @param connection: connection to use (if None, a new connection is
> + established)
> + @type connection: Gio.DBusConnection
> + @return: unpacked value returned by the method
> + @rtype: tuple with elements that depend on the method
> + @raise DBusCallError: if some DBus related error appears
> +
> + """
Just curious - what's this new style of docstrings you guys seem to
like so much?
This is just a old format epydoc used. I'll change it to the new
format
Sphinx uses as it is a new code. Shall I change the format also in other
pieces of code like keyboard.py and localization.py modules?
--
Vratislav Podzimek
Anaconda Rider | Red Hat, Inc. | Brno - Czech Republic