1,417
edits
Changes
From Studiosg
Jump to navigationJump to searchAdded page about the build procedure of the Prerequisites packages for TDE 14.0.0
Welcome to Simone Giustetti's wiki pages.
Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title=TDE_14.0.0_prerequisiti Italiano]
----
== '''Prerequisites''' ==
[[En/trinity_desktop_environment_14.0.0]]
Packages grouped with the generic name '''Prerequisites''' include all of the desktop environment base libraries and some optional components needed for advanced features. The base libraries obviously include '''TQt3''', the Qt fork developed and maintained by the Trinity project members, '''tqtinterface''', a library providing an abstraction layer between TQt and TDE, '''arts''', the TDE sound server and sound stream mixer, '''dbus-tqt''' and '''dbus-1-tqt''', which tie the desktop environment with the hardware subsystem. The remaining libraries: '''avahi-tqt''', '''libart-lgpl''', '''libcaldav''', '''libcarddav''', '''python-tqt''', '''sip4-tqt''', '''tqca''', '''tqca-tls''' and '''tqscintilla''' are optional ones. The desktop environment could be built without them, but will miss some useful functionality.
=== Build System ===
One among the Trinity project main goals consists of porting the package build system from '''autotools''' to '''[http://www.cmake.org/ cmake]'''. The migration is still a work in progress partially concluded only for a bunch of the previously listed packages. A package list matched with the used build system follows:
{| style="width: 80%;"
|+ '''BUILD SYSTEM'''
! Package !! Package Type !! Build System
|- style="text-align: center;"
| arts || Base || Cmake
|- style="text-align: center;"
| avahi-tqt || Add-on || Autotools
|- style="text-align: center;"
| dbus-1-tqt || Base || Cmake
|- style="text-align: center;"
| dbus-tqt || Base || Cmake
|- style="text-align: center;"
| libart-lgpl || Add-on || Autotools
|- style="text-align: center;"
| libcaldav || Add-on || Autotools
|- style="text-align: center;"
| libcarddav || Add-on || Autotools
|- style="text-align: center;"
| python-tqt || Add-on || configure.py script <br> Python interpreter required
|- style="text-align: center;"
| sip4-tqt || Add-on || configure.py script <br> Python interpreter required
|- style="text-align: center;"
| tqca || Add-on || Autotools
|- style="text-align: center;"
| tqca-tls || Add-on || Autotools
|- style="text-align: center;"
| tqscintilla || Add-on || Uses script qscintilla.pro for qmake <br> TQt3 library required
|- style="text-align: center;"
| tqt3 || Base || Autotools
|- style="text-align: center;"
| tqtinterface || Base || Cmake
|}
The need for four different build script templates is evident. Templates should share as much code as possible, but differences will surely arise while invoking the build process because of both the different employed build systems and the need for package specific options. The common SlackBuild script structure, global options and finally package specific options all will be discussed and detailed below.
=== Common Build Script Structure ===
Scripts for version 3.5.13.2 of TDE ([[En/trinity_desktop_environment#Prerequisites]]) were updated and adapted to the last available release. The script skeleton is nearly untouched:
* Introduction where a brief description and license information are provided for the script.
* External files containing global and local build options are loaded:
if [ -r ../../TDE.options ]; then
. ../../TDE.options
fi
PREFIX_TDE=${PREFIX}
if [ -r ./local.options ]; then
. ./local.options
fi
* Declare some global variables for the script:
ARCHIVE_FORMAT=${ARCHIVE_FORMAT:-"tar.bz2"}
BUILD=${BUILD:-"1"}
LD_LIBRARY_PATH="" # Will be defined later on
PRGNAM="tqtinterface"
PREFIX=${PREFIX:-"/usr"}
MANDIR=${MANDIR:-"${PREFIX}/man"}
SOURCE_SUBDIR=${SOURCE_SUBDIR:-"dependencies"}
SRCVER=${SRCVER:-"R14.0.0"}
TAG=${TAG:-"sg"}
TAR_OPTION=${TAR_OPTION:-"-xjvf"}
VERSION=$(echo ${SRCVER} | tr '-' '.')
DOCS="AUTHORS COPYING HOW.TO.BUILD NAMING README TODO TRINITY.RELEASE tqtinterface.lsm"
: Some variables were added since release 3.5.13.2, among them: the archive format and options for the '''tar''' program. All of the additions are meant to ease the build procedure once the project will settle on a compression format for source code archives.
* Determine the target architecture for the package and set proper parameters for the compiler, linker, included libraries, etc.:
if [ -z "${MARCH}" ]; then
MARCH=`uname -m`
fi
if [ -z "${ARCH}" ]; then
case "${MARCH}" in
i?86)
export ARCH=i486
;;
arm*)
export ARCH=arm
;;
*)
export ARCH=${MARCH}
;;
esac
fi
: Code was updated in order to read the target architecture from global parameters thus providing a suitable script for '''chroot''' environments.
* Create a directory build tree:
mkdir -p ${TMP}/tmp-${PRGNAM} # Location to build the source
rm -rf ${TMP}/tmp-${PRGNAM}/* # Remove the remnants of previous build and continue
mkdir -p ${PKG} # Place for the package to be built
rm -rf ${PKG}/* # We always erase old package's contents
mkdir -p ${OUTPUT} # Place for the package to be saved
* Assign sane permissions to files:
chown -R root:root .
find . \
\( -perm 777 -o -perm 775 -o -perm 711 -o -perm 555 -o -perm 511 \) \
-exec chmod 755 {} \; -o \
\( -perm 666 -o -perm 664 -o -perm 600 -o -perm 444 -o -perm 440 -o -perm 400 \) \
-exec chmod 644 {} \;
* Configure, build and install the package.
* Add some documentation, links, examples and whatever is needed to obtain a fully functional package:
mkdir -p ${PKG}/usr/doc/${PRGNAM}"-"$VERSION
cp -a ${DOCS} ${PKG}/usr/doc/${PRGNAM}"-"${VERSION}
chown -R root:root ${PKG}/usr/doc/${PRGNAM}"-"${VERSION}
find ${PKG}/usr/doc -type f -exec chmod 644 {} \;
# Add a package description.
mkdir -p ${PKG}/install
cat ${SRCDIR}/slack-desc > ${PKG}/install/slack-desc
# Set sane permissions for the include files.
if [ -d ${PKG}/${PREFIX}/include ]; then
find ${PKG}/${PREFIX}/include -type f -exec chmod 0644 {} \;
fi
* Crete the package.
=== Generic Options ===
Generic build options will vary depending on the adopted build system only. '''Autotools''' related packages require the following:
* Rebuild the '''Autoconf / Automake''' used files:
'''cp''' ''-Rp'' /usr/share/aclocal/libtool.m4 <pkg_path_build>/admin/libtool.m4.in
'''cp''' ''-Rp'' <path to your system's ltmain.sh file> admin/ltmain.sh
'''make''' ''-f'' admin/Makefile.common
* Set options for the compiler and linker, set paths for include files, libraries and man pages:
'''export''' LD_LIBRARY_PATH=${PREFIX}/lib${LIBDIRSUFFIX}:${PREFIX}/lib${LIBDIRSUFFIX}/trinity:${LD_LIBRARY_PATH}
'''export''' LIBDIR=${PREFIX}/lib${LIBDIRSUFFIX}
'''export''' MANDIR
'''export''' PATH=${PREFIX}/bin:${PATH}
'''export''' PKG_CONFIG_PATH=:${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig:${PKG_CONFIG_PATH}
'''export''' PREFIX
'''export''' QTDIR=${PREFIX}
'''export''' SYSCONFDIR=/etc/trinity
# Enable only one of the following:
# export DEBUG_AUTOTOOL_OPT="--enable-debug=full"
'''export''' DEBUG_AUTOTOOL_OPT="''--disable-debug''"
* Configure source code:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--mandir=''${MANDIR} \
''--build=''$ARCH-slackware-linux \
2>&1 | '''tee''' -a ${OUTPUT}/${PRGNAM}_configure.log
* Build and install:
'''make''' VERBOSE=1 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_make.log
'''make''' install DESTDIR=${PKG} 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_install.log
Steps for '''[http://www.cmake.org/ Cmake]''' consist of:
* Clean the cmake cache:
'''find''' . ''-name'' CMakeCache.txt ''-exec'' '''rm''' {} \;
* Set options for the compiler and linker, set paths for include files, libraries and man pages:
'''export''' LD_LIBRARY_PATH=${PREFIX}/lib${LIBDIRSUFFIX}:${PREFIX}/lib${LIBDIRSUFFIX}/trinity:${LD_LIBRARY_PATH}
'''export''' LIBDIR=${PREFIX}/lib${LIBDIRSUFFIX}
'''export''' MANDIR
'''export''' PATH=${PREFIX}/bin:${PATH}
'''export''' PKG_CONFIG_PATH=${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig:${PKG_CONFIG_PATH}
'''export''' PREFIX
'''export''' QTDIR=${PREFIX}
'''export''' SYSCONFDIR=/etc/trinity
# Enable only one of the following:
# export DEBUG_AUTOTOOL_OPT="--disable-debug"
'''export''' DEBUG_CMAKE_OPT=""
* Configure source code:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX=''${PREFIX} \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON'' \
2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_configure.log
* Build and install:
'''make''' VERBOSE=1 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_make.log
'''make''' install DESTDIR=${PKG} 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_install.log
Packages '''python-tqt''' and '''sip4-tqt''' use a script written in Python language to configure source code. Both scripts only accept options for the compiler and linker.
* Configure source code:
'''python''' configure.py \
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_configure.log
* Build and install:
'''make''' VERBOSE=1 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_make.log
'''make''' install DESTDIR=${PKG} 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_install.log
Last is '''tqscintilla''', the only package to use '''tqmake''', which requires options for the compiler and linker.
* Configure source code:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS} ''-fno-exceptions''" \
'''tqmake''' qscintilla.pro \
2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_configure.log
* Build and install:
'''make''' VERBOSE=1 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_make.log
'''make''' install INSTALL_ROOT=${PKG} 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_install.log
=== Custom Options ===
The generic options used to configure and build each package in the prerequisites group were discussed above. Package specific options instead are detailed below together with some tips to attain a successful build. Moreover a download link for each SlackBuild is provided in order to help whoever wishes to test a full build.
==== ARTS ====
The '''A'''nalog '''R'''eal '''T'''ime '''S'''ynthesizer is a sound library providing '''an integrated sound server''', a sound streams mixer and some configuration tools. Used since KDE 2, Arts was replaced by '''Phonon''' in KDE 4 and later adopted by TDE. To build Arts You need to set the '''-DCMAKE_SKIP_RPATH="OFF"''' option while running the configuration script. The '''[http://www.cmake.org/ cmake]''' invocation command is:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX''=${PREFIX} \
''-DCMAKE_SKIP_RPATH="OFF"'' \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON''
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/arts.tar.gz link].
==== AVAHI-TQT ====
A library providing DNS resolution capabilities to the base TDE packages tdebase and tdelibs. Avahi-tqt requires the '''avahi''' library as a dependency, but the latter is not part of a standard Slackware release. A build script for avahi can be downloaded from the [http://slackbuilds.org slackbuilds.org] web page. Once installed the dependency, '''avahi-tqt''' can be built setting some environment variables:
PREFIX="/usr/local"
MANDIR="/usr/man"
Exporting the '''tqt3''' path:
'''export''' QTDIR=${PREFIX_TDE}
Running the autogen.sh script to create all of the build scripts and configuration files:
'''sh''' ./autogen.sh
Then configuring the source code passing some parameters to the script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--mandir=''${MANDIR} \
''--build=''$ARCH-slackware-linux
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/avahi-tqt.tar.gz link]. Please note: The script is provided for reference only. I don't usually build optional packages nor set on add-on functionality if I can do without. Having no avahi package installed, I could not test the SlackBuild script behavior, just its syntax.
==== DBUS-TQT ====
A library interfacing to the '''dbus''' daemon included in most modern '''Linux''' distributions to manage hardware and provide a common messaging infrastructure for applications. Dbus is a replacement for '''HAL'''. To configure and build the package using '''[http://www.cmake.org/ cmake]''' you should:
Clean the cmake cache:
'''find''' . ''-name'' CMakeCache.txt ''-exec'' '''rm''' {} \;
Pass the '''-DCMAKE_SKIP_RPATH="OFF"''' option to cmake. The cmake command line should be something like:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX=''${PREFIX} \
''-DCMAKE_SKIP_RPATH="OFF"'' \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON''
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/dbus-tqt.tar.gz link].
==== DBUS-1-TQT ====
A '''dbus-tqt''' related library adding an abstraction layer between the dbus daemon and the TQt3 library. The package can be configured recurring to '''[http://www.cmake.org/ cmake]'''. Follow some easy steps:
Clean the cmake cache:
'''find''' . ''-name'' CMakeCache.txt ''-exec'' '''rm''' {} \;
Pass the '''-DCMAKE_SKIP_RPATH="OFF"''' option to cmake. The cmake command line should be something like:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX=''${PREFIX} \
''-DCMAKE_SKIP_RPATH=''"OFF" \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON''
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/dbus-1-tqt.tar.gz link].
==== LIBART-LGPL ====
'''Libart''' is a library for high-performance 2D graphics used by '''Gnome''', '''KDE''' and '''TDE'''. The library release distributed with TDE is different from the standard one included in many Linux distributions. You are recommended to replace the installed version if any with the TDE provided one. To build a libart package please define some environment variables:
PREFIX="/usr"
MANDIR="/usr/man"
Then configure the source code:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--build=''$ARCH-slackware-linux
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/libart-lgpl.tar.gz link].
==== LIBCALDAV ====
The '''Libcaldav''' library implements the client side '''CALDAV''' protocol defined in the '''rfc4791''' paper. The library is used by the shared calendar included in the '''tdepim''' package. It is an add-on package. Some environment variables are needed to build '''libcaldav''':
PREFIX="/usr/local"
MANDIR="/usr/man"
Define the TQt3 library path:
'''export''' QTDIR=${PREFIX_TDE}
Run the autogen.sh script to create all of the build scripts and configuration files:
'''sh''' ./autogen.sh
Then configure the source code passing some parameters to the script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--mandir=''${MANDIR} \
''--build=''$ARCH-slackware-linux
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/libcaldav.tar.gz link].
==== LIBCARDDAV ====
The '''Libcarddav''' library implements the '''CARDDAV''' protocol used by the '''tdepim''' package. '''Libcarddav''' is an add-on package providing some optional functionality. To build the package set some environment variables:
PREFIX="/usr/local"
MANDIR="/usr/man"
Define the TQt3 library path:
'''export''' QTDIR=${PREFIX_TDE}
Run the autogen.sh script to create all of the build scripts and configuration files:
'''sh''' ./autogen.sh
And configure the source code passing some parameters to the script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--mandir=''${MANDIR} \
''--build=''$ARCH-slackware-linux
Some lines of code in the script '''install the man pages'''. Those ''' should be commented out''' to avoid an error that aborts the whole build procedure.
# Add man pages (No man page => Comment the following lines to avoid errors)
# if [ -d ${PKG}/${MANDIR} ]; then
# gzip -9 $PKG/${MANDIR}/man?/*
# fi
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/libcarddav.tar.gz link].
==== SIP4-TQT ====
'''Sip''' is a tool that eases the creation of '''Python''' bindings for '''C''' or '''C++''' libraries. It was originally developed to bind Python to Qt, but can be used for any C or C++ library. As many other previously discussed packages, sip can be built setting some environment variables:
PREFIX="/usr/local"
MANDIR="/usr/man"
Setting a target path for man pages:
'''export''' MANDIR
Adding to the standard compiler options some paths where to search for include files:
SLKCFLAGS="${SLKCFLAGS} ''-I''/usr/include/tqt ''-I''/opt/trinity/include"
and finally running a configuration script written in Python:
'''python''' configure.py \
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}"
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/sip4-tqt.tar.gz link].
==== TQCA ====
Another optional library, '''Tqca''' (TQt Cryptographic Architecture), provides an API to add cryptographic features to the Trinity Desktop Environment. Tqca has a small fingerprint and can be built recurring to some package specific steps:
Set some environment variables:
PREFIX="/usr/local"
MANDIR="/usr/man"
Set the installation path for the TQt library:
'''export''' QTDIR=${PREFIX_TDE}
Pass the aforementioned variables as parameters to the configuration script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--qtdir=''${QTDIR} \
Another peculiarity consists of the variable used to set the produced binary packages destination: '''INSTALL_ROOT''' in place of '''DESTDIR''', used by almost all of the packages.
'''make''' install INSTALL_ROOT=${PKG}
When all variables are set the build process can be started running the '''make''' command.
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/tqca.tar.gz link].
==== TQCA-TLS ====
'''Tqca-tls''' is a plug-in providing support for cryptography through a SSL/TLS channel for programs using the '''TQt Cryptographic Architecture'''. Perhaps the easiest package to build as the configure script sets sane values for all of its options. To build a working package you need to set the TQt library installation path:
'''export''' QTDIR=${PREFIX}
Then execute the build script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--qtdir=''${QTDIR}
As for '''tqca''', the only package peculiarity consists of the variable used to set a target directory for produced binary files: '''INSTALL_ROOT'''
'''make''' install INSTALL_ROOT=${PKG}
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/tqca-tls.tar.gz link].
==== TQT3 ====
'''TQt''' is a library providing all of the base widgets used by the desktop environment and as such has a fundamental importance. Building the package requires a great deal of time, but it relatively straightforward. First of all some environment variables are required:
'''export''' LD_LIBRARY_PATH=/usr/lib${LIBDIRSUFFIX}:${TMP}/tmp-${PRGNAM}/${DIR_SRC}/lib:${TMP}/tmp-${PRGNAM}/build/lib
'''export''' QTDIR=${PREFIX}
The '''LD_LIBRARY_PATH''' variable requires special care as it should point to the directory where intermediate binary files are stored. Files which are needed in later steps of the procedure. Set the wrong value and the build procedure will fail returning an error. Given the library complexity, the '''configure''' script is invoked with an option dense command line:
LDFLAGS="${SLKLDFLAGS}" \
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
../${DIR_SRC}/'''configure''' \
''-cups'' \
''-dlopen-opengl'' \
''-enable-opengl'' \
''-I/usr/include/freetype2/freetype'' \
''-I/usr/include/mysql'' \
''-inputmethod'' \
''-ipv6'' \
''-L/usr/lib${LIBDIRSUFFIX}'' \
''-lfontconfig'' \
''-libdir ${PREFIX}/lib${LIBDIRSUFFIX}'' \
''-nis'' \
''-no-g++-exceptions'' \
''-no-pch'' \
''-platform linux-g++'' \
''-plugin-imgfmt-mng'' \
''-plugin-sql-mysql'' \
''-plugin-sql-sqlite'' \
''-plugin-style-cde'' \
''-plugin-style-compact'' \
''-plugin-style-motifplus'' \
''-plugin-style-platinum'' \
''-plugin-style-sgi'' \
''-plugin-style-windows'' \
''-prefix ${PREFIX}'' \
''-qt-gif'' \
''-qt-imgfmt-jpeg'' \
''-qt-imgfmt-mng'' \
''-qt-imgfmt-png'' \
''-qt-style-motif'' \
''-release'' \
''-R${TMP}/tmp-${PRGNAM}/lib'' \
''-shared'' \
''-sm'' \
''-stl'' \
''-system-libjpeg'' \
''-system-libmng'' \
''-system-libpng'' \
''-system-zlib'' \
''-thread'' \
''-tablet'' \
''-v'' \
''-xcursor'' \
''-xft'' \
''-xinerama'' \
''-xkb'' \
''-xrandr'' \
''-xrender'' \
''-xshape''
The '''make''' command requires running twice. The second time around to create symbolic links and some other stuff:
'''make''' VERBOSE=1
'''make''' install INSTALL_ROOT=${PKG}
'''make''' -i symlinks sub-src sub-tool
'''make''' install INSTALL_ROOT=${PKG}
Some other post build actions should be taken to add other symbolic links, configuration scripts, and some files needed to ensure everything will run smoothly once installed:
# Some configure scripts seem unable to find lib64 => Create a symlink to lib
if [[ "x86_64" = "${ARCH}" ]]; then
ln -sf ${PREFIX}/lib${LIBDIRSUFFIX} ${PKG}/${PREFIX}/lib
fi
# Adding a link to the include folder
mkdir -p ${PKG}/usr/include
ln -sf ${PREFIX}/include ${PKG}/usr/include/${PRGNAM}
# Move the qt-mt.pc in the pkgconfig directory
if [[ ! -f ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig/tqt-mt.pc ]]; then
mkdir -p ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig
mv ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/tqt-mt.pc ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig/tqt-mt.pc
fi
# Link for qt-mt.pc to the /usr/lib[64] directory
mkdir -p ${PKG}/usr/lib${LIBDIRSUFFIX}/pkgconfig
ln -sf ${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig/tqt-mt.pc ${PKG}/usr/lib${LIBDIRSUFFIX}/pkgconfig/tqt-mt.pc
# Fix some bad links
if [[ -d ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++ ]]; then
if [[ -L ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++/linux-g++ ]]; then
unlink ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++/linux-g++
fi
ln -sf ${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++ ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++/linux-g++
if [[ -L ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/default ]]; then
unlink ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/default
fi
ln -sf ${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++ ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/default
elif [[ -d ${PKG}/${PREFIX}/mkspecs/linux-g++ ]]; then
if [[ -L ${PKG}/${PREFIX}/mkspecs/linux-g++/linux-g++ ]]; then
unlink ${PKG}/${PREFIX}/mkspecs/linux-g++/linux-g++
fi
ln -sf ${PREFIX}/mkspecs/linux-g++ ${PKG}${PREFIX}/mkspecs/linux-g++/linux-g++
if [[ -L ${PKG}/${PREFIX}/mkspecs/default ]]; then
unlink ${PKG}/${PREFIX}/mkspecs/default
fi
ln -sf ${PREFIX}/mkspecs/linux-g++ ${PKG}/${PREFIX}/mkspecs/default
fi
# Create and populate the profile.d directory
mkdir -p ${PKG}/etc/profile.d
# Put profile.d scripts in package TQT installation path.
cat ${SRCDIR}/profile.d/tqt3.sh | sed -e "s:TDE_PREFIX:${PREFIX}:" > ${PKG}/etc/profile.d/tqt3.sh
cat ${SRCDIR}/profile.d/tqt3.csh | sed -e "s:TDE_PREFIX:${PREFIX}:" > ${PKG}/etc/profile.d/tqt3.csh
chmod 755 ${PKG}/etc/profile.d/*
As usual a compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/tqt3.tar.gz link].
==== TQTINTERFACE ====
The '''Trinity Qt Interface''' is a library that abstracts Qt from Trinity. The abstraction layer allows to use both applications linked to TQt and Qt4 in a transparent way permitting both environments to coexist. To work correctly '''TQtinterface''' should be installed in directory '''/usr'''. To build the package set some environment variables:
PREFIX="/usr"
MANDIR="/usr/man"
Then run '''[http://www.cmake.org/ cmake]''' passing it some configuration options of which '''-DQT_VERSION=3''' is worth mentioning:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX=''${PREFIX} \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DQT_VERSION=3'' \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON''
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/tqtinterface.tar.gz link].
=== Conclusions ===
The present paper presented and discussed the procedure to build '''Prerequisites''' packages for the '''Trinity Desktop Environment'''. Some general rules common to the whole project were described along with options specific to packages. Finally links for all of the used '''SlackBuild''' scripts were provided in the hope for them to be useful to '''Slackware Linux''' users wishing to give a try at building the desktop environment from scratch.
For any feedback, questions, errors and such, please e-mail me at ''studiosg [at] giustetti [dot] net''
External links
----
* [http://www.trinitydesktop.org/ TDE home page]
* [http://www.slackware.com Slackware home page]
* [http://slackbuilds.org SlackBuilds.org home page]
----
Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title=TDE_14.0.0_prerequisiti Italiano]
Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title=TDE_14.0.0_prerequisiti Italiano]
----
== '''Prerequisites''' ==
[[En/trinity_desktop_environment_14.0.0]]
Packages grouped with the generic name '''Prerequisites''' include all of the desktop environment base libraries and some optional components needed for advanced features. The base libraries obviously include '''TQt3''', the Qt fork developed and maintained by the Trinity project members, '''tqtinterface''', a library providing an abstraction layer between TQt and TDE, '''arts''', the TDE sound server and sound stream mixer, '''dbus-tqt''' and '''dbus-1-tqt''', which tie the desktop environment with the hardware subsystem. The remaining libraries: '''avahi-tqt''', '''libart-lgpl''', '''libcaldav''', '''libcarddav''', '''python-tqt''', '''sip4-tqt''', '''tqca''', '''tqca-tls''' and '''tqscintilla''' are optional ones. The desktop environment could be built without them, but will miss some useful functionality.
=== Build System ===
One among the Trinity project main goals consists of porting the package build system from '''autotools''' to '''[http://www.cmake.org/ cmake]'''. The migration is still a work in progress partially concluded only for a bunch of the previously listed packages. A package list matched with the used build system follows:
{| style="width: 80%;"
|+ '''BUILD SYSTEM'''
! Package !! Package Type !! Build System
|- style="text-align: center;"
| arts || Base || Cmake
|- style="text-align: center;"
| avahi-tqt || Add-on || Autotools
|- style="text-align: center;"
| dbus-1-tqt || Base || Cmake
|- style="text-align: center;"
| dbus-tqt || Base || Cmake
|- style="text-align: center;"
| libart-lgpl || Add-on || Autotools
|- style="text-align: center;"
| libcaldav || Add-on || Autotools
|- style="text-align: center;"
| libcarddav || Add-on || Autotools
|- style="text-align: center;"
| python-tqt || Add-on || configure.py script <br> Python interpreter required
|- style="text-align: center;"
| sip4-tqt || Add-on || configure.py script <br> Python interpreter required
|- style="text-align: center;"
| tqca || Add-on || Autotools
|- style="text-align: center;"
| tqca-tls || Add-on || Autotools
|- style="text-align: center;"
| tqscintilla || Add-on || Uses script qscintilla.pro for qmake <br> TQt3 library required
|- style="text-align: center;"
| tqt3 || Base || Autotools
|- style="text-align: center;"
| tqtinterface || Base || Cmake
|}
The need for four different build script templates is evident. Templates should share as much code as possible, but differences will surely arise while invoking the build process because of both the different employed build systems and the need for package specific options. The common SlackBuild script structure, global options and finally package specific options all will be discussed and detailed below.
=== Common Build Script Structure ===
Scripts for version 3.5.13.2 of TDE ([[En/trinity_desktop_environment#Prerequisites]]) were updated and adapted to the last available release. The script skeleton is nearly untouched:
* Introduction where a brief description and license information are provided for the script.
* External files containing global and local build options are loaded:
if [ -r ../../TDE.options ]; then
. ../../TDE.options
fi
PREFIX_TDE=${PREFIX}
if [ -r ./local.options ]; then
. ./local.options
fi
* Declare some global variables for the script:
ARCHIVE_FORMAT=${ARCHIVE_FORMAT:-"tar.bz2"}
BUILD=${BUILD:-"1"}
LD_LIBRARY_PATH="" # Will be defined later on
PRGNAM="tqtinterface"
PREFIX=${PREFIX:-"/usr"}
MANDIR=${MANDIR:-"${PREFIX}/man"}
SOURCE_SUBDIR=${SOURCE_SUBDIR:-"dependencies"}
SRCVER=${SRCVER:-"R14.0.0"}
TAG=${TAG:-"sg"}
TAR_OPTION=${TAR_OPTION:-"-xjvf"}
VERSION=$(echo ${SRCVER} | tr '-' '.')
DOCS="AUTHORS COPYING HOW.TO.BUILD NAMING README TODO TRINITY.RELEASE tqtinterface.lsm"
: Some variables were added since release 3.5.13.2, among them: the archive format and options for the '''tar''' program. All of the additions are meant to ease the build procedure once the project will settle on a compression format for source code archives.
* Determine the target architecture for the package and set proper parameters for the compiler, linker, included libraries, etc.:
if [ -z "${MARCH}" ]; then
MARCH=`uname -m`
fi
if [ -z "${ARCH}" ]; then
case "${MARCH}" in
i?86)
export ARCH=i486
;;
arm*)
export ARCH=arm
;;
*)
export ARCH=${MARCH}
;;
esac
fi
: Code was updated in order to read the target architecture from global parameters thus providing a suitable script for '''chroot''' environments.
* Create a directory build tree:
mkdir -p ${TMP}/tmp-${PRGNAM} # Location to build the source
rm -rf ${TMP}/tmp-${PRGNAM}/* # Remove the remnants of previous build and continue
mkdir -p ${PKG} # Place for the package to be built
rm -rf ${PKG}/* # We always erase old package's contents
mkdir -p ${OUTPUT} # Place for the package to be saved
* Assign sane permissions to files:
chown -R root:root .
find . \
\( -perm 777 -o -perm 775 -o -perm 711 -o -perm 555 -o -perm 511 \) \
-exec chmod 755 {} \; -o \
\( -perm 666 -o -perm 664 -o -perm 600 -o -perm 444 -o -perm 440 -o -perm 400 \) \
-exec chmod 644 {} \;
* Configure, build and install the package.
* Add some documentation, links, examples and whatever is needed to obtain a fully functional package:
mkdir -p ${PKG}/usr/doc/${PRGNAM}"-"$VERSION
cp -a ${DOCS} ${PKG}/usr/doc/${PRGNAM}"-"${VERSION}
chown -R root:root ${PKG}/usr/doc/${PRGNAM}"-"${VERSION}
find ${PKG}/usr/doc -type f -exec chmod 644 {} \;
# Add a package description.
mkdir -p ${PKG}/install
cat ${SRCDIR}/slack-desc > ${PKG}/install/slack-desc
# Set sane permissions for the include files.
if [ -d ${PKG}/${PREFIX}/include ]; then
find ${PKG}/${PREFIX}/include -type f -exec chmod 0644 {} \;
fi
* Crete the package.
=== Generic Options ===
Generic build options will vary depending on the adopted build system only. '''Autotools''' related packages require the following:
* Rebuild the '''Autoconf / Automake''' used files:
'''cp''' ''-Rp'' /usr/share/aclocal/libtool.m4 <pkg_path_build>/admin/libtool.m4.in
'''cp''' ''-Rp'' <path to your system's ltmain.sh file> admin/ltmain.sh
'''make''' ''-f'' admin/Makefile.common
* Set options for the compiler and linker, set paths for include files, libraries and man pages:
'''export''' LD_LIBRARY_PATH=${PREFIX}/lib${LIBDIRSUFFIX}:${PREFIX}/lib${LIBDIRSUFFIX}/trinity:${LD_LIBRARY_PATH}
'''export''' LIBDIR=${PREFIX}/lib${LIBDIRSUFFIX}
'''export''' MANDIR
'''export''' PATH=${PREFIX}/bin:${PATH}
'''export''' PKG_CONFIG_PATH=:${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig:${PKG_CONFIG_PATH}
'''export''' PREFIX
'''export''' QTDIR=${PREFIX}
'''export''' SYSCONFDIR=/etc/trinity
# Enable only one of the following:
# export DEBUG_AUTOTOOL_OPT="--enable-debug=full"
'''export''' DEBUG_AUTOTOOL_OPT="''--disable-debug''"
* Configure source code:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--mandir=''${MANDIR} \
''--build=''$ARCH-slackware-linux \
2>&1 | '''tee''' -a ${OUTPUT}/${PRGNAM}_configure.log
* Build and install:
'''make''' VERBOSE=1 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_make.log
'''make''' install DESTDIR=${PKG} 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_install.log
Steps for '''[http://www.cmake.org/ Cmake]''' consist of:
* Clean the cmake cache:
'''find''' . ''-name'' CMakeCache.txt ''-exec'' '''rm''' {} \;
* Set options for the compiler and linker, set paths for include files, libraries and man pages:
'''export''' LD_LIBRARY_PATH=${PREFIX}/lib${LIBDIRSUFFIX}:${PREFIX}/lib${LIBDIRSUFFIX}/trinity:${LD_LIBRARY_PATH}
'''export''' LIBDIR=${PREFIX}/lib${LIBDIRSUFFIX}
'''export''' MANDIR
'''export''' PATH=${PREFIX}/bin:${PATH}
'''export''' PKG_CONFIG_PATH=${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig:${PKG_CONFIG_PATH}
'''export''' PREFIX
'''export''' QTDIR=${PREFIX}
'''export''' SYSCONFDIR=/etc/trinity
# Enable only one of the following:
# export DEBUG_AUTOTOOL_OPT="--disable-debug"
'''export''' DEBUG_CMAKE_OPT=""
* Configure source code:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX=''${PREFIX} \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON'' \
2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_configure.log
* Build and install:
'''make''' VERBOSE=1 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_make.log
'''make''' install DESTDIR=${PKG} 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_install.log
Packages '''python-tqt''' and '''sip4-tqt''' use a script written in Python language to configure source code. Both scripts only accept options for the compiler and linker.
* Configure source code:
'''python''' configure.py \
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_configure.log
* Build and install:
'''make''' VERBOSE=1 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_make.log
'''make''' install DESTDIR=${PKG} 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_install.log
Last is '''tqscintilla''', the only package to use '''tqmake''', which requires options for the compiler and linker.
* Configure source code:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS} ''-fno-exceptions''" \
'''tqmake''' qscintilla.pro \
2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_configure.log
* Build and install:
'''make''' VERBOSE=1 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_make.log
'''make''' install INSTALL_ROOT=${PKG} 2>&1 | '''tee''' ${OUTPUT}/${PRGNAM}_install.log
=== Custom Options ===
The generic options used to configure and build each package in the prerequisites group were discussed above. Package specific options instead are detailed below together with some tips to attain a successful build. Moreover a download link for each SlackBuild is provided in order to help whoever wishes to test a full build.
==== ARTS ====
The '''A'''nalog '''R'''eal '''T'''ime '''S'''ynthesizer is a sound library providing '''an integrated sound server''', a sound streams mixer and some configuration tools. Used since KDE 2, Arts was replaced by '''Phonon''' in KDE 4 and later adopted by TDE. To build Arts You need to set the '''-DCMAKE_SKIP_RPATH="OFF"''' option while running the configuration script. The '''[http://www.cmake.org/ cmake]''' invocation command is:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX''=${PREFIX} \
''-DCMAKE_SKIP_RPATH="OFF"'' \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON''
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/arts.tar.gz link].
==== AVAHI-TQT ====
A library providing DNS resolution capabilities to the base TDE packages tdebase and tdelibs. Avahi-tqt requires the '''avahi''' library as a dependency, but the latter is not part of a standard Slackware release. A build script for avahi can be downloaded from the [http://slackbuilds.org slackbuilds.org] web page. Once installed the dependency, '''avahi-tqt''' can be built setting some environment variables:
PREFIX="/usr/local"
MANDIR="/usr/man"
Exporting the '''tqt3''' path:
'''export''' QTDIR=${PREFIX_TDE}
Running the autogen.sh script to create all of the build scripts and configuration files:
'''sh''' ./autogen.sh
Then configuring the source code passing some parameters to the script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--mandir=''${MANDIR} \
''--build=''$ARCH-slackware-linux
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/avahi-tqt.tar.gz link]. Please note: The script is provided for reference only. I don't usually build optional packages nor set on add-on functionality if I can do without. Having no avahi package installed, I could not test the SlackBuild script behavior, just its syntax.
==== DBUS-TQT ====
A library interfacing to the '''dbus''' daemon included in most modern '''Linux''' distributions to manage hardware and provide a common messaging infrastructure for applications. Dbus is a replacement for '''HAL'''. To configure and build the package using '''[http://www.cmake.org/ cmake]''' you should:
Clean the cmake cache:
'''find''' . ''-name'' CMakeCache.txt ''-exec'' '''rm''' {} \;
Pass the '''-DCMAKE_SKIP_RPATH="OFF"''' option to cmake. The cmake command line should be something like:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX=''${PREFIX} \
''-DCMAKE_SKIP_RPATH="OFF"'' \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON''
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/dbus-tqt.tar.gz link].
==== DBUS-1-TQT ====
A '''dbus-tqt''' related library adding an abstraction layer between the dbus daemon and the TQt3 library. The package can be configured recurring to '''[http://www.cmake.org/ cmake]'''. Follow some easy steps:
Clean the cmake cache:
'''find''' . ''-name'' CMakeCache.txt ''-exec'' '''rm''' {} \;
Pass the '''-DCMAKE_SKIP_RPATH="OFF"''' option to cmake. The cmake command line should be something like:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX=''${PREFIX} \
''-DCMAKE_SKIP_RPATH=''"OFF" \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON''
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/dbus-1-tqt.tar.gz link].
==== LIBART-LGPL ====
'''Libart''' is a library for high-performance 2D graphics used by '''Gnome''', '''KDE''' and '''TDE'''. The library release distributed with TDE is different from the standard one included in many Linux distributions. You are recommended to replace the installed version if any with the TDE provided one. To build a libart package please define some environment variables:
PREFIX="/usr"
MANDIR="/usr/man"
Then configure the source code:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--build=''$ARCH-slackware-linux
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/libart-lgpl.tar.gz link].
==== LIBCALDAV ====
The '''Libcaldav''' library implements the client side '''CALDAV''' protocol defined in the '''rfc4791''' paper. The library is used by the shared calendar included in the '''tdepim''' package. It is an add-on package. Some environment variables are needed to build '''libcaldav''':
PREFIX="/usr/local"
MANDIR="/usr/man"
Define the TQt3 library path:
'''export''' QTDIR=${PREFIX_TDE}
Run the autogen.sh script to create all of the build scripts and configuration files:
'''sh''' ./autogen.sh
Then configure the source code passing some parameters to the script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--mandir=''${MANDIR} \
''--build=''$ARCH-slackware-linux
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/libcaldav.tar.gz link].
==== LIBCARDDAV ====
The '''Libcarddav''' library implements the '''CARDDAV''' protocol used by the '''tdepim''' package. '''Libcarddav''' is an add-on package providing some optional functionality. To build the package set some environment variables:
PREFIX="/usr/local"
MANDIR="/usr/man"
Define the TQt3 library path:
'''export''' QTDIR=${PREFIX_TDE}
Run the autogen.sh script to create all of the build scripts and configuration files:
'''sh''' ./autogen.sh
And configure the source code passing some parameters to the script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--libdir=''${LIBDIR} \
''--mandir=''${MANDIR} \
''--build=''$ARCH-slackware-linux
Some lines of code in the script '''install the man pages'''. Those ''' should be commented out''' to avoid an error that aborts the whole build procedure.
# Add man pages (No man page => Comment the following lines to avoid errors)
# if [ -d ${PKG}/${MANDIR} ]; then
# gzip -9 $PKG/${MANDIR}/man?/*
# fi
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/libcarddav.tar.gz link].
==== SIP4-TQT ====
'''Sip''' is a tool that eases the creation of '''Python''' bindings for '''C''' or '''C++''' libraries. It was originally developed to bind Python to Qt, but can be used for any C or C++ library. As many other previously discussed packages, sip can be built setting some environment variables:
PREFIX="/usr/local"
MANDIR="/usr/man"
Setting a target path for man pages:
'''export''' MANDIR
Adding to the standard compiler options some paths where to search for include files:
SLKCFLAGS="${SLKCFLAGS} ''-I''/usr/include/tqt ''-I''/opt/trinity/include"
and finally running a configuration script written in Python:
'''python''' configure.py \
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}"
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/sip4-tqt.tar.gz link].
==== TQCA ====
Another optional library, '''Tqca''' (TQt Cryptographic Architecture), provides an API to add cryptographic features to the Trinity Desktop Environment. Tqca has a small fingerprint and can be built recurring to some package specific steps:
Set some environment variables:
PREFIX="/usr/local"
MANDIR="/usr/man"
Set the installation path for the TQt library:
'''export''' QTDIR=${PREFIX_TDE}
Pass the aforementioned variables as parameters to the configuration script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--prefix=''${PREFIX} \
''--qtdir=''${QTDIR} \
Another peculiarity consists of the variable used to set the produced binary packages destination: '''INSTALL_ROOT''' in place of '''DESTDIR''', used by almost all of the packages.
'''make''' install INSTALL_ROOT=${PKG}
When all variables are set the build process can be started running the '''make''' command.
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/tqca.tar.gz link].
==== TQCA-TLS ====
'''Tqca-tls''' is a plug-in providing support for cryptography through a SSL/TLS channel for programs using the '''TQt Cryptographic Architecture'''. Perhaps the easiest package to build as the configure script sets sane values for all of its options. To build a working package you need to set the TQt library installation path:
'''export''' QTDIR=${PREFIX}
Then execute the build script:
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
./'''configure''' \
''--qtdir=''${QTDIR}
As for '''tqca''', the only package peculiarity consists of the variable used to set a target directory for produced binary files: '''INSTALL_ROOT'''
'''make''' install INSTALL_ROOT=${PKG}
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/tqca-tls.tar.gz link].
==== TQT3 ====
'''TQt''' is a library providing all of the base widgets used by the desktop environment and as such has a fundamental importance. Building the package requires a great deal of time, but it relatively straightforward. First of all some environment variables are required:
'''export''' LD_LIBRARY_PATH=/usr/lib${LIBDIRSUFFIX}:${TMP}/tmp-${PRGNAM}/${DIR_SRC}/lib:${TMP}/tmp-${PRGNAM}/build/lib
'''export''' QTDIR=${PREFIX}
The '''LD_LIBRARY_PATH''' variable requires special care as it should point to the directory where intermediate binary files are stored. Files which are needed in later steps of the procedure. Set the wrong value and the build procedure will fail returning an error. Given the library complexity, the '''configure''' script is invoked with an option dense command line:
LDFLAGS="${SLKLDFLAGS}" \
CFLAGS="${SLKCFLAGS}" \
CXXFLAGS="${SLKCFLAGS}" \
../${DIR_SRC}/'''configure''' \
''-cups'' \
''-dlopen-opengl'' \
''-enable-opengl'' \
''-I/usr/include/freetype2/freetype'' \
''-I/usr/include/mysql'' \
''-inputmethod'' \
''-ipv6'' \
''-L/usr/lib${LIBDIRSUFFIX}'' \
''-lfontconfig'' \
''-libdir ${PREFIX}/lib${LIBDIRSUFFIX}'' \
''-nis'' \
''-no-g++-exceptions'' \
''-no-pch'' \
''-platform linux-g++'' \
''-plugin-imgfmt-mng'' \
''-plugin-sql-mysql'' \
''-plugin-sql-sqlite'' \
''-plugin-style-cde'' \
''-plugin-style-compact'' \
''-plugin-style-motifplus'' \
''-plugin-style-platinum'' \
''-plugin-style-sgi'' \
''-plugin-style-windows'' \
''-prefix ${PREFIX}'' \
''-qt-gif'' \
''-qt-imgfmt-jpeg'' \
''-qt-imgfmt-mng'' \
''-qt-imgfmt-png'' \
''-qt-style-motif'' \
''-release'' \
''-R${TMP}/tmp-${PRGNAM}/lib'' \
''-shared'' \
''-sm'' \
''-stl'' \
''-system-libjpeg'' \
''-system-libmng'' \
''-system-libpng'' \
''-system-zlib'' \
''-thread'' \
''-tablet'' \
''-v'' \
''-xcursor'' \
''-xft'' \
''-xinerama'' \
''-xkb'' \
''-xrandr'' \
''-xrender'' \
''-xshape''
The '''make''' command requires running twice. The second time around to create symbolic links and some other stuff:
'''make''' VERBOSE=1
'''make''' install INSTALL_ROOT=${PKG}
'''make''' -i symlinks sub-src sub-tool
'''make''' install INSTALL_ROOT=${PKG}
Some other post build actions should be taken to add other symbolic links, configuration scripts, and some files needed to ensure everything will run smoothly once installed:
# Some configure scripts seem unable to find lib64 => Create a symlink to lib
if [[ "x86_64" = "${ARCH}" ]]; then
ln -sf ${PREFIX}/lib${LIBDIRSUFFIX} ${PKG}/${PREFIX}/lib
fi
# Adding a link to the include folder
mkdir -p ${PKG}/usr/include
ln -sf ${PREFIX}/include ${PKG}/usr/include/${PRGNAM}
# Move the qt-mt.pc in the pkgconfig directory
if [[ ! -f ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig/tqt-mt.pc ]]; then
mkdir -p ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig
mv ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/tqt-mt.pc ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig/tqt-mt.pc
fi
# Link for qt-mt.pc to the /usr/lib[64] directory
mkdir -p ${PKG}/usr/lib${LIBDIRSUFFIX}/pkgconfig
ln -sf ${PREFIX}/lib${LIBDIRSUFFIX}/pkgconfig/tqt-mt.pc ${PKG}/usr/lib${LIBDIRSUFFIX}/pkgconfig/tqt-mt.pc
# Fix some bad links
if [[ -d ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++ ]]; then
if [[ -L ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++/linux-g++ ]]; then
unlink ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++/linux-g++
fi
ln -sf ${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++ ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++/linux-g++
if [[ -L ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/default ]]; then
unlink ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/default
fi
ln -sf ${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/linux-g++ ${PKG}/${PREFIX}/lib${LIBDIRSUFFIX}/${PRGNAM}/mkspecs/default
elif [[ -d ${PKG}/${PREFIX}/mkspecs/linux-g++ ]]; then
if [[ -L ${PKG}/${PREFIX}/mkspecs/linux-g++/linux-g++ ]]; then
unlink ${PKG}/${PREFIX}/mkspecs/linux-g++/linux-g++
fi
ln -sf ${PREFIX}/mkspecs/linux-g++ ${PKG}${PREFIX}/mkspecs/linux-g++/linux-g++
if [[ -L ${PKG}/${PREFIX}/mkspecs/default ]]; then
unlink ${PKG}/${PREFIX}/mkspecs/default
fi
ln -sf ${PREFIX}/mkspecs/linux-g++ ${PKG}/${PREFIX}/mkspecs/default
fi
# Create and populate the profile.d directory
mkdir -p ${PKG}/etc/profile.d
# Put profile.d scripts in package TQT installation path.
cat ${SRCDIR}/profile.d/tqt3.sh | sed -e "s:TDE_PREFIX:${PREFIX}:" > ${PKG}/etc/profile.d/tqt3.sh
cat ${SRCDIR}/profile.d/tqt3.csh | sed -e "s:TDE_PREFIX:${PREFIX}:" > ${PKG}/etc/profile.d/tqt3.csh
chmod 755 ${PKG}/etc/profile.d/*
As usual a compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/tqt3.tar.gz link].
==== TQTINTERFACE ====
The '''Trinity Qt Interface''' is a library that abstracts Qt from Trinity. The abstraction layer allows to use both applications linked to TQt and Qt4 in a transparent way permitting both environments to coexist. To work correctly '''TQtinterface''' should be installed in directory '''/usr'''. To build the package set some environment variables:
PREFIX="/usr"
MANDIR="/usr/man"
Then run '''[http://www.cmake.org/ cmake]''' passing it some configuration options of which '''-DQT_VERSION=3''' is worth mentioning:
'''cmake''' ${TMP}/tmp-${PRGNAM}/${DIR_SRC} \
''-DCMAKE_C_FLAGS:STRING=''"${SLKCFLAGS}" \
''-DCMAKE_CXX_FLAGS:STRING=''"${SLKCFLAGS} $DEBUG_CMAKE_OPT" \
''-DCMAKE_INSTALL_PREFIX=''${PREFIX} \
''-DLIB_SUFFIX=''${LIBDIRSUFFIX} \
''-DMAN_INSTALL_DIR=''${MANDIR} \
''-DQT_VERSION=3'' \
''-DSYSCONF_INSTALL_DIR=''${SYSCONFDIR} \
''-DBUILD_ALL=ON''
A compressed archive containing the SlackBuild script and the related configuration files can be downloaded from the following [http://www.giustetti.net/resource/slackbuild/tde/1400/tqtinterface.tar.gz link].
=== Conclusions ===
The present paper presented and discussed the procedure to build '''Prerequisites''' packages for the '''Trinity Desktop Environment'''. Some general rules common to the whole project were described along with options specific to packages. Finally links for all of the used '''SlackBuild''' scripts were provided in the hope for them to be useful to '''Slackware Linux''' users wishing to give a try at building the desktop environment from scratch.
For any feedback, questions, errors and such, please e-mail me at ''studiosg [at] giustetti [dot] net''
External links
----
* [http://www.trinitydesktop.org/ TDE home page]
* [http://www.slackware.com Slackware home page]
* [http://slackbuilds.org SlackBuilds.org home page]
----
Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title=TDE_14.0.0_prerequisiti Italiano]
