<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Distribution.Simple.Configure</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[
window.onload = function () {pageLoad();setSynopsis("mini_Distribution-Simple-Configure.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">Cabal-1.14.0: A framework for packaging Haskell software</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Portability</th><td>portable</td></tr><tr><th>Maintainer</th><td>cabal-devel@haskell.org</td></tr><tr><th>Safe Haskell</th><td>None</td></tr></table><p class="caption">Distribution.Simple.Configure</p></div><div id="description"><p class="caption">Description</p><div class="doc"><p>This deals with the <em>configure</em> phase. It provides the <code><a href="Distribution-Simple-Configure.html#v:configure">configure</a></code> action
which is given the package description and configure flags. It then tries
to: configure the compiler; resolves any conditionals in the package
description; resolve the package dependencies; check if all the extensions
used by this package are supported by the compiler; check that all the build
tools are available (including version checks if appropriate); checks for
any required <code>pkg-config</code> packages (updating the <code><a href="Distribution-PackageDescription.html#t:BuildInfo">BuildInfo</a></code> with the
results)
</p><p>Then based on all this it saves the info in the <code><a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a></code> and writes
it out to the <code>dist/setup-config</code> file. It also displays various details to
the user, the amount of information displayed depending on the verbosity
level.
</p></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><a href="#v:configure">configure</a> :: (<a href="Distribution-PackageDescription.html#t:GenericPackageDescription">GenericPackageDescription</a>, <a href="Distribution-PackageDescription.html#t:HookedBuildInfo">HookedBuildInfo</a>) -> <a href="Distribution-Simple-Setup.html#t:ConfigFlags">ConfigFlags</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a></li><li class="src short"><a href="#v:writePersistBuildConfig">writePersistBuildConfig</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> ()</li><li class="src short"><a href="#v:getPersistBuildConfig">getPersistBuildConfig</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a></li><li class="src short"><a href="#v:checkPersistBuildConfigOutdated">checkPersistBuildConfigOutdated</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="../base-4.5.1.0/Data-Bool.html#t:Bool">Bool</a></li><li class="src short"><a href="#v:maybeGetPersistBuildConfig">maybeGetPersistBuildConfig</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> (<a href="../base-4.5.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a>)</li><li class="src short"><a href="#v:localBuildInfoFile">localBuildInfoFile</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a></li><li class="src short"><a href="#v:getInstalledPackages">getInstalledPackages</a> :: <a href="Distribution-Verbosity.html#t:Verbosity">Verbosity</a> -> <a href="Distribution-Simple-Compiler.html#t:Compiler">Compiler</a> -> <a href="Distribution-Simple-Compiler.html#t:PackageDBStack">PackageDBStack</a> -> <a href="Distribution-Simple-Program.html#t:ProgramConfiguration">ProgramConfiguration</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="Distribution-Simple-PackageIndex.html#t:PackageIndex">PackageIndex</a></li><li class="src short"><a href="#v:configCompiler">configCompiler</a> :: <a href="../base-4.5.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="Distribution-Compiler.html#t:CompilerFlavor">CompilerFlavor</a> -> <a href="../base-4.5.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="Distribution-Simple-Program.html#t:ProgramConfiguration">ProgramConfiguration</a> -> <a href="Distribution-Verbosity.html#t:Verbosity">Verbosity</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> (<a href="Distribution-Simple-Compiler.html#t:Compiler">Compiler</a>, <a href="Distribution-Simple-Program.html#t:ProgramConfiguration">ProgramConfiguration</a>)</li><li class="src short"><a href="#v:configCompilerAux">configCompilerAux</a> :: <a href="Distribution-Simple-Setup.html#t:ConfigFlags">ConfigFlags</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> (<a href="Distribution-Simple-Compiler.html#t:Compiler">Compiler</a>, <a href="Distribution-Simple-Program.html#t:ProgramConfiguration">ProgramConfiguration</a>)</li><li class="src short"><a href="#v:ccLdOptionsBuildInfo">ccLdOptionsBuildInfo</a> :: [<a href="../base-4.5.1.0/Data-String.html#t:String">String</a>] -> [<a href="../base-4.5.1.0/Data-String.html#t:String">String</a>] -> <a href="Distribution-PackageDescription.html#t:BuildInfo">BuildInfo</a></li><li class="src short"><a href="#v:tryGetConfigStateFile">tryGetConfigStateFile</a> :: <a href="../base-4.5.1.0/Text-Read.html#t:Read">Read</a> a => <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> (<a href="../base-4.5.1.0/Data-Either.html#t:Either">Either</a> <a href="../base-4.5.1.0/Data-String.html#t:String">String</a> a)</li><li class="src short"><a href="#v:checkForeignDeps">checkForeignDeps</a> :: <a href="Distribution-PackageDescription.html#t:PackageDescription">PackageDescription</a> -> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a> -> <a href="Distribution-Verbosity.html#t:Verbosity">Verbosity</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> ()</li></ul></div><div id="interface"><h1>Documentation</h1><div class="top"><p class="src"><a name="v:configure" class="def">configure</a> :: (<a href="Distribution-PackageDescription.html#t:GenericPackageDescription">GenericPackageDescription</a>, <a href="Distribution-PackageDescription.html#t:HookedBuildInfo">HookedBuildInfo</a>) -> <a href="Distribution-Simple-Setup.html#t:ConfigFlags">ConfigFlags</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a></p><div class="doc"><p>Perform the "<code>./setup configure</code>" action.
Returns the <code>.setup-config</code> file.
</p></div></div><div class="top"><p class="src"><a name="v:writePersistBuildConfig" class="def">writePersistBuildConfig</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> ()</p><div class="doc"><p>After running configure, output the <code><a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a></code> to the
<code><a href="Distribution-Simple-Configure.html#v:localBuildInfoFile">localBuildInfoFile</a></code>.
</p></div></div><div class="top"><p class="src"><a name="v:getPersistBuildConfig" class="def">getPersistBuildConfig</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a></p><div class="doc"><p>Read the <code><a href="Distribution-Simple-Configure.html#v:localBuildInfoFile">localBuildInfoFile</a></code>. Error if it doesn't exist. Also
fail if the file containing LocalBuildInfo is older than the .cabal
file, indicating that a re-configure is required.
</p></div></div><div class="top"><p class="src"><a name="v:checkPersistBuildConfigOutdated" class="def">checkPersistBuildConfigOutdated</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="../base-4.5.1.0/Data-Bool.html#t:Bool">Bool</a></p><div class="doc"><p>Check that localBuildInfoFile is up-to-date with respect to the
.cabal file.
</p></div></div><div class="top"><p class="src"><a name="v:maybeGetPersistBuildConfig" class="def">maybeGetPersistBuildConfig</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> (<a href="../base-4.5.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a>)</p><div class="doc"><p>Try to read the <code><a href="Distribution-Simple-Configure.html#v:localBuildInfoFile">localBuildInfoFile</a></code>.
</p></div></div><div class="top"><p class="src"><a name="v:localBuildInfoFile" class="def">localBuildInfoFile</a> :: <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a></p><div class="doc"><pre>dist/setup-config</pre></div></div><div class="top"><p class="src"><a name="v:getInstalledPackages" class="def">getInstalledPackages</a> :: <a href="Distribution-Verbosity.html#t:Verbosity">Verbosity</a> -> <a href="Distribution-Simple-Compiler.html#t:Compiler">Compiler</a> -> <a href="Distribution-Simple-Compiler.html#t:PackageDBStack">PackageDBStack</a> -> <a href="Distribution-Simple-Program.html#t:ProgramConfiguration">ProgramConfiguration</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="Distribution-Simple-PackageIndex.html#t:PackageIndex">PackageIndex</a></p></div><div class="top"><p class="src"><a name="v:configCompiler" class="def">configCompiler</a> :: <a href="../base-4.5.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="Distribution-Compiler.html#t:CompilerFlavor">CompilerFlavor</a> -> <a href="../base-4.5.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="Distribution-Simple-Program.html#t:ProgramConfiguration">ProgramConfiguration</a> -> <a href="Distribution-Verbosity.html#t:Verbosity">Verbosity</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> (<a href="Distribution-Simple-Compiler.html#t:Compiler">Compiler</a>, <a href="Distribution-Simple-Program.html#t:ProgramConfiguration">ProgramConfiguration</a>)</p></div><div class="top"><p class="src"><a name="v:configCompilerAux" class="def">configCompilerAux</a> :: <a href="Distribution-Simple-Setup.html#t:ConfigFlags">ConfigFlags</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> (<a href="Distribution-Simple-Compiler.html#t:Compiler">Compiler</a>, <a href="Distribution-Simple-Program.html#t:ProgramConfiguration">ProgramConfiguration</a>)</p></div><div class="top"><p class="src"><a name="v:ccLdOptionsBuildInfo" class="def">ccLdOptionsBuildInfo</a> :: [<a href="../base-4.5.1.0/Data-String.html#t:String">String</a>] -> [<a href="../base-4.5.1.0/Data-String.html#t:String">String</a>] -> <a href="Distribution-PackageDescription.html#t:BuildInfo">BuildInfo</a></p><div class="doc"><p>Makes a <code><a href="Distribution-PackageDescription.html#t:BuildInfo">BuildInfo</a></code> from C compiler and linker flags.
</p><p>This can be used with the output from configuration programs like pkg-config
and similar package-specific programs like mysql-config, freealut-config etc.
For example:
</p><pre> ccflags <- rawSystemProgramStdoutConf verbosity prog conf ["--cflags"]
ldflags <- rawSystemProgramStdoutConf verbosity prog conf ["--libs"]
return (ccldOptionsBuildInfo (words ccflags) (words ldflags))
</pre></div></div><div class="top"><p class="src"><a name="v:tryGetConfigStateFile" class="def">tryGetConfigStateFile</a> :: <a href="../base-4.5.1.0/Text-Read.html#t:Read">Read</a> a => <a href="../base-4.5.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> (<a href="../base-4.5.1.0/Data-Either.html#t:Either">Either</a> <a href="../base-4.5.1.0/Data-String.html#t:String">String</a> a)</p></div><div class="top"><p class="src"><a name="v:checkForeignDeps" class="def">checkForeignDeps</a> :: <a href="Distribution-PackageDescription.html#t:PackageDescription">PackageDescription</a> -> <a href="Distribution-Simple-LocalBuildInfo.html#t:LocalBuildInfo">LocalBuildInfo</a> -> <a href="Distribution-Verbosity.html#t:Verbosity">Verbosity</a> -> <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> ()</p></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.11.0</p></div></body></html>
distrib
>
Mageia
>
5
>
x86_64
>
media
>
core-release
>
by-pkgid
>
956c458aa5fe9afc4d2c00cb7b491287
>
files
>
2037
