Copyright	(c) 2019-2021 Vaclav Svejcar
License	BSD-3-Clause
Maintainer	vaclav.svejcar@gmail.com
Stability	experimental
Portability	POSIX
Safe Haskell	None
Language	Haskell2010

Headroom.FileSupport.Haskell.Haddock

Description

Support for extracting data from Haddock module headers present in Haskell source code files or templates.

Synopsis

data HaddockModuleHeader = HaddockModuleHeader {
- hmhCopyright :: Maybe Text
- hmhLicense :: Maybe Text
- hmhMaintainer :: Maybe Text
- hmhPortability :: Maybe Text
- hmhStability :: Maybe Text
- hmhShortDesc :: Maybe Text
- hmhLongDesc :: Maybe Text
}
extractOffsets :: Template a => a -> HeaderSyntax -> HaddockOffsets
extractModuleHeader :: SourceCode -> TemplateData -> HeaderSyntax -> HaddockModuleHeader
indentField :: Maybe Int -> Text -> Text

Documentation

data HaddockModuleHeader Source #

Extracted fields from the Haddock module header.

Constructors

HaddockModuleHeader

Fields

hmhCopyright :: Maybe Text
module copyright (content of the Copyright field)
hmhLicense :: Maybe Text
module license (content of the License field)
hmhMaintainer :: Maybe Text
module license (content of the Maintainer field)
hmhPortability :: Maybe Text
module license (content of the Portability field)
hmhStability :: Maybe Text
module license (content of the Stability field)
hmhShortDesc :: Maybe Text
module short description (content of the Description field)
hmhLongDesc :: Maybe Text
module long description (the text after module header fields)

Instances

Instances details

Eq HaddockModuleHeader Source #
Instance details Defined in Headroom.FileSupport.Haskell.Haddock Methods (==) :: HaddockModuleHeader -> HaddockModuleHeader -> Bool # (/=) :: HaddockModuleHeader -> HaddockModuleHeader -> Bool #
Show HaddockModuleHeader Source #
Instance details Defined in Headroom.FileSupport.Haskell.Haddock Methods showsPrec :: Int -> HaddockModuleHeader -> ShowS # show :: HaddockModuleHeader -> String # showList :: [HaddockModuleHeader] -> ShowS #

extractOffsets Source #

Arguments

:: Template a
=> a	parsed template
-> HeaderSyntax	copyright header syntax
-> HaddockOffsets	extracted offsets

Extracts offsets for selected haddock fields (i.e. number of chars between start of line and field value). This is needed to properly format multi-line field values rendered in new license headers.

extractModuleHeader Source #

Arguments

:: SourceCode	source code containing Haddock module header
-> TemplateData	extracted metadata from corresponding template
-> HeaderSyntax	copyright header syntax
-> HaddockModuleHeader	extracted metadata

Extracts metadata from given Haddock module header.

indentField Source #

Arguments

:: Maybe Int	offset (in number of black chars) for 2nd and subsequent lines
-> Text	input text to indent
-> Text	processed text

Adds correct indentation to multi-line Haddock field values. It's usually desired to have such values indented like this:

Copyright        : (c) 2020, 1st Author
                   (c) 2020, 2nd Author

This functions achieves that using the offset value, which specifies number of empty characters that should be placed before second (and any subsequent) line.

>>> indentField (Just 2) "foo\nbar\nbaz"
"foo\n  bar\n  baz"