Improve doc of DocName

1 files changed, 3 insertions, 2 deletions

diff --git a/src/Haddock/Types.hs b/src/Haddock/Types.hs
index b4853379..f3b35540 100644
--- a/src/Haddock/Types.hs
+++ b/src/Haddock/Types.hs
@@ -52,8 +52,9 @@ noDocForDecl = (Nothing, Map.empty)
 type DeclInfo = (Decl, DocForDecl Name, [(Name, DocForDecl Name)])
 
 
--- | A 'DocName' is an identifier that may be documented. The 'Module'
--- component specifies the place which we want to link to in the documentation.
+-- | A 'DocName' identifies something that may have documentation. The 'Module'
+-- argument specifies where we prefer to link to in the documentation. It may
+-- be different than the original module.
 data DocName = Documented Name Module | Undocumented Name
   deriving Eq