leaky-0.1.0.0: README

This leaky mini-project provides a Haskell program exhibiting classic
space leak behaviour.  It leaks in GHC 7.8.3 (and lower), even when
compiled -O2.


leaky-min-cppd.hs  - a tiny Haskell program that leaks in GHC 7.8.3 -O2
leaky-min.hs       - like leaky-min-cppd.hs, with some alternatives
leaky.hs           - a similar but elaborated example, with .cabal flags


In addition to the source files, more information can be found
at the http://www.fremissant.net/leaky project homepage,
including discussion links (cafe, reddit, etc.).

There may also be a community-editable version at the
https://www.haskell.org/haskellwiki/Space_Leak wiki page.


Configure and build in place:

 >  cabal get leaky                     # download and unpack leaky
 >  cd leaky-0.1.0.0                    # (or whatever version it is)
 >  cabal configure && cabal build      # build in place

Run by supplying a seed for the random number generator:

 >  ./dist/build/leaky/leaky 123


Or you may prefer to build in a sandbox:

 >  cabal get leaky
 >  cd leaky-0.1.0.0
 >  cabal sandbox init
 >  cabal install --only-dependencies
 >  cabal install

And to run:

 >  ./.cabal-sandbox/bin/leaky 123


NOTE: If you don't build with Cabal, you will need to
put options from leaky.cabal into your command line.

Anyway, seqaid uses both the Cabal library and
the cabal executable, meaning that only FORCING_STRATEGY
from 0 through 3 (refer to leaky.cabal) can work
wtihout the presence of the leaky.cabal file.


The output is explained at http://www.fremissant.net/leaky/output.html
or in the corresponding local document ./HTML/output.html.


The FORCING_STRATEGY CPP macro currently controls the leak and plug
variants, which are best set by editing the leaky.cabal file,reconfiguring
and rebuilding (or reinstalling in the case of a sandbox).  See the
included file rough-fs-twiddling-guide.txt for more details.

There are also some constants in leaky.hs you may like to adjust.


If you have a version of the compiler that does not leak for
the default variant of leaky, please let me know at rasfar@gmail.com,
on in the haskell-cafe thread (http://) announcing leaky.

Also, any discussion whatsoever is most welcome.


Sept. 20, 2014
Andrew Seniuk
rasfar on #haskell