kbdd.1

.TH KBDD 1 "27 Aug 2011" "version 0.6" "XKB layout switching daemon"
.SH NAME
kbdd - simple per-window keyboard layout switching daemon
.SH SYNOPSIS
.B kbdd
.RB "[ " \-n " | " \-\-nodaemon " ]"
.br
.B kbdd
.RB "[ " \-h " | " \-\-help " ] [ " \-v " | " \-\-version " ]"
.SH DESCRIPTION
kbdd is a simple keyboard layout daemon that switches and restores
layouts on a per-window basis.
.TP
.BR \-n ", " \-\-nodaemon
run in nodaemon (foreground) mode
.TP
.BR \-h ", " \-\-help
print a short usage summary
.TP
.BR \-v ", " \-\-version
print the program version
.SH DBUS INTERFACE
Kbdd registers a dbus interface in order to notify a window manager
about layout change and listens on this interface for incoming requests.
This interface can be used in WM widgets to indicate the current layout.
.P
The dbus interface has the following methods:
.TP
.B getLayoutName( uint32 ) 
returns a string representing the layout group name
.TP
.B set_layout( uint32 )
sets current group
.TP
.B getCurrentLayout
returns current layout group id
.TP
.B next_layout
switches to the next keyboard layout
.TP
.B prev_layout             
switches to the previous keyboard layout
.P
The following events (signals) are available:
.TP
.B layoutChanged          
returns new group number
.TP
.B layoutNameChanged       
returns name for the new group 
.P
You can change the layout with the following dbus-send command:
.EX
.B dbus-send \-\-dest=ru.gentoo.KbddService /ru/gentoo/KbddService ru.gentoo.kbdd.set_layout uint32:1
.EE
.SH BUGS
Some users reported problems with sticking meta-keys
(Alt or Meta4), however, at the moment there is not
enough information collected to conclude
if this is caused by kbdd or not.
.P
Newly found bugs may be reported on
.UR http://github.com/qnikst/kbdd/issues
the project page at github
.UE .
.SH AUTORS
.MT alexander.vershilov@gmail.com
Alexander V. Vershilov
.ME
.P
This manual page was updated for the Debian project by
.MT stanislav.maslovski@gmail.com
Stanislav Maslovski
.ME
.SH SEE ALSO
.IR dbus-send (1),
.IR dbus-monitor (1)
.P
You can get more information about kbdd usage on
.UR https://github.com/qnikst/kbdd/wiki/Usecases
wiki pages of the kbdd project
.UE .