bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 17/43] man/curs_in{,w}str.3x: Fix markup nit.


From: G. Branden Robinson
Subject: [PATCH 17/43] man/curs_in{,w}str.3x: Fix markup nit.
Date: Mon, 9 Sep 2024 09:15:41 -0500

The spaces after pointer stars don't need to be escaped (making them
unadjustable and unbreakable).  Since filling is off, using this escape
sequence merely clutters the syntax.  Use ordinary spaces instead.

If the ncurses man pages adopt an approach to synopsis formatting that
admits filling and breaking (like groff's 15-year-old `SY` and `YS`
extensions to man(7)), a decision must then be taken whether pointer
stars should associate more strongly with the rest of the data type or
with the name of the object.  But not before.
---
 man/curs_instr.3x  | 16 ++++++++--------
 man/curs_inwstr.3x | 16 ++++++++--------
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/man/curs_instr.3x b/man/curs_instr.3x
index c3f5dcd8b..536116c68 100644
--- a/man/curs_instr.3x
+++ b/man/curs_instr.3x
@@ -58,15 +58,15 @@ .SH SYNOPSIS
 .nf
 \fB#include <curses.h>
 .PP
-\fBint instr(char *\ \fIstr\fP);
-\fBint winstr(WINDOW *\ \fIwin\fP, char *\ \fIstr\fP);
-\fBint mvinstr(int \fIy\fP, int \fIx\fP, char *\ \fIstr\fP);
-\fBint mvwinstr(WINDOW *\ \fIwin\fP, int \fIy\fP, int \fIx\fP, char *\ 
\fIstr\fP);
+\fBint instr(char * \fIstr\fP);
+\fBint winstr(WINDOW * \fIwin\fP, char * \fIstr\fP);
+\fBint mvinstr(int \fIy\fP, int \fIx\fP, char * \fIstr\fP);
+\fBint mvwinstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, char * 
\fIstr\fP);
 .PP
-\fBint innstr(char *\ \fIstr\fP, int \fIn\fP);
-\fBint winnstr(WINDOW *\ \fIwin\fP, char *\ \fIstr\fP, int \fIn\fP);
-\fBint mvinnstr(int \fIy\fP, int \fIx\fP, char *\ \fIstr\fP, int \fIn\fP);
-\fBint mvwinnstr(WINDOW *\ \fIwin\fP, int \fIy\fP, int \fIx\fP, char *\ 
\fIstr\fP, int \fIn\fP);
+\fBint innstr(char * \fIstr\fP, int \fIn\fP);
+\fBint winnstr(WINDOW * \fIwin\fP, char * \fIstr\fP, int \fIn\fP);
+\fBint mvinnstr(int \fIy\fP, int \fIx\fP, char * \fIstr\fP, int \fIn\fP);
+\fBint mvwinnstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, char * 
\fIstr\fP, int \fIn\fP);
 .fi
 .SH DESCRIPTION
 .B \%winstr
diff --git a/man/curs_inwstr.3x b/man/curs_inwstr.3x
index 80bb266bf..d72f0847f 100644
--- a/man/curs_inwstr.3x
+++ b/man/curs_inwstr.3x
@@ -57,15 +57,15 @@ .SH SYNOPSIS
 .nf
 \fB#include <curses.h>
 .PP
-\fBint inwstr(wchar_t *\ \fIwstr\fP);
-\fBint winwstr(WINDOW *\ \fIwin\fP, wchar_t *\ \fIwstr\fP);
-\fBint mvinwstr(int \fIy\fP, int \fIx\fP, wchar_t *\ \fIwstr\fP);
-\fBint mvwinwstr(WINDOW *\ \fIwin\fP, int \fIy\fP, int \fIx\fP, wchar_t *\ 
\fIwstr\fP);
+\fBint inwstr(wchar_t * \fIwstr\fP);
+\fBint winwstr(WINDOW * \fIwin\fP, wchar_t * \fIwstr\fP);
+\fBint mvinwstr(int \fIy\fP, int \fIx\fP, wchar_t * \fIwstr\fP);
+\fBint mvwinwstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, wchar_t * 
\fIwstr\fP);
 .PP
-\fBint innwstr(wchar_t *\ \fIwstr\fP, int \fIn\fP);
-\fBint winnwstr(WINDOW *\ \fIwin\fP, wchar_t *\ \fIwstr\fP, int \fIn\fP);
-\fBint mvinnwstr(int \fIy\fP, int \fIx\fP, wchar_t *\ \fIwstr\fP, int \fIn\fP);
-\fBint mvwinnwstr(WINDOW *\ \fIwin\fP, int \fIy\fP, int \fIx\fP, wchar_t *\ 
\fIwstr\fP, int \fIn\fP);
+\fBint innwstr(wchar_t * \fIwstr\fP, int \fIn\fP);
+\fBint winnwstr(WINDOW * \fIwin\fP, wchar_t * \fIwstr\fP, int \fIn\fP);
+\fBint mvinnwstr(int \fIy\fP, int \fIx\fP, wchar_t * \fIwstr\fP, int \fIn\fP);
+\fBint mvwinnwstr(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP, wchar_t * 
\fIwstr\fP, int \fIn\fP);
 .fi
 .SH DESCRIPTION
 .B \%winwstr
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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