Home Forums Wiki Doc Install Extras Screenshots Source Code Projects Blog Users Groups Register
Glx-Dock / Cairo-Dock Wiki ddd
The latest stable release is the *3.4.0* : How to install it here.
Note: We just switched from BZR to Git on Github! (only to host the code and your future pull requests)
Information : The version displayed on this page is not the latest available.
History View code

Glx-Dock / Cairo-Dock

Home

History

Language

fr Français

en English

Support Us

Flattr this

Cairo-Dockon

ddd

If you want to help the developer fixing bugs that crash the dock, the best is to compile the latest revision of the dock from the source in BZR and then produce a backtrace.
Installing debug symbols
  • For Ubuntu users, you need just to add our ppa Weekly, and install this packages : cairo-dock-core-dbg libgldi3-dbg cairo-dock-plug-ins-dbg cairo-dock-plug-ins-integration-dbg. You can use directly this command in a terminal :
    sudo apt-get install cairo-dock-core-dbg libgldi3-dbg cairo-dock-plug-ins-dbg cairo-dock-plug-ins-integration-dbg
  • For Debian users (and Ubuntu if you want compile the dock or if we ask you), the compilation is very easy thanks to a script.
  • For other distributions, that take a little more time, but all the commands and explanations are give on the same page => From BZR
Don't forget to add the debug symbols with this command CMake :
cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
* For ArchLinux users, edit the PKGBUILD (core and plug-ins) for the option to CMake is not enough. Momentarily, you need to remove the option "strip" in /etc/makepkg.conf (OPTIONS=(strip (...))

Backtrace
Graphic Method
_
Old Version
_

ddd is a debugging programming used to help troubleshooting program.

  • Compiling is very simple if you use Ubuntu/Debian thanks to a script. For the other distros it is a little bit longer but all commands ans explanations are available on this page => From BZR. Don't forget to add the debug symbols by using this cmake command:
    cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
  • Install a lightweight application called ddd (should be available on your repositories, overlays, etc.)
  • Note that if you are able to launch a few commands from a terminal, it's maybe better to send us a full backtrace. You can jump to the GDB section here above.
  • Now you need to launch Cairo-Dock with this command:
    ddd cairo-dock
    (from a terminal or the shorcut Alt+F2)
  • On DDD, click on the 'Run' button (or Program / Run or by using the shortcut 'F2')
  • Finally all that is left is to reproduce the crash. Then post on the forum a link to the screenshot from the "Status/Backtrace" window that ddd created for you. Increase its size if needed so that all printout are visible.
http://uppix.net/3/e/9/47e42c4a0400cd58edb366c974e22.png

  • To upload it there are services like uppix.net, imageshark.us, etc. or better use the applet DND2Share (Drop to share)
  • GDB: It can be interesting to have a full backtrace but you've to use a terminal and a few commands. If you're able to do that, don't hesitate to add these informations to the bug report! So... can you simply launch these commands and post the content of the gdb.txt file located in your home directory?
    cd
    gdb cairo-dock
    #> now you're in the gdb prompt
    run
    #> simply reproduce the crash
    set logging on
    l
    bt full
    #> then press Enter until the end of the backtrace
    info frame
    thread apply all bt full
    #> then press Enter until the end of the backtrace
    quit
    This file has been created in your home directory: gdb.txt
  • Once the bug is fixed, you can:
    • De-install the dock:
      • Using the script
        cd /opt/cairo-dock_bzr
        ./cairo-dock_bzr.sh
        (press "3" + "Enter" to desinstall it)
      • Or the following command in all the directories that were used during the compilation
        # make uninstall
        and reinstall the previous version of the dock (that you install from a repository or by other mean)
    • Or simply continue using this dock and just update it regularly (either from the script or manually)


Backtrace example:
http://uppix.net/8/9/0/81641f4d4072f2ac7681612af0820.png


Glx-Dock / Cairo-Dock Wiki ddd Top

Online users :

Powered by ElementSpeak © 2007 Adrien Pilleboue, 2009-2013 Matthieu Baerts.
Dock based on CSS Dock Menu (Ndesign) with jQuery. Icons by zgegball
Cairo-Dock is a free software under GNU-GPL3 licence. First stable version created by Fabounet.
Many thanks to TuxFamily for the web Hosting and Mav for the domain name.