Skip to content
Newer
Older
100644 73 lines (48 sloc) 2.21 KB
c4a3a40 @bos Update the README with pointers to the double-conversion workaround.
authored
1 # Welcome to blaze-textual
3831ef5 @bos Initial commit. Basically a straight drop of aeson code.
authored
2
3 blaze-textual is a fast Haskell library for rendering common Haskell
4 datatypes in text form using the
5 [blaze-builder](http://hackage.haskell.org/package/blaze-builder)
6 library.
7
c4a3a40 @bos Update the README with pointers to the double-conversion workaround.
authored
8 # Important note for users of GHCi and Template Haskell
9
10 To achieve excellent performance for rendering floating point numbers,
11 this package uses the
12 [double-conversion](http://hackage.haskell.org/package/double-conversion)
13 package.
14
15 Unfortunately, due to bugs in GHC, some uses of GHCi and Template
16 Haskell can crash if this package is loaded.
17
18 * [5289: Can't use ghci with a library linked against
19 libstdc++](http://hackage.haskell.org/trac/ghc/ticket/5289) (fixed
20 in GHC 7.2.1).
21
22 * [5386: GHCi crashes with SIGFPE when using double-conversion
23 package](http://hackage.haskell.org/trac/ghc/ticket/5386) (not yet
24 fixed at the time of writing)
25
26 If you are affected by these problems, you should expect the 5289
27 crash to look like this:
28
29 Loading package double-conversion-0.2.0.0 ... can't load .so/.DLL for: stdc++
30
31 The 5386 crash causes GHCi to die with a floating point exception
32 (SIGFPE).
33
34 To work around these bugs, this package includes an alternative,
35 slower, floating point conversion that is written in pure Haskell.
36 Because it is 10 times slower than the double-conversion package, it
37 is not the default.
38
39 To use it, reinstall this package by passing the `native` flag to
40 `cabal`:
41
42 cabal install -fnative
43
44 Afterwards, you will also need to reinstall any downstream packages
45 that depend on this one, e.g. the [aeson JSON
46 library](http://hackage.haskell.org/package/aeson):
47
48 cabal install aeson --reinstall
49
3831ef5 @bos Initial commit. Basically a straight drop of aeson code.
authored
50 # Join in!
51
52 We are happy to receive bug reports, fixes, documentation
53 enhancements, and other improvements.
54
55 Please report bugs via the
6f5ca16 @bos Update mailrank addresses to serpentine
authored
56 [github issue tracker](http://github.com/bos/blaze-textual/issues).
3831ef5 @bos Initial commit. Basically a straight drop of aeson code.
authored
57
6f5ca16 @bos Update mailrank addresses to serpentine
authored
58 Master [git repository](http://github.com/bos/blaze-textual):
3831ef5 @bos Initial commit. Basically a straight drop of aeson code.
authored
59
6f5ca16 @bos Update mailrank addresses to serpentine
authored
60 * `git clone git://github.com/bos/blaze-textual.git`
3831ef5 @bos Initial commit. Basically a straight drop of aeson code.
authored
61
62 There's also a [Mercurial mirror](http://bitbucket.org/bos/blaze-textual):
63
64 * `hg clone http://bitbucket.org/bos/blaze-textual`
65
66 (You can create and contribute changes using either git or Mercurial.)
67
68 Authors
69 -------
70
71 This library is written and maintained by Bryan O'Sullivan,
6f5ca16 @bos Update mailrank addresses to serpentine
authored
72 <bos@serpentine.com>.
Something went wrong with that request. Please try again.