aboutsummaryrefslogtreecommitdiff
path: root/data
diff options
context:
space:
mode:
authorJohn MacFarlane <[email protected]>2023-08-25 21:35:47 -0700
committerJohn MacFarlane <[email protected]>2023-08-25 21:35:47 -0700
commita6fe02f46a93c8cfaad1a4cb3c5e166a7aea3a4b (patch)
tree7bcbeeeac8e6a4409f9a2e6eaa3c7eacc607d49b /data
parent0a298cb1bef39d9aa7d756b54aa360e43989431f (diff)
Man writer: improvements to code and code blocks.
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.
Diffstat (limited to 'data')
-rw-r--r--data/templates/default.man14
1 files changed, 0 insertions, 14 deletions
diff --git a/data/templates/default.man b/data/templates/default.man
index 342a09e4d..84aa37d73 100644
--- a/data/templates/default.man
+++ b/data/templates/default.man
@@ -5,20 +5,6 @@ $if(pandoc-version)$
.\" Automatically generated by Pandoc $pandoc-version$
.\"
$endif$
-.\" Define V font for inline verbatim, using C font in formats
-.\" that render this, and otherwise B font.
-.ie "\f[CB]x\f[]"x" \{\
-. ftr V B
-. ftr VI BI
-. ftr VB B
-. ftr VBI BI
-.\}
-.el \{\
-. ftr V CR
-. ftr VI CI
-. ftr VB CB
-. ftr VBI CBI
-.\}
$if(adjusting)$
.ad $adjusting$
$endif$