bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 021/177] man/curs_add{,_w}chstr.3x: Ensure synopses don't overset


From: G. Branden Robinson
Subject: [PATCH 021/177] man/curs_add{,_w}chstr.3x: Ensure synopses don't overset the line.
Date: Mon, 13 Jan 2025 11:17:15 -0600

Break long synopses across lines where they exceed 65 columns on nroff
devices.  This was the line length used by AT&T troff (and BSD troff
until they adopted groff in their Net/2 release), and is, in my opinion,
the minimum line length one can expect to look nice.  groff 1.24 is
expected to feature enhanced `SY`/`YS` macros that work as well with C
function declarations as command-line syntax.  Perhaps we can inline
their definitions in the ncurses man pages (which need to be portable to
legacy Unix systems) after they've seen more field testing.
---
 man/curs_add_wchstr.3x | 12 ++++++++----
 man/curs_addchstr.3x   |  6 ++++--
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/man/curs_add_wchstr.3x b/man/curs_add_wchstr.3x
index 27ffca33e..cdb063b05 100644
--- a/man/curs_add_wchstr.3x
+++ b/man/curs_add_wchstr.3x
@@ -61,12 +61,16 @@ .SH SYNOPSIS
 \fBint add_wchstr(const cchar_t * \fIwchstr\fP);
 \fBint wadd_wchstr(WINDOW *  \fIwin\fP, const cchar_t * \fIwchstr\fP);
 \fBint mvadd_wchstr(int \fIy\fP, int \fIx\fP, const cchar_t * \fIwchstr\fP);
-\fBint mvwadd_wchstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, const 
cchar_t * \fIwchstr\fP);
+\fBint mvwadd_wchstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP,
+      const cchar_t * \fIwchstr\fP);
 .PP
 \fBint add_wchnstr(const cchar_t * \fIwchstr\fP, int \fIn\fP);
-\fBint wadd_wchnstr(WINDOW *  \fIwin\fP, const cchar_t * \fIwchstr\fP, int 
\fIn\fP);
-\fBint mvadd_wchnstr(int \fIy\fP, int \fIx\fP, const cchar_t * \fIwchstr\fP, 
int \fIn\fP);
-\fBint mvwadd_wchnstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, const 
cchar_t * \fIwchstr\fP, int \fIn\fP);
+\fBint wadd_wchnstr(WINDOW *  \fIwin\fP, const cchar_t * \fIwchstr\fP,
+      int \fIn\fP);
+\fBint mvadd_wchnstr(int \fIy\fP, int \fIx\fP, const cchar_t * \fIwchstr\fP,
+      int \fIn\fP);
+\fBint mvwadd_wchnstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP,
+      const cchar_t * \fIwchstr\fP, int \fIn\fP);
 .fi
 .SH DESCRIPTION
 .B \%wadd_wchstr
diff --git a/man/curs_addchstr.3x b/man/curs_addchstr.3x
index a85cbe5d1..d2584feda 100644
--- a/man/curs_addchstr.3x
+++ b/man/curs_addchstr.3x
@@ -61,12 +61,14 @@ .SH SYNOPSIS
 \fBint addchstr(const chtype * \fIchstr\fP);
 \fBint waddchstr(WINDOW * \fIwin\fP, const chtype * \fIchstr\fP);
 \fBint mvaddchstr(int \fIy\fP, int \fIx\fP, const chtype * \fIchstr\fP);
-\fBint mvwaddchstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, const chtype 
* \fIchstr\fP);
+\fBint mvwaddchstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP,
+      const chtype * \fIchstr\fP);
 .PP
 \fBint addchnstr(const chtype * \fIchstr\fP, int \fIn\fP);
 \fBint waddchnstr(WINDOW * \fIwin\fP, const chtype * \fIchstr\fP, int \fIn\fP);
 \fBint mvaddchnstr(int \fIy\fP, int \fIx\fP, const chtype * \fIchstr\fP, int 
\fIn\fP);
-\fBint mvwaddchnstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, const chtype 
* \fIchstr\fP, int \fIn\fP);
+\fBint mvwaddchnstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP,
+      const chtype * \fIchstr\fP, int \fIn\fP);
 .fi
 .SH DESCRIPTION
 .B \%waddchstr
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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