Building from source

From Knotter
Revision as of 09:01, 6 June 2013 by Mattia Basaglia (talk | contribs) (→‎Cloning from Git)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Build instructions

Dependencies

It's possible to compile Knotter for Qt 4.7 but the sources need to be ported with the script package/qt-4.7/port-back.sh

From a shell

    ./configure.sh && make

The configuration script will generate the makefile using qmake and set up the installation directories, for more information run

    ./configure.sh --help

If the configure script fails despite being in a proper build environment you can run directly qmake on knotter.pro. Be advised that this will make some make targets buggy or unavailable.

If you want to regenerate the files created by the Qt build tools, run

    make clean
    make

To install the binaries run

    make install

To install in a specific directory, you can set INSTALL_ROOT

    make install INSTALL_ROOT=/some/directory

The default install prefix is /usr/local (see ./configure.sh --help)

Misc make targets

dist
Generate source tarball
src_doc
Generate Doxygen documentation from the source files

From Qt Creator

Open knotter.pro and click Build (Ctrl+B) to compile and Run (Ctrl+R) to start Knotter.

Getting the latest sources


Cloning from Git

This source tree uses git submodules, this means that the submodules need to be initialized when the repo is cloned:

#Clone repo
git clone git://github.com/mbasaglia/Knotter.git

# Initialize submodules
git submodule init

# Clone submodules
git submodule update


And to update all the sources:

#Update repo
git pull origin master

# Initialize new submodules
git submodule update --init

# Pull submodules
git submodule foreach git pull origin master

For convenience, Knotter has the helper script pull.sh that does these three steps.