X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;ds=sidebyside;f=docs%2Fusers_guide%2Fphases.xml;h=dfa10a5b11fe4dc86e8047ac0fc442a7917f6dd6;hb=6cec61d14a324285dbb8ce73d4c7215f1f8d6766;hp=adaf370cfb6b26176ec818bcffd4ed138141262d;hpb=a54f113bf5c92a170f6dd4cebf07d02ba52c8096;p=ghc-hetmet.git
diff --git a/docs/users_guide/phases.xml b/docs/users_guide/phases.xml
index adaf370..dfa10a5 100644
--- a/docs/users_guide/phases.xml
+++ b/docs/users_guide/phases.xml
@@ -71,17 +71,6 @@
- cmd
-
-
-
- Use cmd as the
- mangler.
-
-
-
-
- cmd
@@ -543,21 +532,8 @@ $ cat foo.hspp
Use GHC's native code generator rather than
- compiling via C. This will compile faster (up to twice as
- fast), but may produce code that is slightly slower than
- compiling via C. is the default.
-
-
-
-
-
-
-
-
-
- Compile via C instead of using the native code
- generator. This is the default on architectures for which GHC
- doesn't have a native code generator.
+ compiling via LLVM.
+ is the default.
@@ -569,8 +545,8 @@ $ cat foo.hspp
Compile via LLVM instead of using the native code
generator. This will generally take slightly longer than the
- native code generator to compile but quicker than compiling
- via C. Produced code is generally the same speed or faster
+ native code generator to compile.
+ Produced code is generally the same speed or faster
than the other two code generators. Compiling via LLVM
requires LLVM version 2.7 or later to be on the path.
@@ -1000,31 +976,53 @@ $ cat foo.hspp
on the command line or via the GHCRTS environment variable.
There are three possibilities:
-
-
- disables all processing of RTS options.
- Passing anywhere on the command line causes the program
- to abort with an error message. Setting the GHCRTS environment
- variable causes a warning is printed before the main Haskell program runs.
-
-
- enables only the "safe" RTS options on the
- command line. (Currently only and .)
- Any other RTS options on the command line abort the program with an error
- message. All RTS options in the GHCRTS environment variable are
- processed as normal. This is the default setting.
-
-
- (or just ) enables
- all RTS option processing, both on the command line and
- through the GHCRTS environment variable.
-
-
+
+
+
+
+
+ Disable all processing of RTS options.
+ If appears anywhere on the command
+ line, then the program will abort with an error message.
+ If the GHCRTS environment variable is
+ set, then the program will emit a warning message,
+ GHCRTS will be ignored, and the program
+ will run as normal.
+
+
+
+
+
+
+ [this is the default setting] Enable
+ only the "safe" RTS options: (Currently
+ only
+ and .) Any other RTS options
+ on the command line or in the GHCRTS
+ environment variable causes the program with to abort
+ with an error message.
+
+
+
+
+ , or
+ just
+
+
+ Enable all RTS option
+ processing, both on the command line and through
+ the GHCRTS environment variable.
+
+
+
+
- Prior to GHC 7.0, the default was to process all RTS options. However, since
- RTS options can be used to write logging data to arbitrary files under the
- security context of the running program, there is a potential security problem.
- For this reason, GHC 7.0 defaults to .
+ In GHC 6.12.3 and earlier, the default was to process all
+ RTS options. However, since RTS options can be used to
+ write logging data to arbitrary files under the security
+ context of the running program, there is a potential
+ security problem. For this reason, GHC 7.0.1 and later
+ default to .
@@ -1038,7 +1036,7 @@ $ cat foo.hspp
This option allows you to set the default RTS options at link-time. For example,
sets the default heap size to 128MB.
- This will now always be the default heap size, unless the user overrides it.
+ This will always be the default heap size for this program, unless the user overrides it.
(Depending on the setting of the option, the user might
not have the ability to change RTS options at run-time, in which case
would be the only way to set