Run from the source directory without installing
[empathy.git] / HACKING
1 Empathy is split in different processes:
2 - src/empathy: contact list, considered as the main UI
3 - src/empathy-chat: chat UI
4 - src/empathy-call: call UI
5 - src/empathy-accounts: UI to configure IM accounts
6 - src/empathy-debugger: debug tool
7
8 Each process can be run directly from source without having to be installed to
9 its prefix. You just have to define an appropriate environment using the
10 wrapper found in the tools/ directory.. For example:
11   ./tools/empathy-env ./src/empathy
12
13 The chat and call UI are automatically started by telepathy-mission-control
14 when receiving or requesting a chat/call. In order to use your custom version
15 you have to kill any existing instance of empathy-{chat,call} and then start
16 it with EMPATHY_PERSIST=1 to prevent it from auto exiting if there is no
17 channel to handle. For example:
18   EMPATHY_PERSIST=1 ./tools/empathy-env ./src/empathy-chat
19
20 Debugging can be turned on using EMPATHY_DEBUG=all and logged to a file
21 with EMPATHY_LOGFILE=/tmp/empathy.log
22
23 See http://live.gnome.org/Empathy/ about coding style conventions.
24 See also http://live.gnome.org/Empathy/Git to read about our git workflow.