$Id: README.developer 1605 2008-10-28 21:40:34Z peter $

Requirements

To build from a subversion checkout, you will need Autotools. More specifically Automake 1.10 (or later), Autoconf 2.60 (or later), and Libtool are required.

Disable shared library

yat uses gnu Libtool in order to build shared libraries on a variety of systems. While this is very nice for making usable binaries, it can be a pain when trying to debug a program. For that reason, compilation of shared libraries can be turned off by specifying the --disable-shared option to configure.

Debugging using GDB

If shared library is enabled (default), libtool creates wrapper scripts in test/ that call the test programs located in test/.libs. While this allow us to dynamically link against the temporary library in yat/, it makes straightforward usage of GDB impossible. For that reason libtool provides a wrapper:

#> libtool --mode=execute gdb foo_test

that sets the necessary environment variables. For more detailed discussion, please refer to the libtool manual:

​http://www.gnu.org/software/libtool/manual/libtool.html#Debugging-executables

Enable svn-clean

While make distclean will remove most generated files and leave you in a state as though you just unpacked a dist, it is sometimes useful to remove even more files. For this purpose there exists a target svn-clean that will remove all files not under subversion control, in other words, leave you in a state as though you checked out a pristine subversion working copy. The target is not active by default, but can be turned on with ./configure --enable-svn-support. Use with care!

Copyright (C) 2008 Peter Johansson
This file is part of yat library, http://dev.thep.lu.se/yat
The yat library is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 3 of the
License, or (at your option) any later version.
The yat library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with yat. If not, see <http://www.gnu.org/licenses/>.