Merge pull request #8139 from mpilgrem/runghcDocs

Clarify `runhaskell` in Cabal's guide
haskell · May 14, 2022 · a877a97 · a877a97
2 parents d2bff20 + f51b4a2
commit a877a97
Showing 1 changed file with 6 additions and 4 deletions.
diff --git a/doc/setup-commands.rst b/doc/setup-commands.rst
@@ -3,15 +3,17 @@ Setup.hs Commands
 
 .. highlight:: console
 
-The low-level Cabal interface is implemented using ``Setup.hs`` scripts.
-You should prefer using higher level interface provided by
-nix-style builds.
+GHC provides the commands ``runhaskell`` and ``runghc`` (they are equivalent)
+to allow you to run Haskell programs without first having to compile them
+(scripts). The low-level Cabal interface is implemented using ``Setup.hs``
+scripts. You should prefer using higher level interface provided by nix-style
+builds.
 
 ::
 
     $ runhaskell Setup.hs [command] [option...]
 
-For the summary of the command syntax, run:
+For the summary of the ``Setup.hs`` script's command syntax, run:
 
 ::