Changes between Version 16 and Version 17 of pm-autotools


Ignore:
Timestamp:
Jun 2, 2006 7:58:19 PM (14 years ago)
Author:
andreasw
Comment:

cleaned up

Legend:

Unmodified
Added
Removed
Modified
  • pm-autotools

    v16 v17  
    4141 * '''Unit Test Makefile.am files''':  Since those also compile a program, they are similar to source directory {{{Makefile.am}}} files, but usually simpler.  [wiki:pm-test-make The Makefile.am files for the test code directories are discussed here].
    4242
    43  * '''Example Makefile.in files''':  COIN projects that generate a library, should contain some example code that demonstrates how the library can be used.  Here, we also recommend to provide ''simple'' Makefile to the user, that is adapted to the user's system and can be easily modified for the user's own application.  Since the Makefiles generated by {{{automake}}} are very complicated, we prefer to provide the template file {{{Makefile.in}}} directly instead one that is produced by {{{automake}}}.  If you want to provide such a Makefile for your example program, have a look at another existing COIN project and adapt it.
     43 * '''Example Makefile.in files''':  COIN projects that generate a library, should contain some example code that demonstrates how the library can be used.  Here, we also recommend to provide a [wiki:user-examples ''simple'' Makefile] to the user, that is adapted to the user's system and can be easily modified for the user's own application.  Since the Makefiles generated by {{{automake}}} are very complicated, we prefer to provide the template file {{{Makefile.in}}} directly instead one that is produced by {{{automake}}}.  If you want to provide such a Makefile for your example program, have a look at another existing COIN project and adapt it.
    4444
    4545== Running the Autotools ==
     
    5151A few notes of caution:
    5252
    53  * If you made a mistake in the {{{configure.ac}}} or {{{Makefile.am}}} input file, the {{{make}}} for updating everything might fail.  In some cases it is then require to rerun the autotools by hand, using the {{{BuildTools/run_autotools}}} script.
     53 * If you made a mistake in the {{{configure.ac}}} or {{{Makefile.am}}} input file, the {{{make}}} for updating everything might fail.  In some cases it is then require to rerun the autotools "by hand" after the error has been corrected, using the {{{BuildTools/run_autotools}}} script.
    5454
    5555 * When you made a change in a {{{configure.ac}}} file, a {{{make}}} will rerun the {{{configure}}} script (if you configured in the maintainer-mode), but not recursively.  If the change you made now requires the recursion into a new directory, you will have to rerun the {{{configure}}} script by hand.  To find out, with which options the {{{configure}}} script was run the last time, you can look at the beginning of the {{{config.log}}} output file.  Make sure that you don't use the {{{--no-create}}} and {{{--no-recursion}}} option when you rerun the script.
     
    6161The following files should be included in the subversion repository:
    6262
    63  * Every '''configure.ac''', '''configure''', '''Makefile.am''' and '''Makefile.in''' file, but no {{{Makefile}}} file.  Make sure, that the {{{svn:keywords}}} property for the {{{configure.ac}}} and {{{Makefile.am}}} files are set to "{{{Author Date Id Revision}}}".
     63 * Every '''configure.ac''', '''configure''', '''Makefile.am''' and '''Makefile.in''' file, '''but no Makefile''' file.  Make sure, that the {{{svn:keywords}}} property for the {{{configure.ac}}} and {{{Makefile.am}}} files are set to "{{{Author Date Id Revision}}}".
    6464
    6565 * In the base directory of the package, you also need to include: '''config.guess''', '''config.sub''', '''depcomp''', '''install-sh''', '''ltmain.sh''', and '''missing'''.  Those files will be copied into this directory automatically when you run {{{BuildTools/run_autotools}}} there.
    6666
    67  * You should also make sure that you have a subversion external dependency define to {{{BuildTools/trunk}}} into a subdirectory {{{BuildTools}}} of the package's base directory, since otherwise the Autotools will not work.
     67 * You should also make sure that you have a subversion external dependency defined to {{{BuildTools/trunk}}} into a subdirectory {{{BuildTools}}} of the package's base directory, since otherwise the Autotools will not work.