[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
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH 021/177] man/curs_add{,_w}chstr.3x: Ensure synopses don't overset the line.,
G. Branden Robinson <=