ghc-9.2.0.20210331: The GHC API
Safe HaskellSafe-Inferred
LanguageHaskell2010

GHC.Hs.Doc

Synopsis

Documentation

data HsDocString Source #

Haskell Documentation String

Internally this is a UTF8-Encoded ByteString.

Instances

Instances details
Data HsDocString # 
Instance details

Defined in GHC.Hs.Doc

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> HsDocString -> c HsDocString Source #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c HsDocString Source #

toConstr :: HsDocString -> Constr Source #

dataTypeOf :: HsDocString -> DataType Source #

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c HsDocString) Source #

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c HsDocString) Source #

gmapT :: (forall b. Data b => b -> b) -> HsDocString -> HsDocString Source #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> HsDocString -> r Source #

gmapQr :: forall r r'. (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> HsDocString -> r Source #

gmapQ :: (forall d. Data d => d -> u) -> HsDocString -> [u] Source #

gmapQi :: Int -> (forall d. Data d => d -> u) -> HsDocString -> u Source #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> HsDocString -> m HsDocString Source #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> HsDocString -> m HsDocString Source #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> HsDocString -> m HsDocString Source #

Show HsDocString # 
Instance details

Defined in GHC.Hs.Doc

Binary HsDocString # 
Instance details

Defined in GHC.Hs.Doc

Outputable HsDocString # 
Instance details

Defined in GHC.Hs.Doc

Methods

ppr :: HsDocString -> SDoc Source #

Eq HsDocString # 
Instance details

Defined in GHC.Hs.Doc

type LHsDocString = Located HsDocString Source #

Located Haskell Documentation String

hsDocStringToByteString :: HsDocString -> ByteString Source #

Return the contents of a HsDocString as a UTF8-encoded ByteString.

appendDocs :: HsDocString -> HsDocString -> HsDocString Source #

Join two docstrings.

Non-empty docstrings are joined with two newlines in between, resulting in separate paragraphs.

concatDocs :: [HsDocString] -> Maybe HsDocString Source #

Concat docstrings with two newlines in between.

Empty docstrings are skipped.

If all inputs are empty, Nothing is returned.

newtype DeclDocMap Source #

Docs for declarations: functions, data types, instances, methods etc.

Constructors

DeclDocMap (Map Name HsDocString) 

Instances

Instances details
Binary DeclDocMap # 
Instance details

Defined in GHC.Hs.Doc

Outputable DeclDocMap # 
Instance details

Defined in GHC.Hs.Doc

Methods

ppr :: DeclDocMap -> SDoc Source #

newtype ArgDocMap Source #

Docs for arguments. E.g. function arguments, method arguments.

Constructors

ArgDocMap (Map Name (IntMap HsDocString)) 

Instances

Instances details
Binary ArgDocMap # 
Instance details

Defined in GHC.Hs.Doc

Outputable ArgDocMap # 
Instance details

Defined in GHC.Hs.Doc

Methods

ppr :: ArgDocMap -> SDoc Source #

data ExtractedTHDocs Source #

Maps of docs that were added via Template Haskell's putDoc.

Constructors

ExtractedTHDocs 

Fields