# Important note for users of GHCi and Template Haskell
To achieve excellent performance for rendering floating point numbers,
+this package 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
package](http://hackage.haskell.org/trac/ghc/ticket/5386) (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-0.2.0.0 ... 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
+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 -f-native
Afterwards, you will also need to reinstall any downstream packages
that depend on this one, e.g. the [aeson JSON