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_inchstr.3x | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-)
diff --git a/man/curs_inchstr.3x b/man/curs_inchstr.3x index fb45fcb16..f711a1c98 100644 --- a/man/curs_inchstr.3x +++ b/man/curs_inchstr.3x @@ -58,15 +58,16 @@ .SH SYNOPSIS .nf \fB#include <curses.h> .PP -\fBint inchstr(chtype *\fIchstr\fP); -\fBint inchnstr(chtype *\fIchstr\fP, int \fIn\fP); -\fBint winchstr(WINDOW *\fIwin\fP, chtype *\fIchstr\fP); -\fBint winchnstr(WINDOW *\fIwin\fP, chtype *\fIchstr\fP, int \fIn\fP); +\fBint inchstr(chtype * \fIchstr\fP); +\fBint inchnstr(chtype * \fIchstr\fP, int \fIn\fP); +\fBint winchstr(WINDOW * \fIwin\fP, chtype * \fIchstr\fP); +\fBint winchnstr(WINDOW * \fIwin\fP, chtype * \fIchstr\fP, int \fIn\fP); .PP -\fBint mvinchstr(int \fIy\fP, int \fIx\fP, chtype *\fIchstr\fP); -\fBint mvinchnstr(int \fIy\fP, int \fIx\fP, chtype *\fIchstr\fP, int \fIn\fP); -\fBint mvwinchstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, chtype *\fIchstr\fP); -\fBint mvwinchnstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, chtype *\fIchstr\fP, int \fIn\fP); +\fBint mvinchstr(int \fIy\fP, int \fIx\fP, chtype * \fIchstr\fP); +\fBint mvinchnstr(int \fIy\fP, int \fIx\fP, chtype * \fIchstr\fP, int \fIn\fP); +\fBint mvwinchstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, chtype * \fIchstr\fP); +\fBint mvwinchnstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, chtype * \fIchstr\fP, + int \fIn\fP); .fi .SH DESCRIPTION These routines return a -- 2.30.2
signature.asc
Description: PGP signature
