User's guide: .a files can be 2-2.5x larger with -split-objs
authorThomas Miedema <thomasmiedema@gmail.com>
Mon, 6 Apr 2015 09:51:34 +0000 (11:51 +0200)
committerThomas Miedema <thomasmiedema@gmail.com>
Mon, 6 Apr 2015 09:51:38 +0000 (11:51 +0200)
And remove warning. This feature is available through cabal even.

Reviewed By: austin

Differential Revision: https://phabricator.haskell.org/D801

docs/users_guide/phases.xml

index b05de99..8994ffe 100644 (file)
@@ -893,10 +893,10 @@ $ cat foo.hspp</screen>
           executables linked against the library are smaller as they only
           link against the object files that they need. However, assembling
           all the sections separately is expensive, so this is slower than
-          compiling normally.
-          We use this feature for building GHC's libraries
-          (warning: don't use it unless you know what you're
-          doing!).</para>
+          compiling normally. Additionally, the size of the library itself
+          (the <literal>.a</literal> file) can be a factor of 2 to 2.5
+          larger.
+          We use this feature for building GHC's libraries.</para>
         </listitem>
       </varlistentry>