/* * Project: MoleCuilder * Description: creates and alters molecular systems * Copyright (C) 2010 University of Bonn. All rights reserved. * Please see the LICENSE file or "Copyright notice" in builder.cpp for details. */ /** * \file debug.dox * * Herein, notes concerning the debugging of the code are contained. * * Created on: Nov 10, 2011 * Author: heber */ /** * \page debug Some notes on Debugging * * \section debug-libtool Debug the code with libtool * * Since the switch to shared libraries we use libtool to do the compiling and * linking. * * Due to its inner workings, the true executable is not generated until * \code * make install * \endcode * is executed. If you check on e.g. \b./src/molecuilder in your build directory * after compilation you will notice that it is just a shell script pointing to * some stuff residing in \b .libs in the same directory. * * Hence, debugging this shell script will not work, but make \a gdb cry out * that it does not recognize the executable's format: * \code * $> gdb ./src/molecuilder * GNU gdb (GDB) 7.1-ubuntu * Copyright (C) 2010 Free Software Foundation, Inc. * License GPLv3+: GNU GPL version 3 or later * This is free software: you are free to change and redistribute it. * There is NO WARRANTY, to the extent permitted by law. Type "show copying" * and "show warranty" for details. * This GDB was configured as "x86_64-linux-gnu". * For bug reporting instructions, please see: * ... * "/mnt.auto/bespin/heber/workspace_C/molecuilder/debug64/src/molecuilder": not in executable format: File format not recognized * (gdb) q * \endcode * Instead, execute: * \code * libtool --mode=execute gdb --args ./src/molecuilder -v [some more options ...] * \endcode * You may also set your own alias in \b ~/.bashrc to ease the typing, just add * the following line to the file * \code * alias debug='libtool --mode=execute gdb --args' * \endcode * * * \date 2011-11-10 * */