source:
trunk/README.developer
@
1638
Last change on this file since 1638 was 1638, checked in by , 15 years ago | |
---|---|
|
|
File size: 2.3 KB |
$Id: README.developer 1638 2008-12-11 15:37:04Z 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 directory test/ that call the test programs located in directory test/.libs/. While this allows 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/>.