[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
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH 36/52] Set "putchar" and "stdio" as man page cross references.,
G. Branden Robinson <=