source: trunk/README.developer @ 1638

Last change on this file since 1638 was 1638, checked in by Peter, 11 years ago

typos

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
  • Property svn:mime-type set to text/x-trac-wiki
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/>.
Note: See TracBrowser for help on using the repository browser.