Skip to content
Snippets Groups Projects
Commit 257b5bc2 authored by Simon Marlow's avatar Simon Marlow
Browse files

[project @ 2000-11-08 10:22:03 by simonmar] 

document options to ./configure.
parent 4e9a8fa4
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
docs/building/building.sgml
+ 124
− 80
View file @ 257b5bc2
...@@ -547,8 +547,8 @@ standard source distribution. ...@@ -547,8 +547,8 @@ standard source distribution.
<Para> <Para>
Autoconf builds the <Command>configure</Command> script from Autoconf builds the <Command>configure</Command> script from
<Filename>configure.in</Filename> and <Filename>aclocal.m4</Filename>. <Filename>configure.in</Filename> and <Filename>aclocal.m4</Filename>.
If you modify either of these files, you'll need Autoconf to rebuild If you modify either of these files, you'll need
<Filename>configure</Filename>. <command>autoconf</command> to rebuild <Filename>configure</Filename>.
</Para> </Para>
</ListItem></VarListEntry> </ListItem></VarListEntry>
...@@ -879,89 +879,133 @@ You set the configuration using a three-step process. ...@@ -879,89 +879,133 @@ You set the configuration using a three-step process.
<VarListEntry> <VarListEntry>
<Term>Step 1: get ready for configuration.</Term> <Term>Step 1: get ready for configuration.</Term>
<ListItem> <ListItem>
<Para> <para>Change directory to
Change directory to <Constant>&dollar;(FPTOOLS&lowbar;TOP)</Constant> and
<Constant>&dollar;(FPTOOLS&lowbar;TOP)</Constant> and issue the command <Command>autoconf</Command><IndexTerm><Primary>autoconf</Primary></IndexTerm> (with issue the command
no arguments). This GNU program converts <Filename><Constant>&dollar;(FPTOOLS&lowbar;TOP)</Constant>/configure.in</Filename> <Command>autoconf</Command><IndexTerm><Primary>autoconf</Primary></IndexTerm>
to a shell script called <Filename><Constant>&dollar;(FPTOOLS&lowbar;TOP)</Constant>/configure</Filename>. (with no arguments). This GNU program converts
</Para> <Filename><Constant>&dollar;(FPTOOLS&lowbar;TOP)</Constant>/configure.in</Filename>
to a shell script called
<para> <Filename><Constant>&dollar;(FPTOOLS&lowbar;TOP)</Constant>/configure</Filename>.
Some projects, including GHC, have their own configure script. If </Para>
there's an
<Constant>&dollar;(FPTOOLS&lowbar;TOP)/&lt;project&gt;/configure.in</Constant>, <para>Some projects, including GHC, have their own
then you need to run <command>autoconf</command> in that directory too. configure script. If there's an
</para> <Constant>&dollar;(FPTOOLS&lowbar;TOP)/&lt;project&gt;/configure.in</Constant>,
then you need to run <command>autoconf</command> in that
<Para> directory too.</para>
Both these steps are completely platform-independent; they just mean
that the human-written file (<Filename>configure.in</Filename>) can be short, although <para>Both these steps are completely
the resulting shell script, <Command>configure</Command>, and <Filename>mk/config.h.in</Filename>, are platform-independent; they just mean that the
long. human-written file (<Filename>configure.in</Filename>)
</Para> can be short, although the resulting shell script,
<Command>configure</Command>, and
<Para> <Filename>mk/config.h.in</Filename>, are long.</para>
In case you don't have <Command>autoconf</Command> we distribute the results,
<Command>configure</Command>, and <Filename>mk/config.h.in</Filename>, with the source distribution. They <Para>In case you don't have <Command>autoconf</Command>
aren't kept in the repository, though. we distribute the results, <Command>configure</Command>,
</Para> and <Filename>mk/config.h.in</Filename>, with the source
</ListItem></VarListEntry> distribution. They aren't kept in the repository,
<VarListEntry> though.</Para>
<Term>Step 2: system configuration.</Term> </listitem>
<ListItem> </varlistentry>
<Para>
Runs the newly-created <Command>configure</Command> script, thus: <varlistentry>
<term>Step 2: system configuration.</term>
<listitem>
<para>Runs the newly-created
<Command>configure</Command> script, thus:</para>
<ProgramListing> <ProgramListing>
./configure ./configure <optional><parameter>args</parameter></optional>
</ProgramListing> </ProgramListing>
<Command>configure</Command>'s mission is to scurry round your <para><Command>configure</Command>'s mission is to
computer working out what architecture it has, what operating system, scurry round your computer working out what architecture
whether it has the <Function>vfork</Function> system call, where it has, what operating system, whether it has the
<Command>yacc</Command> is kept, whether <Command>gcc</Command> is <Function>vfork</Function> system call, where
available, where various obscure <Literal>&num;include</Literal> files <Command>yacc</Command> is kept, whether
are, whether it's a leap year, and what the systems manager had for <Command>gcc</Command> is available, where various
lunch. It communicates these snippets of information in two ways: obscure <Literal>&num;include</Literal> files are,
</Para> whether it's a leap year, and what the systems manager
had for lunch. It communicates these snippets of
<Para> information in two ways:</para>
<ItemizedList> <itemizedlist>
<ListItem> <listitem>
<Para> <para>It translates
It translates <Filename>mk/config.mk.in</Filename><IndexTerm><Primary>config.mk.in</Primary></IndexTerm> to <Filename>mk/config.mk.in</Filename><IndexTerm><Primary>config.mk.in</Primary></IndexTerm>
<Filename>mk/config.mk</Filename><IndexTerm><Primary>config.mk</Primary></IndexTerm>, substituting for things between to
``<Literal>@</Literal>'' brackets. So, ``<Literal>@HaveGcc@</Literal>'' will be replaced by <Filename>mk/config.mk</Filename><IndexTerm><Primary>config.mk</Primary></IndexTerm>,
``<Literal>YES</Literal>'' or ``<Literal>NO</Literal>'' depending on what <Command>configure</Command> finds. substituting for things between
<Filename>mk/config.mk</Filename> is included by every Makefile (directly or indirectly), ``<Literal>@</Literal>'' brackets. So,
so the configuration information is thereby communicated to all ``<Literal>@HaveGcc@</Literal>'' will be replaced by
Makefiles. ``<Literal>YES</Literal>'' or
``<Literal>NO</Literal>'' depending on what
</Para> <Command>configure</Command> finds.
</ListItem> <Filename>mk/config.mk</Filename> is included by
<ListItem> every Makefile (directly or indirectly), so the
configuration information is thereby communicated to
<Para> all Makefiles.</para>
It translates <Filename>mk/config.h.in</Filename><IndexTerm><Primary>config.h.in</Primary></IndexTerm> to </ListItem>
<Filename>mk/config.h</Filename><IndexTerm><Primary>config.h</Primary></IndexTerm>. The latter is <Literal>&num;include</Literal>d by various C
programs, which can thereby make use of configuration information. <listitem>
<para> It translates
<Filename>mk/config.h.in</Filename><IndexTerm><Primary>config.h.in</Primary></IndexTerm>
to
<Filename>mk/config.h</Filename><IndexTerm><Primary>config.h</Primary></IndexTerm>.
The latter is <Literal>&num;include</Literal>d by
various C programs, which can thereby make use of
configuration information.</para>
</listitem>
</itemizedlist>
<para><command>configure</command> takes some optional
arguments. Use <literal>./configure --help</literal> to
get a list of the available arguments. Here are some of
the ones you might need:</para>
<variablelist>
<varlistentry>
<term><literal>--with-ghc=<parameter>path</parameter></literal></term>
<indexterm><primary><literal>--with-ghc</literal></primary>
</indexterm>
<listitem>
<para>Specifies the path to an installed GHC which
you would like to use. This compiler will be used
for compiling GHC-specific code (eg. GHC itself).
This option <emphasis>cannot</emphasis> be
specified using <filename>build.mk</filename> (see
later), because <command>configure</command> needs
to auto-detect the version of GHC you're using.
The default is to look for a compiler named
<literal>ghc</literal> in your path.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>--with-hc=<parameter>path</parameter></literal></term>
<indexterm><primary><literal>--with-hhc</literal></primary>
</indexterm>
<listitem>
<para>Specifies the path to any installed Haskell
compiler. This compiler will be used for
compiling generic Haskell code. The default is to
use <literal>ghc</literal>.</para>
</listitem>
</varlistentry>
</variablelist>
<para><command>configure</command> caches the results of
its run in <Filename>config.cache</Filename>. Quite
often you don't want that; you're running
<Command>configure</Command> a second time because
something has changed. In that case, simply delete
<Filename>config.cache</Filename>.</para>
</listitem>
</varlistentry>
</Para>
</ListItem>
</ItemizedList>
</Para>
<Para>
<Command>configure</Command> caches the results of its run in <Filename>config.cache</Filename>. Quite
often you don't want that; you're running <Command>configure</Command> a second time
because something has changed. In that case, simply delete
<Filename>config.cache</Filename>.
</Para>
</ListItem></VarListEntry>
<VarListEntry> <VarListEntry>
<Term>Step 3: build configuration.</Term> <Term>Step 3: build configuration.</Term>
<ListItem> <ListItem>
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment