@@ -12,6 +12,8 @@ foundation on which to base production software.
12
12
While end-users _can_ build the platform themselves, it is generally recommended,
13
13
if possible, to use the prebuilt binaries available from https://www.haskell.org/platform/
14
14
15
+ The platform distribution and tooling are more intended instead for those wishing to package a platform installer for use by others.
16
+
15
17
DISTRIBUTION
16
18
------------
17
19
The platform comes in several forms:
@@ -29,7 +31,7 @@ Development usually happens in other branches.
29
31
includes the sources of the packages that make up the platform, and excludes
30
32
some of the ancillary things in the source repo. You can use this to build
31
33
the platform without access to hackage or even an internet connection. You still
32
- need a GHC bindist.
34
+ need a GHC bindist, as well as cabal and stack binaries, either built from source or available from their respective websites .
33
35
34
36
*installer* - For Windows and OS X, the platform is distributed as a standard
35
37
installer for the operating system. It contains a fully built version of the
@@ -73,12 +75,15 @@ installer packages.
73
75
74
76
In either the source repo or unpacked source tarball, simply run this:
75
77
76
- ./platform.sh $PATH_TO_GHC_BINDIST_TARBALL
78
+ ./platform.sh $PATH_TO_GHC_BINDIST_TARBALL $PATH_TO_CABAL_EXECUTABLE $PATH_TO_STACK_EXECUTABLE
77
79
78
80
This will build the hptool itself, and then use that tool to build first the
79
81
platform source tarball, and finally the hermetic build of all the platform
80
82
packages.
81
83
84
+ By default this now builds a "minimal" installer that does not install libraries beyond core. To build a "full" installer
85
+ with a broader range of libraries pre-installed in the global store, pass a "-f" option.
86
+
82
87
If you are building for a Posix like system (Linux, or BSD), then you can add
83
88
the command line option --prefix to specify where, on the target system the
84
89
tree of built things will be placed. It defaults to "/usr/local/haskell". The
0 commit comments