haddock-library-1.8.0: Library exposing some functionality of Haddock.

Copyright(c) Mateusz Kowalczyk 2013-2014
Simon Hengel 2013
LicenseBSD-like
Maintainerhaddock@projects.haskell.org
Stabilityexperimental
Portabilityportable
Safe HaskellNone
LanguageHaskell2010

Documentation.Haddock.Parser

Description

Parser used for Haddock comments. For external users of this library, the most commonly used combination of functions is going to be

toRegular . _doc . parseParas
Synopsis

Documentation

parseString :: String -> DocH mod Identifier Source #

Variant of parseText for String instead of Text

parseParas Source #

Arguments

:: Maybe Package 
-> String

String to parse

-> MetaDoc mod Identifier 

Main entry point to the parser. Appends the newline character to the input string.

overIdentifier :: (Namespace -> String -> Maybe a) -> DocH mod Identifier -> DocH mod a Source #

Maps over DocIdentifiers over String with potentially failing conversion using user-supplied function. If the conversion fails, the identifier is deemed to not be valid and is treated as a regular string.

toRegular :: DocH mod Identifier -> DocH mod String Source #

Drops the quotes/backticks around all identifiers, as if they were valid but still Strings.

data Identifier Source #

Identifier string surrounded with namespace, opening, and closing quotes/backticks.