OptEnvConf.Doc

Documentation

renderVersionPage :: String -> Version -> [Chunk]

Render the output of --version

parserDocs :: Parser a -> AnyDocs SetDoc

Derive parser documentation

renderHelpPage :: String -> String -> AnyDocs SetDoc -> [Chunk]

Render the output of --help

renderManPage :: String -> Version -> String -> AnyDocs SetDoc -> [Chunk]

Render the output of `--render-man-page` for reading with man

renderReferenceDocumentation :: String -> AnyDocs SetDoc -> [Chunk]

Render reference documentation

parserOptDocs :: Parser a -> AnyDocs OptDoc

renderLongOptDocs :: AnyDocs OptDoc -> [Chunk]

Render long-form documentation of options

renderShortOptDocs :: String -> AnyDocs OptDoc -> [Chunk]

Render short-form documentation of options

parserEnvDocs :: Parser a -> AnyDocs EnvDoc

renderEnvDocs :: AnyDocs EnvDoc -> [Chunk]

Render documentation of envionment variables

parserConfDocs :: Parser a -> AnyDocs ConfDoc

renderConfDocs :: AnyDocs ConfDoc -> [Chunk]

Render documentation of configuration values

Internal

data AnyDocs a

Constructors

AnyDocsCommands [CommandDoc a]

AnyDocsAnd ![AnyDocs a]

AnyDocsOr ![AnyDocs a]

AnyDocsSingle !a

Instances

Foldable AnyDocs

Defined in OptEnvConf.Doc

Methods

fold :: Monoid m => AnyDocs m -> m

foldMap :: Monoid m => (a -> m) -> AnyDocs a -> m

foldMap' :: Monoid m => (a -> m) -> AnyDocs a -> m

foldr :: (a -> b -> b) -> b -> AnyDocs a -> b

foldr' :: (a -> b -> b) -> b -> AnyDocs a -> b

foldl :: (b -> a -> b) -> b -> AnyDocs a -> b

foldl' :: (b -> a -> b) -> b -> AnyDocs a -> b

foldr1 :: (a -> a -> a) -> AnyDocs a -> a

foldl1 :: (a -> a -> a) -> AnyDocs a -> a

toList :: AnyDocs a -> [a]

null :: AnyDocs a -> Bool

length :: AnyDocs a -> Int

elem :: Eq a => a -> AnyDocs a -> Bool

maximum :: Ord a => AnyDocs a -> a

minimum :: Ord a => AnyDocs a -> a

sum :: Num a => AnyDocs a -> a

product :: Num a => AnyDocs a -> a

Traversable AnyDocs

Defined in OptEnvConf.Doc

Methods

traverse :: Applicative f => (a -> f b) -> AnyDocs a -> f (AnyDocs b)

sequenceA :: Applicative f => AnyDocs (f a) -> f (AnyDocs a)

mapM :: Monad m => (a -> m b) -> AnyDocs a -> m (AnyDocs b)

sequence :: Monad m => AnyDocs (m a) -> m (AnyDocs a)

Functor AnyDocs

Defined in OptEnvConf.Doc

Methods

fmap :: (a -> b) -> AnyDocs a -> AnyDocs b

(<$) :: a -> AnyDocs b -> AnyDocs a

Show a => Show (AnyDocs a)

Defined in OptEnvConf.Doc

Methods

showsPrec :: Int -> AnyDocs a -> ShowS

show :: AnyDocs a -> String

showList :: [AnyDocs a] -> ShowS

data SetDoc

Constructors

SetDoc

Fields

• setDocTryArgument :: !Bool
• setDocTrySwitch :: !Bool
• setDocTryOption :: !Bool
• setDocDasheds :: ![Dashed]
• setDocEnvVars :: !(Maybe (NonEmpty String))
• setDocConfKeys :: !(Maybe (NonEmpty (NonEmpty String, JSONSchema)))
• setDocDefault :: !(Maybe String)
• setDocMetavar :: !(Maybe Metavar)
• setDocHelp :: !(Maybe String)

Instances

Show SetDoc

Defined in OptEnvConf.Doc

Methods

showsPrec :: Int -> SetDoc -> ShowS

show :: SetDoc -> String

showList :: [SetDoc] -> ShowS

data OptDoc

Constructors

OptDoc

Fields

• optDocTryArgument :: !Bool
• optDocTrySwitch :: !Bool
• optDocTryOption :: !Bool
• optDocDasheds :: ![Dashed]
• optDocDefault :: !(Maybe String)
• optDocMetavar :: !(Maybe Metavar)
• optDocHelp :: !(Maybe String)

Instances

Show OptDoc

Defined in OptEnvConf.Doc

Methods

showsPrec :: Int -> OptDoc -> ShowS

show :: OptDoc -> String

showList :: [OptDoc] -> ShowS

data EnvDoc

Constructors

EnvDoc

Fields

• envDocVars :: !(NonEmpty String)
• envDocDefault :: !(Maybe String)
• envDocMetavar :: !(Maybe Metavar)
• envDocHelp :: !(Maybe String)

Instances

Show EnvDoc

Defined in OptEnvConf.Doc

Methods

showsPrec :: Int -> EnvDoc -> ShowS

show :: EnvDoc -> String

showList :: [EnvDoc] -> ShowS

data ConfDoc

Constructors

ConfDoc

Fields

• confDocKeys :: !(NonEmpty (NonEmpty String, JSONSchema))
• confDocDefault :: !(Maybe String)
• confDocHelp :: !(Maybe String)

Instances

Show ConfDoc

Defined in OptEnvConf.Doc

Methods

showsPrec :: Int -> ConfDoc -> ShowS

show :: ConfDoc -> String

showList :: [ConfDoc] -> ShowS

settingSetDoc :: Setting a -> Maybe SetDoc

renderSetDoc :: SetDoc -> [[Chunk]]

settingOptDoc :: Setting a -> Maybe OptDoc

renderOptDocLong :: OptDoc -> [[Chunk]]

settingEnvDoc :: Setting a -> Maybe EnvDoc

renderEnvDoc :: EnvDoc -> [[Chunk]]

settingConfDoc :: Setting a -> Maybe ConfDoc

renderConfDoc :: ConfDoc -> [[Chunk]]

helpLines :: Help -> [[Chunk]]