[commit: ghc] master: User's guide: .a files can be 2-2.5x larger with -split-objs (fef4948)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/ghc

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/fef4948f172b66eaf8db520b381dd4a8237b5644/ghc

>---------------------------------------------------------------

commit fef4948f172b66eaf8db520b381dd4a8237b5644
Author: Thomas Miedema <thomasmiedema at gmail.com>
Date:   Mon Apr 6 11:51:34 2015 +0200

    User's guide: .a files can be 2-2.5x larger with -split-objs
    
    And remove warning. This feature is available through cabal even.
    
    Reviewed By: austin
    
    Differential Revision: https://phabricator.haskell.org/D801


>---------------------------------------------------------------

fef4948f172b66eaf8db520b381dd4a8237b5644
 docs/users_guide/phases.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/users_guide/phases.xml b/docs/users_guide/phases.xml
index b05de99..8994ffe 100644
--- a/docs/users_guide/phases.xml
+++ b/docs/users_guide/phases.xml
@@ -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>