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

[git at git.haskell.org]

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

On branch  : ghc-7.10
Link       : http://ghc.haskell.org/trac/ghc/changeset/7ffd7f45f9b9471a7deb8f5d4ec54e5ba5da3779/ghc

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

commit 7ffd7f45f9b9471a7deb8f5d4ec54e5ba5da3779
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
    
    (cherry picked from commit fef4948f172b66eaf8db520b381dd4a8237b5644)


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

7ffd7f45f9b9471a7deb8f5d4ec54e5ba5da3779
 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>