From 91bb8d05d9433071833c31cd5699e4384856edef Mon Sep 17 00:00:00 2001
From: Markus Blatt <mblatt@dune-project.org>
Date: Thu, 21 Dec 2006 11:21:18 +0000
Subject: [PATCH] Adapted README created by dunecontrol to reflect the new dune
module build system.
Fixes flyspray #215
[[Imported from SVN: r4821]]
---
bin/duneproject | 71 ++++++++++++++++++++++---------------------------
1 file changed, 32 insertions(+), 39 deletions(-)
diff --git a/bin/duneproject b/bin/duneproject
index e0c37dd15..9fce151dd 100755
--- a/bin/duneproject
+++ b/bin/duneproject
@@ -395,68 +395,61 @@ following programs installed on your system:
Getting started
---------------
-If these preliminaries are met, you should run the script
+If these preliminaries are met, you should run
- ./autogen.sh
+ dunecontrol all
-which calls the GNU autoconf/automake to create a ./configure-script
-and the Makefiles. Most probably you'll have to provide where to find
-the DUNE-files by
+which will find all installed dune modules as well as all dune modules
+(not installed) which sources reside in a subdirectory of the current
+directory. Note that if dune is not installed properly you will either
+have to add the directory where the dunecontrol script resides (probably
+./dune-common/bin) to your path or specify the relative path of the script.
- ./autogen.sh --with-dune=PATH
+On your project and all uninstalled DUNE source modules found the script
+will then calls the GNU autoconf/automake to create a ./configure-script
+and the Makefiles. Afterwards that configure script will be called and the
+modules will be build using make all
-where PATH is a directory with a dune/-subdirectory inside (this
-convention is needed to keep the #include-syntax consistent even when
-the headers are installed into /usr/include/dune later).
+Most probably you'll have to provide additional information to dunecontrol
+(e. g. compilers, configure options) and/or make options.
+The most convenient way is to use options files in this case. The files
+defining three variables:
-Passing options to ./configure
-------------------------------
+AUTOGEN_FLAGS flags passed to autogen
+CONFIGURE_FLAGS flags passed to configure
+MAKE_FLAGS flags passed to make
-autogen.sh also calls the newly created configure-script to
-conveniently pass on options about the used compiler. Thus you'll have
-to provide autogen.sh any options you want configure to get, e.g.
+An example options file might look like this:
- ./autogen.sh --with-dune=... --with-albert=... --without-x
+#use this options to autogen, configure and make if no other options are given
+AUTOGEN_FLAGS="--ac=2.50 --ac=1.8" #Forces automake 2,50 and autoconf 1.8
+CONFIGURE_FLAGS="CXX=g++-3.4 --prefix=/install/path" #force g++-3.4 as compiler
+MAKE_FLAGS=install #Per default run make install instead of simply make
+If you save this information into example.opts you can path the opts file to
+dunecontrol via the --opts option, e. g.
-Choosing the compiler and the options
--------------------------------------
+ dunecontrol --opts=example.opts all
-The selection of the compiler works as follows: if --gnu or --intel is
-passed to autogen it reads the content of gcc.opts or icc.opts to get
-the default compiler flags. With the option --optim you can switch the
-compiler-specific optimization parameters on.
+To get a full list of available configure flags just run
-If you want to change the compiler options to your favourites you can
-either
-
- - adapt the appropriate .opts-file and rerun autogen.sh. Please don't
- commit this changed file to CVS if you're not sure if the options
- work for everybody.
-
- - copy an existing .opts-file to a new name, change the options and
- use
-
- ./autogen.sh --opts=my.opts
+ dunecontrol configure --help
+after running at least
+ dunecontrol autogen
More info
---------
See
- ./autogen.sh --help
+ dunecontrol --help
-and (if it exists)
-
- ./configure --help
-
for further options.
-The full build-system is described in the dune/doc/Buildsystem (not in
-duneapps/doc!)
+The full build-system is described in the dune-common/doc/buildsystem (SVN version) or under share/doc/dune-common/buildsystem if you installed DUNE!
\$Id$
--
GitLab