X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fphases.xml;h=40663456939a7aa2f8a70af47c6591b1507e49de;hb=bb5e030c18910d1a1833803d5a1a5edf48ca4e8a;hp=e5bac79dfd7dd1d7d1a7992b01726dc411956964;hpb=c5a97ea01a810333608ef1e26f5cb5422dd25928;p=ghc-hetmet.git diff --git a/docs/users_guide/phases.xml b/docs/users_guide/phases.xml index e5bac79..4066345 100644 --- a/docs/users_guide/phases.xml +++ b/docs/users_guide/phases.xml @@ -725,7 +725,12 @@ $ cat foo.hspp Tell the linker to split the single object file that would normally be generated into multiple object files, one per top-level Haskell function or type in the module. - We use this feature for building GHC's libraries libraries + This only makes sense for libraries, where it means that + 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!). @@ -783,7 +788,7 @@ $ cat foo.hspp ghc is not clever enough to figure out that they both need recompiling. You can force recompilation by removing the object file, or by using the - flag. + flag. @@ -859,7 +864,7 @@ $ cat foo.hspp machine. See . The ability to make a foreign call that does not - block all other Haskell threads.. + block all other Haskell threads. The ability to invoke foreign exported Haskell functions from multiple OS threads.