X-Git-Url: https://git.0d.be/?p=empathy.git;a=blobdiff_plain;f=HACKING;h=28174704280beeed194a2ad15306ac19821d3229;hp=bae9b0b81a542de9998ea59aa14d9d36c8832432;hb=846cf36946ff8c36cf75678d9ed6552c33326228;hpb=29973effee9abb05f78b8da5e3258194abc2c461 diff --git a/HACKING b/HACKING index bae9b0b8..28174704 100644 --- a/HACKING +++ b/HACKING @@ -6,19 +6,30 @@ Empathy is split in different processes: - src/empathy-debugger: debug tool Each process can be run directly from source without having to be installed to -its prefix. You just have to define the environment variable EMPATHY_SRCDIR -to the path of your empathy source dir. For example: - export EMPATHY_SRCDIR=/home/cassidy/gnome/empathy +its prefix. You just have to define an appropriate environment using the +wrapper found in the tools/ directory.. For example: + ./tools/empathy-env ./src/empathy The chat and call UI are automatically started by telepathy-mission-control when receiving or requesting a chat/call. In order to use your custom version you have to kill any existing instance of empathy-{chat,call} and then start it with EMPATHY_PERSIST=1 to prevent it from auto exiting if there is no channel to handle. For example: - EMPATHY_PERSIST=1 ./src/empathy-chat + EMPATHY_PERSIST=1 ./tools/empathy-env ./src/empathy-chat Debugging can be turned on using EMPATHY_DEBUG=all and logged to a file with EMPATHY_LOGFILE=/tmp/empathy.log +Sometimes you may want to load the locally compiled version of some GStreamer +plugin (e.g. Farstream) instead of the system installed one. To do so, just +set the GST_PLUGIN_PATH environment variable to tell GStreamer where your +plugins are located and the GST_PLUGIN_LOADING_WHITELIST to avoid conflicts +with system installed plugins. It's also a good idea to use GST_REGISTRY to +avoid clobbering your default GStreamer registry. For example you can +export these before launching the empathy processes as shown above: + export GST_PLUGIN_LOADING_WHITELIST=gstreamer:gst-plugins-base:gst-plugins-good:libnice:farstream:gst-plugins-bad:gst-plugins-ugly:gst-ffmpeg + export GST_PLUGIN_PATH=/path/to/your/custom/lib/gstreamer-0.10 + export GST_REGISTRY=/tmp/gstreamer.registry + See http://live.gnome.org/Empathy/ about coding style conventions. See also http://live.gnome.org/Empathy/Git to read about our git workflow.