Action to perform in backend compilation

Status of a module in incremental compilation

Write interface files

Compile to hard-code.

Do the recompilation avoidance checks for both one-shot and --make modes This function is the *only* place in the compiler where we decide whether to recompile a module or not!

parse a file, returning the abstract syntax

Rename and typecheck a module, additionally returning the renamed syntax

Do Typechecking without throwing SourceError exception with -Werror

Convert a typechecked module to Core

Make a ModDetails from the results of typechecking. Used when typechecking only, as opposed to full compilation.

Run Core2Core simplifier. The list of String is a list of (Core) plugin module names added via TH (cf addCorePlugin).

Check that a module is safe to import.

We return True to indicate the import is safe and False otherwise although in the False case an exception may be thrown first.

Return if a module is trusted and the pkgs it depends on to be trusted.

Rename some import declarations

Lookup things in the compiler's environment

Compile a stmt all the way to an HValue, but don't run it

We return Nothing to indicate an empty statement (or comment only), not a parse error.

Compile a stmt all the way to an HValue, but don't run it

We return Nothing to indicate an empty statement (or comment only), not a parse error.

Compile a decls

Compile a decls

Typecheck an expression (but don't run it)

How should we infer a type? See Note [TcRnExprMode]

Find the kind of a type, after generalisation

Run Core2Core simplifier. The list of String is a list of (Core) plugin module names added via TH (cf addCorePlugin).

Deal with errors and warnings returned by a compilation step

In order to reduce dependencies to other parts of the compiler, functions outside the "main" parts of GHC return warnings and errors as a parameter and signal success via by wrapping the result in a Maybe type. This function logs the returned warnings and propagates errors as exceptions (of type SourceError).

This function assumes the following invariants:

1. If the second result indicates success (is of the form 'Just x'), there must be no error messages in the first result.
2. If there are no error messages, but the second result indicates failure there should be warnings in the first result. That is, if the action failed, it must have been due to the warnings (i.e., -Werror).

Load the given static-pointer table entries into the interpreter. See Note [Grand plan for static forms] in GHC.Iface.Tidy.StaticPtrTable.