source: trunk/README.developer @ 1537

$Id: README.developer 1487 2008-09-10 08:41:36Z jari $

= 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


----------------------------------------------------------------------
{{{
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/>.
}}}