Skip to content

Latest commit

 

History

History
102 lines (71 loc) · 4.17 KB

HACKING.md

File metadata and controls

102 lines (71 loc) · 4.17 KB
Raw

Compiling and Installing

Dependencies

On Ubuntu based system install dependencies with:

sudo apt-get install git dh-autoreconf autotools-dev debhelper libconfuse-dev libgtk-3-dev libvte-2.91-dev pkg-config

You possibly need other packages such as gettext, automake, autoconf, autopoint, and X11 development libraries.

On Fedora:

# This may be outdated (see Ubuntu example above, for a more thorough list)
sudo yum install git automake libconfuse-devel vte3-devel gtk3-devel glib-devel gettext-devel

The dependencies section above is complete but the sample command may not be complete, depending on your system you may need to install additional packages. Please carefully read the output of the autogen.sh (see below) for more information of what you need to install.

Compiling

Generally if you have installed the development packages (e.g. *-dev or *-devel) of the dependencies above and the autotools suite then it should be possible to compile with:

mkdir build
cd build
../autogen.sh --prefix=/usr
make --silent

Changing to build/ and calling autogen.sh relative from there makes sure that we perform an out-of-tree build and all generated files are stored inside build/. This way build artifacts will not clutter the source directory.

If you get the following error message, then you are missing the autopoint binary which is part of the autotools suite. On Ubuntu the dh-autoreconf package installs it along with automake, autoconf and autoreconf.

Can't exec "autopoint": No such file or directory at /usr/share/autoconf/Autom4te/FileUtils.pm line 345.

You do not need the --silent option, but I prefer to use it to reduce the output a bit. If you experience any problem during build, then drop the --silent option.

Installing

After you have compiled the package run the following command to install tilda to the prefix that you have chosen before:

sudo make install

If you don't want to install to the /usr prefix, choose some other prefix when you run the autogen.sh script, such as /opt/tilda and add it to your path.

Packaging for Debian

This section explains how to package Tilda for Debian and Debian derived distributions.

Preparation before building the package

In order to build a package which can be uploaded to some Debian based distribution the following steps are necessary. Replace '#' with the number of the current minor release.

  1. Check out the latest stable branch (e.g. tilda-1-2) and commit any changes or patches which you want to include, then commit these changes.

  2. Update the changelog with a message such as: "Update the change log for 1.2.#"

  3. Update the version number in configure.ac and make a commit with the version number: "1.2.#"

  4. Create a tarball using git-archive:

    git archive --prefix=tilda-1.2.#/ -o ../tilda_1.2.#.orig.tar.gz HEAD

Building a package

You now have a tarball which can be build into a package. The following steps are just to document the basic commands that are required to build the package, then verify its correct and upload the package to mentors. However the steps which are required to setup such a development environment are not explained here:

  1. cd ..; tar -xf tilda_1.2.#.orig.tar.gz

  2. cd tilda-1.2.#

  3. Checkout the tilda-debian repository from Github and copy the debian/ folder to tilda-1.2.#/.

  4. Update the Debian specific change log at debian/changelog, such that it contains the latest version that you are building.

  5. Run debuild

  6. If debuild finishes without a problem next run pbuilder, this will verify that the packge is buildable (without warnings or errors) in a clean environment:

    sudo pbuilder --build --basetgz ~/pbuilder/unstable-base.tgz tilda_1.2.#-1.dsc

  7. If pbuilder does not complain and you don not see any warnings in lintian, then upload the package to mentors:

    dput mentors tilda_1.2.#-1_amd64.changes