summaryrefslogtreecommitdiff
path: root/compiler/GHC/Hs
diff options
context:
space:
mode:
authorZubin Duggal <zubin.duggal@gmail.com>2022-03-02 14:21:58 +0530
committerMarge Bot <ben+marge-bot@smart-cactus.org>2022-03-29 13:07:22 -0400
commit789add55e0f5648981ffba77135b2a525369bf79 (patch)
tree0ada054d9b11af3c650a53f7b076db1cfb147d64 /compiler/GHC/Hs
parent2c12627caba908153bf0af92459d08e399aa8aad (diff)
downloadhaskell-789add55e0f5648981ffba77135b2a525369bf79.tar.gz
Fix all invalid haddock comments in the compiler
Fixes #20935 and #20924
Diffstat (limited to 'compiler/GHC/Hs')
-rw-r--r--compiler/GHC/Hs/Binds.hs39
-rw-r--r--compiler/GHC/Hs/Pat.hs2
2 files changed, 21 insertions, 20 deletions
diff --git a/compiler/GHC/Hs/Binds.hs b/compiler/GHC/Hs/Binds.hs
index d67d1c4312..3a22863537 100644
--- a/compiler/GHC/Hs/Binds.hs
+++ b/compiler/GHC/Hs/Binds.hs
@@ -91,27 +91,28 @@ type instance XXValBindsLR (GhcPass pL) pR
type instance XFunBind (GhcPass pL) GhcPs = NoExtField
type instance XFunBind (GhcPass pL) GhcRn = NameSet
- -- ^ After the renamer (but before the type-checker), the FunBind
- -- extension field contains the locally-bound free variables of this
- -- defn. See Note [Bind free vars]
+-- ^ After the renamer (but before the type-checker), the FunBind
+-- extension field contains the locally-bound free variables of this
+-- defn. See Note [Bind free vars]
+
type instance XFunBind (GhcPass pL) GhcTc = HsWrapper
- -- ^ After the type-checker, the FunBind extension field contains a
- -- coercion from the type of the MatchGroup to the type of the Id.
- -- Example:
- --
- -- @
- -- f :: Int -> forall a. a -> a
- -- f x y = y
- -- @
- --
- -- Then the MatchGroup will have type (Int -> a' -> a')
- -- (with a free type variable a'). The coercion will take
- -- a CoreExpr of this type and convert it to a CoreExpr of
- -- type Int -> forall a'. a' -> a'
- -- Notice that the coercion captures the free a'.
+-- ^ After the type-checker, the FunBind extension field contains a
+-- coercion from the type of the MatchGroup to the type of the Id.
+-- Example:
+--
+-- @
+-- f :: Int -> forall a. a -> a
+-- f x y = y
+-- @
+--
+-- Then the MatchGroup will have type (Int -> a' -> a')
+-- (with a free type variable a'). The coercion will take
+-- a CoreExpr of this type and convert it to a CoreExpr of
+-- type Int -> forall a'. a' -> a'
+-- Notice that the coercion captures the free a'.
type instance XPatBind GhcPs (GhcPass pR) = EpAnn [AddEpAnn]
-type instance XPatBind GhcRn (GhcPass pR) = NameSet -- ^ See Note [Bind free vars]
+type instance XPatBind GhcRn (GhcPass pR) = NameSet -- See Note [Bind free vars]
type instance XPatBind GhcTc (GhcPass pR) = Type -- Type of the GRHSs
type instance XVarBind (GhcPass pL) (GhcPass pR) = NoExtField
@@ -122,7 +123,7 @@ type instance XXHsBindsLR GhcRn pR = DataConCantHappen
type instance XXHsBindsLR GhcTc pR = AbsBinds
type instance XPSB (GhcPass idL) GhcPs = EpAnn [AddEpAnn]
-type instance XPSB (GhcPass idL) GhcRn = NameSet -- ^ Post renaming, FVs. See Note [Bind free vars]
+type instance XPSB (GhcPass idL) GhcRn = NameSet -- Post renaming, FVs. See Note [Bind free vars]
type instance XPSB (GhcPass idL) GhcTc = NameSet
type instance XXPatSynBind (GhcPass idL) (GhcPass idR) = DataConCantHappen
diff --git a/compiler/GHC/Hs/Pat.hs b/compiler/GHC/Hs/Pat.hs
index c81018da40..9ca56e3290 100644
--- a/compiler/GHC/Hs/Pat.hs
+++ b/compiler/GHC/Hs/Pat.hs
@@ -232,7 +232,7 @@ data ConPatTc
, -- | Bindings involving those dictionaries
cpt_binds :: TcEvBinds
- , -- ^ Extra wrapper to pass to the matcher
+ , -- | Extra wrapper to pass to the matcher
-- Only relevant for pattern-synonyms;
-- ignored for data cons
cpt_wrap :: HsWrapper