blob: 8d1a0865998fd4b4b4287db01b5df466bb73ddf6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
.. _runghc:
Using runghc
============
.. index::
single: runghc
``runghc`` allows you to run Haskell programs without first having to
compile them.
.. _runghc-introduction:
Usage
-----
The ``runghc`` command-line looks like:
.. code-block:: none
runghc [runghc flags] [GHC flags] module [program args]
Any flags not recognized by runghc are automatically passed to GHC.
If a flag is recognized by both runghc and GHC but you want to
pass it to GHC then you can place it after a ``--`` separator. Flags after the
separator are treated as GHC only flags. Alternatively you can use the runghc
option ``--ghc-arg=<arg>`` to pass any flag or argument directly to GHC.
``module`` could be a Haskell source filename with or without the extension.
If for some reason the filename starts with a ``-`` you can use a second
``--`` to indicate the end of flags. Anything following a second
``--`` will be considered a program file or module name followed by its
arguments. For example:
- ``runghc -- -- -hello.hs``
runghc flags
------------
runghc accepts the following flags:
- ``-f /path/to/ghc``: tell runghc the path of GHC executable to use to run the program. By default runghc will search for GHC in the directories in the system search path.
- ``--ghc-arg=<arg>``: Pass an option or argument to GHC
- ``--help``: print usage information.
- ``--version``: print version information.
GHC Flags
---------
As discussed earlier, use ``--`` or ``--ghc-arg=<arg>`` to disambiguate GHC
flags when needed. For example, ``-f`` is recognized by runghc, therefore to
pass ``-fliberate-case`` to GHC use any of the following:
- ``runghc -- -fliberate-case``
- ``runghc --ghc-arg=-fliberate-case``
Note that any non-flag arguments are never passed to GHC. An unused non-flag
argument will be considered as the name of the program to run. If a GHC flag
takes an argument use ``--ghc-arg=<arg>`` to pass the argument to GHC.
For example, if you want to pass ``-package foo`` to GHC use any of the
following:
- ``runghc -package --ghc-arg=foo Main.hs``
- ``runghc --ghc-arg=-package --ghc-arg=foo Main.hs``
|
