bug-ncurses
[Top][All Lists]
Advanced

[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

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]