diff --git a/haddock-api/src/Haddock/Interface/ParseModuleHeader.hs b/haddock-api/src/Haddock/Interface/ParseModuleHeader.hs
index e452852296e117ca7f309eff2c606194e9dce394..6ac2f186028b7b401b429644bfa298f3cd899866 100644
--- a/haddock-api/src/Haddock/Interface/ParseModuleHeader.hs
+++ b/haddock-api/src/Haddock/Interface/ParseModuleHeader.hs
@@ -86,6 +86,13 @@ parseModuleHeader dflags pkgName str0 =
 -- the value will be "this is a .. description" and the rest will begin
 -- at "The module comment".
 
+-- | 'C' is a 'Char' carrying its column.
+--
+-- This let us make an indentation-aware parser, as we know current indentation.
+-- by looking at the next character in the stream ('curInd').
+--
+-- Thus we can munch all spaces but only not-spaces which are indented.
+--
 data C = C {-# UNPACK #-} !Int Char
 
 newtype P a = P { unP :: [C] -> Maybe ([C], a) }