Fix Trac #1814 (staging interaction in Template Haskell and GHCi), and add comments

An Id bound by GHCi from a previous Stmt is Global but Internal, and
I'd forgotten that, leading to unnecessary restrictions when using TH
and GHCi together.

This patch fixes the problem and adds lots of explanatory comments (which
is where most of the extra lines come from).

Improve error messages

Improve manual entry for binding lexically scoped type variables in pattern signatures

Remove trailing spaces from programlisting lines

Remove unhelpful sentence (see Trac #1832)

Merge to 6.8 branch

fix stage 1 compilation

warning police

GHC API: add checkAndLoadModule
Does what the name suggests: it performs the function of both
checkModule and load on that module, avoiding the need to process each
module twice when checking a batch of modules.  This will make Haddock
and ghctags much faster.

Along with this is the beginnings of a refactoring of the HscMain
interface.  HscMain now exports functions for separately running the
parser, typechecher, and generating ModIface and ModDetails.
Eventually the plan is to complete this interface and use it to
replace the existing one.

update to use latest changes to the GHC API (works much quicker now)

warning police

Various improvements
 - take the GHC topdir as a runtime argument
 - deal with files one at a time (fix space leak)

build ghctags-inplace

updates to ghctags code

eliminate a bit of duplication

catch up with changes to checkModule

reorder the imports

add $(GHCTAGS)

follow changes in HsRecFields

merged patches relating to GhcTags from #946

* accomodate changes in the GHC API
* refactoring for more readable source code
* if the whole group fails, try one file at a time
* desperate attempts to handle the GHC build

Rules to create TAGS using ghctags

request for documentation of a new argument

new README file for utils/ghctags

proper HC entry for bootstrapping in Makefile

first cut at missing case for ids defined in pattern

change representation of FoundThing
refactored FoundThing to use GHC's native representation of
source-code locations and to carry the module name so that the TAGS
file can contain a qualified name as well as the unqualified name

get names of data constructors

do notation for the Maybe monad

load all files at once and compute tags for all

tell GHC not to generate code (thanks Simon M)

cover more cases; take GHC options on command line
Bit of a dog's breakfast here:
  * generate tags for more cases in the syntax
  * accept -package ghc and other args on command line
  * scrub away old code for snaffling thru text

initial, very incomplete tags generator
The ultimate goal is to replace hasktags with
a tags generator based on GHC-as-a-library.
This file is a very incomplete first cut.

Inline implication constraints

This patch fixes Trac #1643, where Lennart found that GHC was generating
code with unnecessary dictionaries.  The reason was that we were getting
an implication constraint floated out of an INLINE (actually an instance
decl), and the implication constraint therefore wasn't inlined even
though it was used only once (but inside the INLINE).  Thus we were
getting:

ic = \d -> <stuff>
foo = _inline_me_ (...ic...)

Then 'foo' gets inlined in lots of places, but 'ic' now looks a bit
big.

But implication constraints should *always* be inlined; they are just
artefacts of the constraint simplifier.

This patch solves the problem, by adding a WpInline form to the HsWrap
type.

Comment warning about transparent newtypes

Wibble to earlier case-merge fix

This fix avoids a bogus WARN in SimplEnv.substId

Improve pretty-printing of Core slightly (avoid indenting let bodies)

Fix an old but subtle bug in the Simplifier

I got a Core Lint failure when compiling System.Win32.Info in the
Win32 package.  It was very delicate: adding or removing a function
definition elsewhere in the module (unrelated to the error) made the
error go away.

Happily, I found it.  In SimplUtils.prepareDefault I was comparing an
InId with an OutId.  We were getting a spurious hit, and hence doing
a bogus CaseMerge.

This bug has been lurking ever since I re-factored the way that case
expressions were simplified, about 6 months ago!

Make CoreLint give a more informative error message

Comments about TH staging

Fix freeHaskellFunctionPtr for Darwin/i386

MERGED: Set interfacedir (using $topdir, not $httptopdir)
Mon Oct 29 10:48:25 PDT 2007  Ian Lynagh <igloo@earth.li>

Teach ghc-pkg about $httptopdir

MERGED: installPackage needs to treat $httptopdir the same as $topdir
Sun Oct 28 06:45:34 PDT 2007  Ian Lynagh <igloo@earth.li>

MERGED: Define and use $httptopdir for the haddock docs locations
Sun Oct 28 05:35:52 PDT 2007  Ian Lynagh <igloo@earth.li>

We need to copy .buildinfo files into the bindists

(>>>) now comes from GHC.Desugar

Refactor error recovery slightly

Mostly this patch is refacoring, but it also avoids post-tc zonking if
the typechecker found errors.  This is good because otherwise with
DEBUG you can get the "Inventing strangely-kinded TyCon" warning.

Avoid Haddock bug #1821

Update error message to mention -XPatternSignatures instead of -fglasgow-exts

Rejig the error messages a bit; fixes a minor bug

The type checker was only reporting the first message if an equality
failed to match.  This patch does a bit of refactoring and fixes the
bug, which was in the bogus use of eqInstMisMatch
in tcSimplify.report_no_instances.b

This is really a bug in 6.8 too, so this would be good to merge across
to the 6.8 branch.

Refactor Haddock options

This patch renames the DOC_OPTIONS pragma to OPTIONS_HADDOCK. It also
adds "-- # ..."-style Haddock option pragmas, for compatibility with
code that use them.

Another change is that both of these two pragmas behave like
OPTIONS_GHC, i.e. they are only allowed at the top of the module, they
are ignored everywhere else and they are stored in the dynflags. There is
no longer any Haddock options in HsSyn.

Please merge this to the 6.8.2 branch when 6.8.1 is out, if appropriate.

clean ghci-inplace

clean Haddock droppings

Fix warning in OSMem for darwin

FIX BUILD: a glitch in the new rules and inlining stuff

Don't re-add the worker info to a binder until completeBind. It's not
needed in its own RHS, and it may be replaced, via the substitution
following postInlineUnconditionally.

(Fixes build of the stage2 compiler which fell over when Coercion.lhs
was being compiled.)

Fix LiberateCase

Merge to STABLE please

Liberate case was being far too gung-ho about what to specialise. This
bug only showed up when a recursive function 'f' has a nested recursive
function 'g', where 'g' calls 'f' (as well as recursively calling 'g').
This exact situation happens in GHC/IO.writeLines.

This patch puts things right; see Note [When to specialise].  Result:
much less code bloat.

Improve error-message output slightly

Improve documentation of orphan instances (thanks to Adrian Hey)

Please push to stable branch

Simon

fix installation of haddock.css and friends

In a pattern binding, a type sig in the pattern cannot bind a type variable

In a pattern binding with a pattern type signature, such as

(Just (x::a)) = e

the pattern type signature cannot bind type variables.  Hence
'a' must be in scope already for the above example to be legal.

This has been the situation for some time, but Dan changed it when
adding view patterns.  This one-line change restores the old behaviour.

Substantial improvement to the interaction of RULES and inlining

(Merge to 6.8 branch after testing.)

There were a number of delicate interactions between RULEs and inlining
in GHC 6.6.  I've wanted to fix this for a long time, and some perf
problems in the 6.8 release candidate finally forced me over the edge!

The issues are documented extensively in OccurAnal, Note [Loop breaking
and RULES], and I won't duplicate them here.  (Many of the extra lines in
OccurAnal are comments!)

This patch resolves Trac bugs #1709, #1794, #1763, I believe.

Add newline in debug print

Explicit pattern match in default case of addTickLHsBind

Generalise the types of mk_FunBind, mk_easy_FunBind, mkVarBind

Fix the build with GHC < 6.4 (foldl1' didn't exist)

Fix the build with GHC < 6.4 (foldl1' didn't exist)

MERGED: We need to install-docs when making the Windows bindist

We need to set _way=* in rts/ both when making and installing bindists
This is a hack, but it means we get libHSrts*.a etc rather than just
libHSrts.a.

Fix a whole heap of speling errrs in the docs

Only build/install the man page if XSLTPROC is defined

install the Cabal docs, and make them show up in a binary distribution

cp => $(CP)

get rid of the html subdirectory under share/doc/ghc/users_guide

Make 'improvement' work properly in TcSimplify

(Please merge this, and the preceding
handful from me to the 6.8 branch.)

This patch fixes a serious problem in the type checker, whereby
TcSimplify was going into a loop because it thought improvement
had taken place, but actually the unificataion was actually deferred.

We thereby fix Trac #1781, #1783, #1795, and #1797!

In fixing this I found what a mess TcSimplify.reduceContext is!
We need to fix this.

The main idea is to replace the "improvement flag" in Avails with
a simpler and more direct test: have any of the mutable type variables
in the (zonked) 'given' or 'irred' constraints been filled in?
This test uses the new function TcMType.isFilledMetaTyVar; the test
itself is towards the end of reduceContext.

I fixed a variety of other infelicities too, and left some ToDos.

An implication constraint can abstract over EqInsts

In an AbsBinds, the 'dicts' can include EqInsts

An AbsBinds abstrats over evidence, and the evidence can be both
Dicts (class constraints, implicit parameters) and EqInsts (equality
constraints).  So we need to
  - use varType rather than idType
  - use instToVar rather than instToId
  - use zonkDictBndr rather than zonkIdBndr in zonking

It actually all worked before, but gave warnings.

More notes

Comments only

Add anyM to IOEnv

Add a note to NOTES

Make compileToCore return the module name and type environment along with bindings

  compileToCore returned just a list of CoreBind, which isn't enough,
since to do anything with the resulting Core code, you probably also
want the type declarations. I left compileToCore as it is, but added a
function compileToCoreModule that returns a complete Core module (with
module name, type environment, and bindings). I'm not sure that
returning the type environment is the best way to represent the type
declarations for the given module, but I don't want to reinvent the
External Core wheel for this.

binary-dist: Makefile-vars needs HADDOCK_DOCS=YES

fix the links in the library documentation index

default to installing runhaskell and hsc2hs again, but provide knobs to turn them off

Adding hpc documentation about sum and map, push to STABLE.

Fixing typo in runtime documentation for hpc, push to stable

Correct a comment

Fix ghc package in bindists; it wasn't adding the depenedency on readline

Fix installing the ghc package .hi files in a bindist

Build the manpage when building, not when installing

Hack to make sure we get all the RTS ways in bindists

Fix installing the documentation in the bindists

-ftype-families -> -XTypeFamilies

FIX #1791: fail with out-of-heap when allocating more than the max heap size in one go
Normally the out-of-heap check is performed post-GC, but there are
cases where we can detect earlier that we definitely have exhausted
the heap size limit.

Fix more warnings

FIX BUILD (on 32-bit platforms): hs_hpc_module() type mismatch

patch from #1782; fixes check-packages target on Solaris

add PIC relocations for x86_64, and use a simpler hack in place of x86_64_high_symbol()
This is Wolfgang Thaller's patch sent to cvs-ghc recently, with extra
commentary by me.  It turns out that this patch is not just a cleanup,
it is also necessary for GHCi to work on x86_64 with shared libraries,
because previously lookupSymbol() was creating jump-table entries for
all symbols looked up that resolved outside 2Gb, whereas Wolfgang's
version only generates jump-table entries for 32-bit symbol references
in object code that we load.

fix creation of ghc-inplace for non-std ways

remove an incorrect assertion

second attempt to fix C compiler warnings with -fhpc
The hs_hpc_module() prototype in RtsExternal.h didn't match its usage:
we were passing StgWord-sized parameters but the prototype used C
ints.  I think it accidentally worked because we only ever passed
constants that got promoted.  The constants unfortunately were
sometimes negative, which caused the C compiler to emit warnings.

I suspect PprC.pprHexVal may be wrong to emit negative constants in
the generated C, but I'm not completely sure.  Anyway, it's easy to
fix this in CgHpc, which is what I've done.