summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorsimonmar <unknown>2004-06-17 13:35:33 +0000
committersimonmar <unknown>2004-06-17 13:35:33 +0000
commita06978c14c6f0cfdb797a8428e2fdf2bbddbc8f1 (patch)
treee94f284544168df72649f852382799e55828a885 /docs
parentabad55965acd8699832b1d4708496a93de882dfe (diff)
downloadhaskell-a06978c14c6f0cfdb797a8428e2fdf2bbddbc8f1.tar.gz
[project @ 2004-06-17 13:35:33 by simonmar]
Mention the splitter in the section on porting.
Diffstat (limited to 'docs')
-rw-r--r--docs/building/building.sgml24
1 files changed, 21 insertions, 3 deletions
diff --git a/docs/building/building.sgml b/docs/building/building.sgml
index 7b150d8e3a..3f47334517 100644
--- a/docs/building/building.sgml
+++ b/docs/building/building.sgml
@@ -7,7 +7,6 @@
<title>Building the Glasgow Functional Programming Tools Suite</title>
<author><othername>The GHC Team</othername></author>
<address><email>glasgow-haskell-&lcub;users,bugs&rcub;@haskell.org</email></address>
-<pubdate>November 2001</pubdate>
<abstract>
<para>The Glasgow fptools suite is a collection of Functional
@@ -3994,8 +3993,10 @@ Hello World!</screen>
<sect3 id="sec-mangler">
<title>The mangler</title>
- <para>The mangler is an evil Perl-script that rearranges the
- assembly code output from gcc to do two main things:</para>
+ <para>The mangler is an evil Perl-script
+ (<filename>ghc/driver/mangler/ghc-asm.lprl</filename>) that
+ rearranges the assembly code output from gcc to do two main
+ things:</para>
<itemizedlist>
<listitem>
@@ -4026,6 +4027,23 @@ Hello World!</screen>
</sect3>
<sect3>
+ <title>The splitter</title>
+
+ <para>The splitter is another evil Perl script
+ (<filename>ghc/driver/split/ghc-split.lprl</filename>). It
+ cooperates with the mangler to support object splitting.
+ Object splitting is what happens when the
+ <option>-split-objs</option> option is passed to GHC: the
+ object file is split into many smaller objects. This feature
+ is used when building libraries, so that a program statically
+ linked against the library will pull in less of the
+ library.</para>
+
+ <para>The splitter has some platform-specific stuff; take a
+ look and tweak it for your system.</para>
+ </sect3>
+
+ <sect3>
<title>The native code generator</title>
<para>The native code generator isn't essential to getting a