Re: Wrong type error in dbus method

[Thien-Thi Nguyen <ttn@gnuvola.org>]

() Michael Albinus <michael.albinus@gmx.de>
() Sat, 03 Jul 2010 10:59:06 +0200

   Which information do you miss in the dbus info manual?

I typed ‘i’ and Emacs beeped: "No index".  That's a big hole.
[If i were maintaining Emacs, i would add "all manuals have an
index" as a strong requirement in admin/FOR-RELEASE (Manuals).]

Re this particular problem (incorrect list construction), perhaps
where it reads:

     All other arguments args are passed to METHOD as arguments.  They
     are converted into D-Bus types as described in *note Type
     Conversion::.

you could link to the Emacs Lisp manual, node "(elisp) Building Lists".
I see this blurb is repeated in both Synchronous Methods and Asynchronous
Methods, so another idea is to add to Overview a small section "Audience",
with appropriate hints/links on Emacs Lisp programming, message bus fu,
network etiquette, etc.  The primary message there would be "to get the
best out of this manual (& the API it describes & the peers with whom you
will likely be communicating), move your mind here, first".  Of course,
if you are a mechanism/policy separation purist, this might chafe a bit.

thi