[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 01/34] Revise approach to man(7) `EX`/`EE` macros.
From: |
G. Branden Robinson |
Subject: |
[PATCH 01/34] Revise approach to man(7) `EX`/`EE` macros. |
Date: |
Fri, 6 Oct 2023 00:12:33 -0500 |
Trying to define `EX` and `EE` macros only if the underlying formatter
didn't did not work out well. mandoc(1) (which _has_ supported them for
a decade, since 1.12.2 on 2013-10-05) has a "-T lint" mode that gets
confused by nested conditional blocks in branches that _aren't_ taken.
It threw scary "ERROR" diagnostics in response to my earlier approach.
mandoc(1) maintainer Ingo Schwarze identified this as a bug, but there's
another issue: it's hard to find man page formatters these days that
_don't_ support these macros. groff, mandoc, Heirloom Doctools, Plan 9,
and even Documenter's Workbench all do.
It therefore seems better to just assume support for `EX` and `EE`.
* man/MKada_config.in:
* man/clear.1: Drop conditional `EX`/`EE` macro definitions.
Dropping these macro definitions makes unnecessary the hoop we were
already jumping through to define a string to store the name of a
constant-width typeface, another portability challenge.
* man/MKada_config.in:
* man/clear.1: Drop definition of `CW` string.
---
man/MKada_config.in | 36 ------------------------------------
man/clear.1 | 5 -----
2 files changed, 41 deletions(-)
diff --git a/man/MKada_config.in b/man/MKada_config.in
index f63133c1..28e35b07 100644
--- a/man/MKada_config.in
+++ b/man/MKada_config.in
@@ -30,42 +30,6 @@
.\" $Id: MKada_config.in,v 1.28 2023/09/30 23:55:34 tom Exp $
.TH adacurses@USE_CFG_SUFFIX@\-config 1 2023-09-30 "ncurses
@NCURSES_MAJOR@.@NCURSES_MINOR@" "User commands"
.ds C adacurses@USE_CFG_SUFFIX@\-config
-.ie n .ds CW R
-.el \{
-.ie \n(.g .ds CW CR
-.el .ds CW CW
-.\}
-.
-.nr mE 0 \" in an example (EX/EE)?
-.
-.\" Start example.
-.if !\n(.g \{\
-.de EX
-. br
-. if !\\n(mE \{\
-. nr mF \\n(.f
-. nr mP \\n(PD
-. nr PD 1v
-. nf
-. ft \\*(CW
-. nr mE 1
-. \}
-..
-.\}
-.
-.\" End example.
-.if !\n(.g \{\
-.de EE
-. br
-. if \\n(mE \{\
-. ft \\n(mF
-. nr PD \\n(mP
-. fi
-. nr mE 0
-. \}
-..
-.\}
-.
.ie \n(.g \{\
.ds `` \(lq
.ds '' \(rq
diff --git a/man/clear.1 b/man/clear.1
index 07ddd93b..0d8c59af 100644
--- a/man/clear.1
+++ b/man/clear.1
@@ -29,11 +29,6 @@
.\"
.\" $Id: clear.1,v 1.40 2023/10/01 22:12:38 tom Exp $
.TH @CLEAR@ 1 2023-10-01 "ncurses 6.4" "User commands"
-.ie n .ds CW R
-.el \{
-.ie \n(.g .ds CW CR
-.el .ds CW CW
-.\}
.ie \n(.g .ds `` \(lq
.el .ds `` ``
.ie \n(.g .ds '' \(rq
--
2.30.2
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH 01/34] Revise approach to man(7) `EX`/`EE` macros.,
G. Branden Robinson <=