[[project @ 2004-06-17 13:35:33 by simonmar]
simonmar**20040617133533
 Mention the splitter in the section on porting.
] {
hunk ./docs/building/building.sgml 10
-<pubdate>November 2001</pubdate>
hunk ./docs/building/building.sgml 3996
-	<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>
hunk ./docs/building/building.sgml 4028
+
+      <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>
}