emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Wrong type error in dbus method


From: Thien-Thi Nguyen
Subject: Re: Wrong type error in dbus method
Date: Mon, 05 Jul 2010 11:00:53 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux)

() Michael Albinus <address@hidden>
() 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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]