bug-ncurses
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH 59/61] man/tput.1: Deparameterize man section 1 for clear, tabs,


From: G. Branden Robinson
Subject: [PATCH 59/61] man/tput.1: Deparameterize man section 1 for clear, tabs, and tset pages.
Date: Fri, 24 Nov 2023 12:12:00 -0600

Nothing ever seems to modify this, but ncurses man page generation is
complex.  Since indirecting this manual section through a *roff register
doesn't seem to accomplishing anything, embed it literally.

If this datum still needs to be parameterized, I foresee two approaches.

1.  Migrate the ncurses man page to m4 or similar, like groff's
    groff_man(7) and groff_man_style(7) (two documents generated from
    the same source), and generate their final texts with Make.
2.  Rewrite the pages at install time with sed, as is currently done for
    several other data, like the page suffix and program names like
    "@TSET@" and "@CLEAR@".
---
 man/tput.1 | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/man/tput.1 b/man/tput.1
index 719fcb5d..bab6f485 100644
--- a/man/tput.1
+++ b/man/tput.1
@@ -45,7 +45,6 @@
 .ie n  .IP \(bu 4
 .el    .IP \(bu 2
 ..
-.ds n 1
 .ds d @TERMINFO@
 .SH NAME
 \fB\%@TPUT@\fP,
@@ -245,7 +244,7 @@ .SS Aliases
 .PP
 If \fB@TPUT@\fP is invoked by a link named \fBreset\fP, this has the
 same effect as \fB@TPUT@ reset\fP.
-The \fB@TSET@\fP(\*n) utility also treats a link named \fBreset\fP specially.
+The \fB@TSET@\fP(1) utility also treats a link named \fBreset\fP specially.
 .PP
 Before ncurses 6.1, the two utilities were different from each other:
 .bP
@@ -609,9 +608,9 @@ .SH EXAMPLES
 and turns on bold (extra bright) mode.
 The list is terminated by an exclamation mark (\fB!\fP) on a line by itself.
 .SH SEE ALSO
-\fB\%@CLEAR@\fP(\*n),
+\fB\%@CLEAR@\fP(1),
 \fB\%stty\fP(1),
-\fB\%@TABS@\fP(\*n),
-\fB\%@TSET@\fP(\*n),
+\fB\%@TABS@\fP(1),
+\fB\%@TSET@\fP(1),
 \fB\%curs_termcap\fP(3X),
 \fB\%terminfo\fP(5)
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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