@@ -1,6 +1,20 @@
1−# Compilation Options
1+# GHC Haskell
4+GHC versions 8.0 onwards are supported by streamly per se. However, note
5+that some packages we depend on (e.g. `network`) support only last three
8+Use GHC 8.8 for best performance. Benchmarks show that GHC 8.8 has
9+significantly better performance than GHC 8.6 in many cases.
11+GHC 8.2.2 may hog memory and hang when building certain applications using
12+streamly (particularly the benchmark programs in the streamly package).
13+Therefore, we recommend avoiding using the GHC version 8.2.x.
15+## Compilation Options
3−## Absolute Minimum
17+### Absolute Minimum
5At the very least `-O -fdicts-strict` compilation options are
19At the very least `-O -fdicts-strict` compilation options are
6required. If these options are not used, the program may exhibit memory
20required. If these options are not used, the program may exhibit memory
@@ -11,7 +25,7 @@ optimization option, is known to hog memory:
11main = S.drain $ S.concatMap S.fromList $ S.repeat []
25main = S.drain $ S.concatMap S.fromList $ S.repeat []
14−## Recommended Options
28+### Recommended Options
16Use the following GHC options:
30Use the following GHC options:
@@ -28,7 +42,7 @@ value or remove that option.
29See [Explanation](#explanation) for details about these flags.
43See [Explanation](#explanation) for details about these flags.
31−## Using Fusion Plugin
45+### Using Fusion Plugin
33In many cases
47In many cases
34[fusion-plugin](https://hackage.haskell.org/package/fusion-plugin) can
48[fusion-plugin](https://hackage.haskell.org/package/fusion-plugin) can
@@ -44,7 +58,7 @@ package works only for GHC >= 8.6.
44 -fplugin=Fusion.Plugin
58 -fplugin=Fusion.Plugin
47−## Explanation
61+### Explanation
49* `-fdicts-strict` is needed to avoid [a GHC
63* `-fdicts-strict` is needed to avoid [a GHC
50issue](https://gitlab.haskell.org/ghc/ghc/issues/17745) leading to
64issue](https://gitlab.haskell.org/ghc/ghc/issues/17745) leading to
@@ -64,7 +78,7 @@ bindings and therefore enabling case-of-case optimization. In some
64cases, especially in some file IO benchmarks, it can make a difference of
78cases, especially in some file IO benchmarks, it can make a difference of
655-10x better performance.
795-10x better performance.
67−# Multi-core Parallelism
81+## Multi-core Parallelism
69Concurrency without a threaded runtime may be a bit more efficient. Do not use
83Concurrency without a threaded runtime may be a bit more efficient. Do not use
70threaded runtime unless you really need multi-core parallelism. To get
84threaded runtime unless you really need multi-core parallelism. To get
@@ -72,14 +86,26 @@ multi-core parallelism use the following GHC options:
73 `-threaded -with-rtsopts "-N"`
87 `-threaded -with-rtsopts "-N"`
75−# Compiler Versions
89+# Platform Specific
77−Use GHC 8.8 for best performance. Benchmarks show that GHC 8.8 has
91+Streamly supports Linux, macOS and Windows operating systems. Some
78−significantly better performance than GHC 8.6 in many cases.
92+modules and functionality may depend on specific OS kernel features.
93+Features/modules may get disabled if the kernel/OS does not support it.
80−GHC 8.2.2 may hog memory and hang when building certain application using
95+## Linux
81−streamly (particularly the benchmark programs in the streamly package).
96+
82−Therefore we recommend avoiding using the GHC version 8.2.x.
97+* File system events notification module is supported only for kernel versions
102+* File system events notification module requires macOS 10.7+ with
103+ Xcode/macOS SDK installed (depends on `Cocoa` framework). However, we only
104+ test on latest three versions of the OS.
108+* File system event notification module is not yet available for Windows.
84# Performance Optimizations
110# Performance Optimizations