Bryan O'Sullivan avatar Bryan O'Sullivan committed 9a526b0


Comments (0)

Files changed (1)

 # Important note for users of GHCi and Template Haskell
 To achieve excellent performance for rendering floating point numbers,
-this package uses the
+this package can optionally use the
 Unfortunately, due to bugs in GHC, some uses of GHCi and Template
-Haskell can crash if this package is loaded.
+Haskell can crash if the double-conversion package is used.  As a
+result, this package's use of double-conversion is disabled by default.
 * [5289: Can't use ghci with a library linked against
   libstdc++]( (fixed
   package]( (not yet
   fixed at the time of writing)
-If you are affected by these problems, you should expect the 5289
-crash to look like this:
+If you enable use of double-conversion and are affected by these
+problems, you should expect the 5289 crash to look like this:
     Loading package double-conversion- ... can't load .so/.DLL for: stdc++
 To work around these bugs, this package includes an alternative,
 slower, floating point conversion that is written in pure Haskell.
-Because it is 10 times slower than the double-conversion package, it
-is not the default.
+Although it is 10 times slower than the double-conversion package, it
+is the default because it does not crash.
-To use it, reinstall this package by passing the `native` flag to
+If you don't use GHCi or Template Haskell, and you want to force
+the use of double-conversion, you can reinstall this package by
+disabling the `native` flag with `cabal`:
-    cabal install -fnative
+    cabal install -f-native --reinstall
 Afterwards, you will also need to reinstall any downstream packages
 that depend on this one, e.g. the [aeson JSON
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.