tilix-debug.howto

goal:

      * build the latest tilix from git with debug info
      * to experiment with optimal value for https://github.com/gnunn1/tilix/issues/858


procedure for Ubuntu systems:

    :: get the needed dependencies to build tilix

            $ sudo add-apt-repository ppa:webupd8team/terminix

            $ sudo apt-get update && sudo apt-get upgrade

            $ sudo apt-get build-dep tilix

    :: prepare a workzone (keep this around as long as you're testing)

            $ mkdir -p ~/tilix-debug # or a name of your choosing

    :: clone the tilix git repo

            $ cd ~/tilix-debug

            $ git clone https://github.com/gnunn1/tilix.git

            $ cd tilix

    :: manually edit ~/tilix-debug/tilix/source/gx/tilix/appwindow.d line 1570 using your favo editor

    :: configure / build tilix debug version

            $ chmod u+x autogen.sh

            $ ./autogen.sh

            # this will install to /usr/local, so you can keep your current tilix
            $ ./configure

            $ make DC='ldmd2' DCFLAGS='-O -inline -release'

    :: install tilix debug version to /usr/local

            $ sudo make install

    :: test issue #858 (enabling `hide on focus lost` in tilix prefs)

            * temporarily edit your shortcut for quake mode toggling,
               and make sure it points to the correct tilix binary: /usr/local/bin/tilix -q

            $ /usr/local/bin/tilix -q

            * test away

    :: routine to re-edit ~/tilix-debug/tilix/source/gx/tilix/appwindow.d line 1570
        using a different timeout value in line 1570

            * Ctrl+C to stop tilix
            * re-edit the timeout value

            $ make clean

            $ make DC='ldmd2' DCFLAGS='-O -inline -release'

            $ sudo make install

    :: when done testing

            $ sudo make uninstall

            * re-edit your shortcut for quake mode toggling,
               and make sure it points to the correct tilix binary: tilix -q

            $ cd ~ && sudo rm -r ~/tilix-debug

            $ sudo apt-get purge ldc libgtkd-3-dev libphobos2-ldc-dev libvted-3-dev po4a

            $ sudo apt-get autoremove

            * if you want to remove the webupd8 tilix PPA:
            $ sudo add-apt-repository --remove ppa:webupd8team/terminix