bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 36/52] Set "putchar" and "stdio" as man page cross references.


From: G. Branden Robinson
Subject: [PATCH 36/52] Set "putchar" and "stdio" as man page cross references.
Date: Fri, 22 Dec 2023 17:07:50 -0600

...consistently.  Set them in italics instead of bold or roman, since
they are "foreign" pages.  Use man page cross reference notation.

* man/curs_addch.3x:
* man/curs_initscr.3x:
* man/curs_terminfo.3x:
* man/ncurses.3x:
* man/scr_dump.5: Do it.
---
 man/curs_addch.3x    |  2 +-
 man/curs_initscr.3x  |  5 +++--
 man/curs_terminfo.3x | 13 +++++++------
 man/ncurses.3x       |  3 ++-
 man/scr_dump.5       |  2 +-
 5 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/man/curs_addch.3x b/man/curs_addch.3x
index 34cc21c53..6db441985 100644
--- a/man/curs_addch.3x
+++ b/man/curs_addch.3x
@@ -70,7 +70,7 @@ .SS "Adding Characters"
 The \fBaddch\fP, \fBwaddch\fP, \fBmvaddch\fP and \fBmvwaddch\fP routines put
 the character \fIch\fP into the given window at its current window position,
 which is then advanced.
-They are analogous to \fBputchar\fP(3) in \fBstdio\fP(3).
+They are analogous to \fI\%putchar\fP(3) in \fI\%stdio\fP(3).
 If the advance is at the right margin:
 .bP
 The cursor automatically wraps to the beginning of the next line.
diff --git a/man/curs_initscr.3x b/man/curs_initscr.3x
index 01b788269..a69554d22 100644
--- a/man/curs_initscr.3x
+++ b/man/curs_initscr.3x
@@ -280,8 +280,9 @@ .SS "Signal Handlers"
 On systems which have \fBREENTRANT\fP turned on, \fBset_term\fP uses
 functions which could deadlock or misbehave in other ways.
 .bP
-\fBendwin\fP calls other functions, many of which use stdio or
-other library functions which are clearly unsafe.
+\fBendwin\fP calls other functions,
+many of which use \fI\%stdio\fP(3) or other library functions which are
+clearly unsafe.
 .RE
 .TP 5
 .B SIGTERM
diff --git a/man/curs_terminfo.3x b/man/curs_terminfo.3x
index 5c3d82d92..ddc0c6402 100644
--- a/man/curs_terminfo.3x
+++ b/man/curs_terminfo.3x
@@ -339,14 +339,14 @@ .SS "Output Functions"
 \fIaffcnt\fP is the number of lines affected, or 1 if
 not applicable.
 .bP
-\fIputc\fP is a \fBputchar\fP-like routine to which
+\fIputc\fP is a \fI\%putchar\fP-like function to which
 the characters are passed, one at a time.
 .IP
 If \fBtputs\fP processes a time-delay,
 it uses the \fBdelay_output\fP(3X) function,
 routing any resulting padding characters through this function.
 .PP
-The \fBputp\fR routine calls \fBtputs(\fIstr\fB, 1, putchar)\fR.
+The \fBputp\fR routine calls \fBtputs(\fIstr\fB, 1, \%putchar)\fR.
 The output of \fBputp\fP always goes to \fBstdout\fP, rather than
 the \fIfiledes\fP specified in \fBsetupterm\fP.
 .PP
@@ -354,10 +354,10 @@ .SS "Output Functions"
 video attribute mode \fIattrs\fP, which is any combination of the
 attributes listed in \fBcurses\fP(3X).
 The characters are passed to
-the \fBputchar\fP-like routine \fIputc\fP.
+the \fI\%putchar\fP-like function \fIputc\fP.
 .PP
 The \fBvidattr\fP routine is like the \fBvidputs\fP routine, except
-that it outputs through \fBputchar\fP.
+that it outputs through \fI\%putchar\fP.
 .PP
 The \fBvid_attr\fP and \fBvid_puts\fP routines correspond
 to vidattr and vidputs, respectively.
@@ -686,7 +686,8 @@ .SH HISTORY
 gettmode       establish current tty modes
 mvcur  low level cursor motion
 putp   T{
-utility function that uses \fBtputs\fP to send characters via \fBputchar\fP.
+utility function that uses \fBtputs\fP to send characters via
+\fI\%putchar\fP.
 T}
 resetterm      set tty modes to \*(``out of curses\*('' state
 resetty        reset tty flags to stored value
@@ -696,7 +697,7 @@ .SH HISTORY
 setupterm      establish terminal with given type
 tparm  instantiate a string expression with parameters
 tputs  apply padding information to a string
-vidattr        like \fBvidputs\fP, but outputs through \fBputchar\fP
+vidattr        like \fBvidputs\fP, but outputs through \fIputchar\fP
 vidputs        T{
 output a string to put terminal in a specified video attribute mode
 T}
diff --git a/man/ncurses.3x b/man/ncurses.3x
index ba7cc2184..687cab346 100644
--- a/man/ncurses.3x
+++ b/man/ncurses.3x
@@ -1180,7 +1180,8 @@ .SS \fINCURSES_NO_SETBUF\fP
 The reason for the change was to make the behavior for interrupts and
 other signals more robust.
 One drawback is that certain nonconventional programs would mix
-ordinary stdio calls with \fI\%ncurses\fP calls and (usually) work.
+ordinary \fI\%stdio\fP(3) calls with \fI\%ncurses\fP calls and (usually)
+work.
 This is no longer possible since \fI\%ncurses\fP is not using
 the buffered standard output but its own output (to the same file descriptor).
 As a special case, the low-level calls such as \fBputp\fP still use the
diff --git a/man/scr_dump.5 b/man/scr_dump.5
index dd66be645..5d51659c4 100644
--- a/man/scr_dump.5
+++ b/man/scr_dump.5
@@ -145,7 +145,7 @@ .SS "X/Open Curses"
 then creates and initializes a new window using that data.
 .PP
 The \fBputwin(\ )\fP function writes all data associated
-with \fIwin\fP into the \fBstdio\fP(3) stream to which \fIfilep\fP
+with \fIwin\fP into the \fI\%stdio\fP(3) stream to which \fIfilep\fP
 points, using an \fBunspecified format\fP.
 This information can be retrieved later using \fBgetwin(\ )\fP.
 .RE
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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