aboutsummaryrefslogtreecommitdiff
path: root/data/templates/default.man
AgeCommit message (Collapse)Author
2024-07-03Man writer: use default middle header when metadata does not...John MacFarlane
include `header`. This change causes pandoc to omit the middle header parameter when `header` is not set, rather than emitting `""`. The parameter is optional and man will use a default based on the section if it is not specified. Closes #9943.
2023-08-25Man writer: improvements to code and code blocks.John MacFarlane
The aim here (see #9020) is to produce more standard and more portable man pages. To that end: - We revert the fanciness introduced in #7506, which employs a custom font name V and a macro that makes this act like boldface in a terminal and monospace in other formats. Unfortunately, this code uses a mechanism that is not portable (and does not work in mandoc). - Instead of using V for inline code, we simply use CR. Note that `\f[CR]` is emitted instead of plain `\f[C]`, because there is no C font in man. (This produces warnings in recent versions of groff.) - For code blocks, we now use the `.EX` and `.EE` macros, together with `.IP` for spacing and indentation. This gives more standard code that can be better interpreted e.g. by mandoc.
2023-08-24Man writer: don't emit `.hy`...John MacFarlane
regardless of setting of `hyphenate` variable. See #9020.
2022-01-15Improve on fix to #7506.John MacFarlane
Don't boldface code in output formats that can represent it as monospace. Define aliases for VI, VB, VBI as well.
2022-01-15Man writer: use custom font V for inline code.John MacFarlane
The V font is defined conditionally, so that it renders like CB in output formats that support that, and like B in those that don't (e.g. the terminal). We could just redefine C, but this would affect code blocks, too, and putting them all in boldface looks ugly, I think. Possible drawback: fragments created by pandoc's man writer will presuppose a nonstandard V font. Closes #7506. Supersedes 253467a549dcc22384be96041fd6f886c4a7a935.
2020-11-03man template: change tbl comment to `'\" t`.John MacFarlane
This is what is specified in groff_man(7). Closes #6803.
2019-11-24Update man template to avoid bad wraps.John MacFarlane
The contents of the .TH line cannot wrap. Closes #5929.
2019-07-04Remove misleading comment in man, ms templates.John MacFarlane
2017-02-20Merge commit '9e52ac6bb02afd7b4ed5dad61021a1fa33051203' as 'data/templates'John MacFarlane