package reason
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=a58837f14a79f047c8eb99d5518aeb16ee64353574286cfd5b284c98a1a27250
sha512=28d6d1c3636e400614b1a7d8c78b0bbb5de143e259edf683139b75d2fd2013da8e1a6c58d11047e6853f1e559c387d233570665de0de646005197b5f4d6f4879
doc/reason.cmdliner/Vendored_cmdliner/Manpage/index.html
Module Vendored_cmdliner.Manpage
Source
Man page specification.
Man page generation is automatically handled by Cmdliner
. The block
type is used to define a man page's content.
The print
function can be useful if the client wants to define other man pages (e.g. to implement a help command).
Man pages
The type for a block of man page text.
`S s
introduces a new sections
.`P t
is a new paragraph with textt
.`Pre t
is a new preformatted paragraph with textt
.`I (l,t)
is an indented paragraph with labell
and textt
.`Noblank
suppresses the blank line introduced between two blocks.
Except in `Pre
, whitespace and newlines are not significant and are all collapsed to a single space. In labels l
and text strings t
, the syntax "$(i,italic text)"
and "$(b,bold text)"
can be used to respectively produce italic and bold text.
The type for man page titles. Describes the man page title
, section
, center_footer
, left_footer
, center_header
.
The type for a man page. A title and the page text as a list of blocks.
val print :
?subst:(string -> string) ->
[ `Pager | `Plain | `Groff ] ->
Format.formatter ->
t ->
unit
print ~subst fmt ppf page
prints page
on ppf
in the format fmt
. If fmt
is `Pager
the function tries to write the formatted result in a pager, if that fails the format `Plain
is written on ppf
. subst
can be used to perform variable substitution, see Buffer.add_substitute
(defaults to the identity).