procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

* dbus.texi (Type Conversion): Correct input parameters mapping.

Browse source
This commit is contained in:
Michael Albinus 2007-12-22 14:59:24 +00:00
parent b17f4b438f
commit d4e67bc5cb
2 changed files with 23 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
doc/misc/ChangeLog
View file

@ -1,3 +1,7 @@
2007-12-22 Michael Albinus <michael.albinus@gmx.de>
* dbus.texi (Type Conversion): Correct input parameters mapping.
2007-12-21 Michael Albinus <michael.albinus@gmx.de>
* dbus.texi (Type Conversion): Extend for D-Bus compound types.

32
doc/misc/dbus.texi
View file

@ -268,9 +268,10 @@ input parameter.
If it is necessary to use another D-Bus type, a corresponding type
symbol can be preceeded to the corresponding Lisp object. Basic D-Bus
types are represented by the type symbols `:byte', `:boolean',
`:int16', `:uint16', `:int32', `:uint32', `:int64', `:uint64',
`:double', `:string', `:object-path' and `:signature'.
types are represented by the type symbols @code{:byte},
@code{:boolean}, @code{:int16}, @code{:uint16}, @code{:int32},
@code{:uint32}, @code{:int64}, @code{:uint64}, @code{:double},
@code{:string}, @code{:object-path} and @code{:signature}.
@noindent
Example:
@ -292,10 +293,10 @@ but different to
@end lisp
A D-Bus compound type is always represented as list. The car of this
list can be the type symbol `:array', `:variant', `:struct' or
`:dict-entry', which would result in a corresponding D-Bus container.
`:array' is optional, because this is the default compoud type for a
list.
list can be the type symbol @code{:array}, @code{:variant},
@code{:struct} or @code{:dict-entry}, which would result in a
corresponding D-Bus container. @code{:array} is optional, because
this is the default compoud type for a list.
The objects being elements of the list are checked according to the
D-Bus compound type rules.
@ -332,13 +333,13 @@ objects.
@item D-Bus type @tab @tab Lisp type
@item
@item DBUS_TYPE_BOOLEAN @tab @expansion{} @tab @code{t} or @code{nil}
@item DBUS_TYPE_BYTE @tab @expansion{} @tab
@item DBUS_TYPE_BYTE @tab @expansion{} @tab number
@item DBUS_TYPE_UINT16 @tab @expansion{} @tab number
@item DBUS_TYPE_INT32 @tab @expansion{} @tab number
@item DBUS_TYPE_UINT32 @tab @expansion{} @tab number
@item DBUS_TYPE_INT32 @tab @expansion{} @tab number
@item DBUS_TYPE_UINT64 @tab @expansion{} @tab number
@item DBUS_TYPE_INT64 @tab @expansion{} @tab number
@item DBUS_TYPE_INT16 @tab @expansion{} @tab number
@item DBUS_TYPE_UINT32 @tab @expansion{} @tab number or float
@item DBUS_TYPE_INT32 @tab @expansion{} @tab number or float
@item DBUS_TYPE_UINT64 @tab @expansion{} @tab number or float
@item DBUS_TYPE_INT64 @tab @expansion{} @tab number or float
@item DBUS_TYPE_DOUBLE @tab @expansion{} @tab float
@item DBUS_TYPE_STRING @tab @expansion{} @tab string
@item DBUS_TYPE_OBJECT_PATH @tab @expansion{} @tab string
@ -350,6 +351,11 @@ objects.
@end multitable
@end example
A float object in case of @code{DBUS_TYPE_UINT32},
@code{DBUS_TYPE_INT32}, @code{DBUS_TYPE_UINT64} and
@code{DBUS_TYPE_INT6432} is returned, when the C value exceeds the
Emacs number size range.
The resulting list of the last 4 D-Bus compound types contains as
elements the elements of the D-Bus container, mapped according to the
same rules.