bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 041/177] man/curs_get{,_w}str.3x: Ensure synopses don't overset t


From: G. Branden Robinson
Subject: [PATCH 041/177] man/curs_get{,_w}str.3x: Ensure synopses don't overset the line.
Date: Mon, 13 Jan 2025 11:21:01 -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_get_wstr.3x | 3 ++-
 man/curs_getstr.3x   | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/man/curs_get_wstr.3x b/man/curs_get_wstr.3x
index b6aa4d607..3cc1d0cfa 100644
--- a/man/curs_get_wstr.3x
+++ b/man/curs_get_wstr.3x
@@ -66,7 +66,8 @@ .SH SYNOPSIS
 \fBint getn_wstr(wint_t * \fIwstr\fP, int \fIn\fP);
 \fBint wgetn_wstr(WINDOW * \fIwin\fP, wint_t * \fIwstr\fP, int \fIn\fP);
 \fBint mvgetn_wstr(int \fIy\fP, int \fIx\fP, wint_t * \fIwstr\fP, int \fIn\fP);
-\fBint mvwgetn_wstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, wint_t * 
\fIwstr\fP, int \fIn\fP);
+\fBint mvwgetn_wstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, wint_t * 
\fIwstr\fP,
+      int \fIn\fP);
 .fi
 .SH DESCRIPTION
 The function
diff --git a/man/curs_getstr.3x b/man/curs_getstr.3x
index 2588c02ca..6edd50405 100644
--- a/man/curs_getstr.3x
+++ b/man/curs_getstr.3x
@@ -68,7 +68,8 @@ .SH SYNOPSIS
 \fBint getnstr(char * \fIstr\fP, int \fIn\fP);
 \fBint wgetnstr(WINDOW * \fIwin\fP, char * \fIstr\fP, int \fIn\fP);
 \fBint mvgetnstr(int \fIy\fP, int \fIx\fP, char * \fIstr\fP, int \fIn\fP);
-\fBint mvwgetnstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, char * 
\fIstr\fP, int \fIn\fP);
+\fBint mvwgetnstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, char * 
\fIstr\fP,
+      int \fIn\fP);
 .fi
 .SH DESCRIPTION
 .B \%wgetstr
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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