Put a space before each pointer star in function synopses. Break long synopsis across lines where it exceeds 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_in_wchstr.3x | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-)
diff --git a/man/curs_in_wchstr.3x b/man/curs_in_wchstr.3x index d9f7d067b..48fa95956 100644 --- a/man/curs_in_wchstr.3x +++ b/man/curs_in_wchstr.3x @@ -58,15 +58,17 @@ .SH SYNOPSIS .nf \fB#include <curses.h> .PP -\fBint in_wchstr(cchar_t *\fIwchstr\fP); -\fBint win_wchstr(WINDOW *\fIwin\fP, cchar_t *\fIwchstr\fP); -\fBint mvin_wchstr(int \fIy\fP, int \fIx\fP, cchar_t *\fIwchstr\fP); -\fBint mvwin_wchstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, cchar_t *\fIwchstr\fP); +\fBint in_wchstr(cchar_t * \fIwchstr\fP); +\fBint win_wchstr(WINDOW * \fIwin\fP, cchar_t * \fIwchstr\fP); +\fBint mvin_wchstr(int \fIy\fP, int \fIx\fP, cchar_t * \fIwchstr\fP); +\fBint mvwin_wchstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, + cchar_t * \fIwchstr\fP); .PP -\fBint in_wchnstr(cchar_t *\fIwchstr\fP, int \fIn\fP); -\fBint win_wchnstr(WINDOW *\fIwin\fP, cchar_t *\fIwchstr\fP, int \fIn\fP); -\fBint mvin_wchnstr(int \fIy\fP, int \fIx\fP, cchar_t *\fIwchstr\fP, int \fIn\fP); -\fBint mvwin_wchnstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, cchar_t *\fIwchstr\fP, int \fIn\fP); +\fBint in_wchnstr(cchar_t * \fIwchstr\fP, int \fIn\fP); +\fBint win_wchnstr(WINDOW * \fIwin\fP, cchar_t * \fIwchstr\fP, int \fIn\fP); +\fBint mvin_wchnstr(int \fIy\fP, int \fIx\fP, cchar_t * \fIwchstr\fP, int \fIn\fP); +\fBint mvwin_wchnstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, + cchar_t * \fIwchstr\fP, int \fIn\fP) .fi .SH DESCRIPTION These functions return an array of complex characters in \fIwchstr\fP, -- 2.30.2
signature.asc
Description: PGP signature
