*****************************
+Build tools requirements
+========================
+
+When building and testing directly from the repository it is important to
+have at least automake version 1.10 or later installed. All modern
+distributions should default to the latest version, but it seems that
+Debian's default is still an earlier version:
+
+ Check version
+ # dpkg -l '*automake*'
+
+ Install new version
+ # apt-get install automake1.10
+ # update-alternatives --config automake
+
+
Working with the source code repository
=======================================
# sudo ./src/connmand -n -i wlan*
+Debugging the D-Bus interface during runtime
+============================================
+
+Running the daemon with debugging information in the foreground is quite
+verbose and sometimes not really helpful. The "monitor-connman" script
+allows to monitor "PropertyChanged" D-Bus signals from various interfaces.
+
+ During start of daemon
+ {Manager} [/] Devices = dbus.Array([dbus.ObjectPath('/dev_00_90_CC ...
+ {Device} [/dev_00_90_CC_xx_xx_xx] Powered = 1
+ {Device} [/dev_00_90_CC_xx_xx_xx] Networks = dbus.Array( ...
+
+ During shutdown of daemon
+ {Device} [/dev_00_90_CC_xx_xx_xx] Networks = dbus.Array( ...
+ {Device} [/dev_00_90_CC_xx_xx_xx] Powered = 0
+ {Manager} [/] Devices = dbus.Array([], ...
+
+Every "PropertyChanged" signal will generate a line of output. Some of them
+can get very complex. The first detail inside "{ ... }" is the interface
+name (without its service name prefix). The second detail inside "[ ... ]"
+is the object path. And after that it is followed by a key and value of
+the property that changed.
+
+
Generating source code documentation
====================================
Every distribution should provide a package for this, but the naming of the
package might be different:
- Ubuntu/Debian
+ Debian
+ # apt-get install gtk-doc-tools
+
+ Ubuntu
# apt-get install gtk-doc-utils
Fedora