[Dune] [Dune-Commit] dune-common r6583 - trunk/doc/buildsystem

[Christian Engwer]

Hi Christoph,

what is the purpose of Extra-Suggests? This is never handled
anywhere. It is not a supported entry in the dune.module file. Are you
going to add support for this? What will ist do?

Curious
Christian


On Sat, Mar 10, 2012 at 04:18:45PM +0100, gruenich at dune-project.org wrote:
> Author: gruenich
> Date: 2012-03-10 16:18:45 +0100 (Sat, 10 Mar 2012)
> New Revision: 6583
> 
> Modified:
>    trunk/doc/buildsystem/buildsystem.tex
> Log:
> Updated chapter 6 in buildsystem.tex.
> 
> 
> Modified: trunk/doc/buildsystem/buildsystem.tex
> ===================================================================
> --- trunk/doc/buildsystem/buildsystem.tex	2012-03-10 11:03:18 UTC (rev 6582)
> +++ trunk/doc/buildsystem/buildsystem.tex	2012-03-10 15:18:45 UTC (rev 6583)
> @@ -1227,7 +1227,7 @@
>    directories containing \dunemodule files and the parameters given on
>    the command line are passed as parameters to \autogen.
>  \item \texttt{configure} runs \configure for each
> -  module. \texttt{--with-dune\textit{module}} parameters are created
> +  module. \texttt{--with-dune-\textit{module}} parameters are created
>    for a set of known \dune modules.
>  \item \texttt{make} runs \make for each module.
>  \item \texttt{all} runs \autogen, \configure and \make for each module.
> @@ -1305,9 +1305,11 @@
>  \begin{lst}[File dune.module] \mbox{}
>  \begin{lstlisting}
>  # parameters for dune control
> -Module: dune_grid
> -Depends: dune_common
> -Suggests: UG Alberta Alu3d
> +Module: dune-grid
> +Version: 2.2-svn
> +Maintainer: dune at dune-project.org
> +Depends: dune-common (>= 2.2) dune-geometry (>= 2.2)
> +Extra-Suggests: UG Alberta Alu3d
>  
>  # overload the run_configure command
>  run_configure () {
> @@ -1331,15 +1333,22 @@
>  i.e. the order in which the modules are built. The parameters and
>  their values are separated by colon. Possible parameters are
>  \begin{itemize}
> -\item \texttt{Module} (\em required\em) is the name of the module. The
> -  name is of the form \texttt{[a-zA-Z0-9\_]+}.
> -\item \texttt{Depends} (\em required\em) takes a space separated list
> +\item \texttt{Module} {\em (required)} is the name of the module. The
> +  name is of the form \texttt{[a-zA-Z0-9\_-]+}.
> +\item \texttt{Version} {\em (optional)} is the module's version.
> +\item \texttt{Maintainer} {\em (optional)} is the email address of the 
> +  module's maintainer.
> +\item \texttt{Depends} {\em (required)} takes a space separated list
>    of required modules. This module is not functional without these
> -  other modules.
> -\item \texttt{Suggests} (\em optional\em) takes a space separated list
> +  other modules. Checks whether the demanded version of the required
> +  modules is provided.
> +\item \texttt{Suggests} {\em (optional)} takes a space separated list
>    of optional modules. This module is functional without these
>    other modules, but can offer further functionality if one or more of
>    the suggested modules are found.
> +\item \texttt{Extra-Suggests} {\em (optional)} takes a space separated 
> +  list of optional external modules. These are only for users to mention
> +  recommended suggestions.
>  \end{itemize}
>  
>  The command section lets you overload the default implementation
> 
> 
> _______________________________________________
> Dune-Commit mailing list
> Dune-Commit at dune-project.org
> http://lists.dune-project.org/mailman/listinfo/dune-commit
>