NAME

       dunecontrol - Control program for the Dune build system

SYNOPSIS

       dunecontrol [OPTIONS] COMMANDS [COMMAND-OPTIONS]

DESCRIPTION

       dunecontrol is the control program for the build system of the Dune libraries.

       The  Dune  libraries  form a set of modules.  Each can be built independently using either
       the AutoTools or cmake.  Additionally, though, there  are  dependencies  between  modules,
       which are expected to form a directed acyclic graph.  These dependencies are set in a file
       called dune.module contained in the main directory of a Dune module.

       The dunecontrol program helps to build sets of inter-dependent modules.  It allows one  to
       construct the entire dependency graph and obtain information about it.  Then it allows one
       to give various build-related commands for all modules.  These are executed in  the  order
       mandated by the dependency graph.

COMMANDS

       Colon-separated list of commands. Available commands are:

       help

              Shows a help message and exits

       print

              Print the list of modules sorted after their dependencies

       info

              Same as `print', but including whether it is a dependency or suggestion

       printdeps

              Print recursive dependencies of a module

       vcsetup

              Setup version control repository (Git etc.) or working copy (SVN)

       update

              Update all modules from the repository

       autogen

              Run the autogen.sh script for each module. Does nothing, if CMake is activated

       configure

              Run configure or cmake for each module

       make

              Run make for each module

       all

              Run the 'autogen', 'configure' and 'make' commands for each module

       exec

              Execute an arbitrary command in each module source directory

       bexec

              Execute an arbitrary command in each module build directory

       status

              Show version control status for all modules

       svn

              Run svn command for each svn managed module

       git

              Run git command for each git managed module

       export

              Run  eval  `dunecontrol  export`  to  save  the  list  of  dune.module files to the
              DUNE_CONTROL_PATH variable

OPTIONS

       -h, --help

              Show this help

       --debug

              Run with debugging output enabled

       --use-cmake

              Use cmake instead of the AutoTools for building individual modules

       --no-cmake

              Use the AutoTools instead of cmake for building individual modules

       --module=mod

              Apply the actions on module mod and all modules it depends on

       --only=mod

              Only apply the actions on module mod , but not the modules it depends on

       --current

              Only apply the actions on the current module, the one whose source tree we are in

       --current-dep

              Apply the actions on the current module, and all modules it depends on

       --resume

              Resume a previous run (only consider the modules  not  built  successfully  on  the
              previous run)

       --skipfirst

              Skip the first module (use with --resume)

       --opts=file

              Load default options from file (see dune-common/doc/example.opts)

       --builddir=name

              Make  out-of-source  builds in a subdir name. This directory is created inside each
              module.

       --[COMMAND]-opts=opts

              Set options for COMMAND (this is mainly useful for the 'all' COMMAND)

ENVIRONMENT VARIABLES

       dunecontrol looks for Dune modules in  all  directories  given  in  the  DUNE_CONTROL_PATH
       variable,  and  additionally  recursively in all subdirectories of those directories.  The
       default for the case that DUNE_CONTROL_PATH is empty is  the  current  directory,  plus  a
       system-wide installation in /usr.

AUTHOR

       Dune was written by the Dune team (www.dune-project.org/people).

       This manual page was written by Oliver Sander.

COPYRIGHT

       Copying  and distribution of this file, with or without modification, are permitted in any
       medium without royalty provided the copyright notice and this notice are preserved.   This
       file is offered as-is, without any warranty.

                                        November 26, 2013                          DUNECONTROL(1)