Changes between Version 1 and Version 2 of pm-autotools


Ignore:
Timestamp:
May 29, 2006 7:38:38 PM (14 years ago)
Author:
andreasw
Comment:

continue first draft

Legend:

Unmodified
Added
Removed
Modified
  • pm-autotools

    v1 v2  
    1111=== Autoconf ===
    1212
    13 Everybody, who has downloaded and installed a GNU package, has seen the {{{configure}}} step in the installation process.  Autoconf is the software that generates the rather complicated shell script "{{{configure}}}" from a simply input file.
     13Everybody, who has downloaded and installed a GNU package, has seen the {{{configure}}} step in the installation process.  Autoconf is the software that generates the rather complicated shell script "{{{configure}}}" from a simply input file, which is called {{{configure.ac}}}.
    1414
    1515The goal of Autoconf is to provide developers of open source software with an easy way to ensure portability of their code.  Autoconf can perform tests to find out platform and compiler dependent properties, such as the presence of certain program, libraries, or header files.  The {{{configure}}} script is a shell script for {{{/bin/sh}}}, i.e., the basic shell that is available on every UNIX-like system (including Linux, Cygwin, and MSys).  The attempt is made to write this script so that it will work on almost every such system, and therefore the least common denominator of all platforms is taken.
     16
     17'''Template Files'''
    1618
    1719At completion, the {{{configure}}} script will have generated some ''output files'' (such as a {{{Makefile}}}), based on a template for this file, that has the extension {{{.in}}} (e.g., {{{Makefile.in}}}).  The template files contain strings (autoconf variable names) surrounded by {{{@}}}.  For example, the autoconf variable for the name of the C compiler is {{{CC}}}, and in the template for a makeile you will find a line like
     
    2123}}}
    2224
    23 The generated final Makefile will then contain this line, with {{{@CC@}}} replaced by the name of the C compiler program.
     25The generated final Makefile will then contain this line, with {{{@CC@}}} replaced by the name of the C compiler program that the {{{configure}}} program has determined.
     26
     27You won't have to create those templated files on your own, since we are using Automake to automatically generate Makefiles from a simply input file.
     28
     29Another template file in many COIN packages is used to generate the {{{pkg_addlibs.txt}}} file, which is installed together with the libraries of a package and includes the string that should be added to the link command to link with the library to specify additionally required libraries.  The name of the template file is then {{{pkg_addlibs.txt.in}}}, and it only includes the entry {{{@ADDLIBS@}}}.
     30
     31'''Configuration Header Files'''
     32
     33An additional output of the {{{configure}}} script is a configuration header file (you might have seen the {{{config.h}}} file in GNU packages).  This file can be used to convey information about the configuration run to the source code of the package.
     34
     35For example, system calls, such as those for obtaining the CPU time, are different on different platforms.  The {{{configure}}} script can test for the presence of header files. 
     36
     37Also, one can test for the presence of libraries and functions in libraries.  An example of this is used in the {{{CoinUtils}}} package, for which, if {{{configure}}} is run with the {{{--enable-gnu-packages}}} flag, the configuration script checks if the compression library {{{libz}}} is available.
     38
     39Similarly, the user of a package can determine certain aspects of the configuration, for example, which linear programming solvers are available, and where the libraries and header files are.
     40
     41The configuration header file contains {{{#define}}}s, that can simply be just defined, or can be set to specific values (such as the path for a certain directory).  In COIN, we follow the convention to use the name {{{config_pkg.h}}} for the configuration file for a Package Pkg.  However, to make it easy to compile the COIN code also with the MS Developer Studio, this file should not be include directly in the COIN source code.  Instead, the "wrapper" header file {{{PkgConfig.h}}} should be used, which on UNIX-like machines includes the header generated by {{{configure}}}, but uses default values for other systems, as well as a system specific header files for platform dependencies.
     42
     43=== Automake ===
     44
     45Automake is a package that generates Makefile template files for Autoconf.  The generated makefiles are very powerful; for example, they support automatic header file dependency tracking (if this information can be somehow obtained from the compiler).  The makefiles work with any UNIX {{{make}}}, they have targets like {{{install}}}, {{{uninstall}}}, {{{clean}}}, {{{distclean}}}, and {{{dist}}}.
     46
     47Automake generated Makefiles can work recursively, and support parallel compilation (e.g., with the {{{-j}}} flag of GNU make).  Also, it is possible to specify conditional content of the Makefile, the activation of which depends on the output of a test done by {{{configure}}}.
     48
     49As a user of Automake, you write an input file, called {{{Makefile.am}}}, for each {{{Makefile.in}}} you want to create.  In there, you tell Automake what you want to build (a program, a library, etc.), and what source code files are required to build this file.  There are ways to specify more information, e.g., if additional libraries are required for linking.
     50
     51=== Libtool ===
     52
     53Libtool helps to build libraries and shared objects on different platforms.  It works together with Autoconf and Automake, so that you usually don't need to interact with it directly.  Here just some background:
     54
     55The {{{libtool}}} script itself is generated by {{{configure}}} for the host system the configuration is done on.  It can then be used to compile code, create libraries, and link programs.  Most of the rules of the Makefiles therefore work through libtool, and in the output you usually first see the command line that executes libtool, when then echos the command it finally executes.
     56
     57Libtool generates auxilliary files, such as {{{.lo}}} files corresponding to object files, and {{{.la}}} files corresponding to libraries.  Also, the compiled objects and libraries are located in the compilation directory itself, and in a {{{.libs}}} subdirectory.  If both static and shared libraries are compiled, each source file is compiled twice, because the compilation might be different for the different library types.