[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 02/42] Protect man page topics from hyphenation in cross referenc
From: |
G. Branden Robinson |
Subject: |
[PATCH 02/42] Protect man page topics from hyphenation in cross references. |
Date: |
Sat, 16 Dec 2023 11:40:30 -0600 |
* man/curs_add_wch.3x:
* man/curs_addch.3x:
* man/curs_initscr.3x:
* man/curs_terminfo.3x:
* man/tic.1m:
* man/user_caps.5: Do it.
---
man/curs_add_wch.3x | 12 ++++++------
man/curs_addch.3x | 20 ++++++++++----------
man/curs_initscr.3x | 10 +++++-----
man/curs_terminfo.3x | 3 ++-
man/tic.1m | 2 +-
man/user_caps.5 | 2 +-
6 files changed, 25 insertions(+), 24 deletions(-)
diff --git a/man/curs_add_wch.3x b/man/curs_add_wch.3x
index 374597b41..a07570702 100644
--- a/man/curs_add_wch.3x
+++ b/man/curs_add_wch.3x
@@ -106,7 +106,7 @@ .SS echo_wchar
function is functionally equivalent to a call to
\fBadd_wch\fP
followed by a call to
-\fBrefresh\fP(3X).
+\fB\%refresh\fP(3X).
Similarly, the
\fBwecho_wchar\fP
is functionally equivalent to a call to
@@ -118,11 +118,11 @@ .SS echo_wchar
for non-control characters, a considerable performance gain might be seen
by using the *\fBecho\fP* functions instead of their equivalents.
.SS Line Graphics
-Like \fBaddch\fP(3X),
+Like \fB\%addch\fP(3X),
\fBaddch_wch\fP accepts symbols which make it simple to draw lines and other
frequently used special characters.
These symbols correspond to the same VT100 line-drawing set as
-\fBaddch\fP(3X).
+\fB\%addch\fP(3X).
.PP
.TS
l l l l l
@@ -231,7 +231,7 @@ .SH RETURN VALUE
.PP
The latter may be due to different causes:
.bP
-If \fBscrollok\fP(3X) is not enabled,
+If \fB\%scrollok\fP(3X) is not enabled,
writing a character at the lower right margin succeeds.
However, an error is returned because
it is not possible to wrap to a new line
@@ -289,7 +289,7 @@ .SS WACS Symbols
terminal description's \fBacsc\fP mapping as discussed in ncurses(3X)
for the environment variable \fBNCURSES_NO_UTF8_ACS\fP.
In contrast, for the same cases, the line-drawing characters
-described in \fBcurs_addch\fP(3X) will use only the ASCII default values.
+described in \fB\%addch\fP(3X) will use only the ASCII default values.
.PP
Having Unicode available does not solve all of the problems with
line-drawing for curses:
@@ -338,7 +338,7 @@ .SS Complex Characters
or a non-spacing character.
.PP
This implementation assumes that \fIwch\fP is constructed using
-\fBsetcchar\fP(3X), and in turn that the result
+\fB\%setcchar\fP(3X), and in turn that the result
.bP
contains at most one spacing character in the beginning of its list of wide
characters,
diff --git a/man/curs_addch.3x b/man/curs_addch.3x
index 34128d960..79b7eb1af 100644
--- a/man/curs_addch.3x
+++ b/man/curs_addch.3x
@@ -76,10 +76,10 @@ .SS Adding characters
The cursor automatically wraps to the beginning of the next line.
.bP
At the bottom of the current scrolling region,
-and if \fBscrollok\fP(3X) is enabled,
+and if \fB\%scrollok\fP(3X) is enabled,
the scrolling region is scrolled up one line.
.bP
-If \fBscrollok\fP(3X) is not enabled,
+If \fB\%scrollok\fP(3X) is not enabled,
writing a character at the lower right margin succeeds.
However, an error is returned because
it is not possible to wrap to a new line
@@ -107,7 +107,7 @@ .SS Adding characters
.bP
Values above 128 are either meta characters
(if the screen has not been initialized,
-or if \fBmeta\fP(3X) has been called with a \fBTRUE\fP E parameter),
+or if \fB\%meta\fP(3X) has been called with a \fBTRUE\fP E parameter),
shown in the \fBM\-\fIX\fR notation, or are displayed as themselves.
In the latter case, the values may not be printable;
this follows the X/Open specification.
@@ -119,12 +119,12 @@ .SS Adding characters
Video attributes can be combined with a character argument passed to
\fBaddch\fP or related functions by logical-ORing them into the character.
(Thus, text, including attributes, can be copied from one place to another
-using \fBinch\fP(3X) and \fBaddch\fP.) See the \fBcurs_attr\fP(3X) page for
-values of predefined video attribute constants that can be usefully OR'ed
-into characters.
+using \fB\%inch\fP(3X) and \fBaddch\fP.)
+See the \fB\%curs_attr\fP(3X) page for values of predefined video
+attribute constants that can be usefully OR'ed into characters.
.SS Echoing characters
The \fBechochar\fP and \fBwechochar\fP routines are equivalent to a call to
-\fBaddch\fP followed by a call to \fBrefresh\fP(3X), or a call to \fBwaddch\fP
+\fBaddch\fP followed by a call to \fB\%refresh\fP(3X), or a call to
\fBwaddch\fP
followed by a call to \fBwrefresh\fP.
The knowledge that only a single
character is being output is used and, for non-control characters, a
@@ -194,7 +194,7 @@ .SH RETURN VALUE
If it is not possible to add a complete character,
an error is returned:
.bP
-If \fBscrollok\fP(3X) is not enabled,
+If \fB\%scrollok\fP(3X) is not enabled,
writing a character at the lower right margin succeeds.
However, an error is returned because
it is not possible to wrap to a new line
@@ -253,7 +253,7 @@ .SS ACS Symbols
include \fBacsc\fP strings in which their key characters (pryz{|}) are
embedded, and a second-hand list of their character descriptions has come
to light.
-The ACS-prefixed names for them were invented for \fBncurses\fP(3X).
+The ACS-prefixed names for them were invented for \fB\%ncurses\fP(3X).
.LP
The \fIdisplayed\fP values for the \fBACS_\fP and \fBWACS_\fP constants
depend on
@@ -270,7 +270,7 @@ .SS ACS Symbols
.SS Character Set
X/Open Curses assumes that the parameter passed to \fBwaddch\fP contains
a single character.
-As discussed in \fBcurs_attr\fP(3X), that character may have been
+As discussed in \fB\%curs_attr\fP(3X), that character may have been
more than eight bits in an SVr3 or SVr4 implementation,
but in the X/Open Curses model, the details are not given.
The important distinction between SVr4 curses and X/Open Curses is
diff --git a/man/curs_initscr.3x b/man/curs_initscr.3x
index ea9c516a4..47f9d4091 100644
--- a/man/curs_initscr.3x
+++ b/man/curs_initscr.3x
@@ -181,7 +181,7 @@ .SS Differences
call \fBinitscr\fP more than once:
.bP
The portable way to use \fBinitscr\fP is once only,
-using \fBrefresh\fP (see curs_refresh(3X))
+using \fB\%refresh\fP(3X)
to restore the screen after \fBendwin\fP.
.bP
This implementation allows using \fBinitscr\fP after \fBendwin\fP.
@@ -292,16 +292,16 @@ .SS Signal Handlers
.B SIGTSTP
This handles the \fIstop\fP signal, used in job control.
When resuming the process, this implementation discards pending
-input with \fBflushinput\fP (see curs_util(3X)), and repaints the screen
+input with \fB\%flushinput\fP(3X), and repaints the screen
assuming that it has been completely altered.
-It also updates the saved terminal modes with \fBdef_shell_mode\fP
-(see \fBcurs_kernel\fP(3X)).
+It also updates the saved terminal modes with
+\fB\%def_shell_mode\fP(3X).
.TP 5
.B SIGWINCH
This handles the window-size changes which were ignored in
the standardization efforts.
The handler sets a (signal-safe) variable
-which is later tested in \fBwgetch\fP (see curs_getch(3X)).
+which is later tested in \fB\%wgetch\fP(3X).
If \fBkeypad\fP has been enabled for the corresponding window,
\fBwgetch\fP returns the key symbol \fBKEY_RESIZE\fP.
At the same time, \fBwgetch\fP calls \fBresizeterm\fP to adjust the
diff --git a/man/curs_terminfo.3x b/man/curs_terminfo.3x
index 62d51a65f..e0b07ae45 100644
--- a/man/curs_terminfo.3x
+++ b/man/curs_terminfo.3x
@@ -514,7 +514,8 @@ .SH NOTES
X/Open notes that \fBvidattr\fP and \fBvidputs\fP may be macros.
.\" ***************************************************************************
.SH EXTENSIONS
-The functions marked as extensions were designed for \fBncurses\fP(3X),
+The functions marked as extensions were designed for
+\fB\%ncurses\fP(3X),
and are not found in SVr4 curses, 4.4BSD curses,
or any other previous version of curses.
.\" ***************************************************************************
diff --git a/man/tic.1m b/man/tic.1m
index b9a50b37e..bf4fa1ee9 100644
--- a/man/tic.1m
+++ b/man/tic.1m
@@ -86,7 +86,7 @@ .SH DESCRIPTION
The \fB@TIC@\fP command translates a \fBterminfo\fP file from source
format into compiled format.
The compiled format is necessary for use with
-the library routines in \fBncurses\fP(3X).
+the library routines in \fB\%ncurses\fP(3X).
.PP
As described in \fBterm\fP(5), the database may be either a directory
tree (one file per terminal entry) or a hashed database (one record per entry).
diff --git a/man/user_caps.5 b/man/user_caps.5
index 7ffd4b31e..9f73606ed 100644
--- a/man/user_caps.5
+++ b/man/user_caps.5
@@ -253,7 +253,7 @@ .SS Recognized capabilities
and that it should ignore the alternate character set capabilities
when the locale uses UTF-8 encoding.
For more information, see the discussion of
-\fBNCURSES_NO_UTF8_ACS\fP in \fBncurses\fP(3X).
+\fBNCURSES_NO_UTF8_ACS\fP in \fB\%ncurses\fP(3X).
.IP
Set this capability to a nonzero value to enable it.
.TP 3
--
2.30.2
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH 02/42] Protect man page topics from hyphenation in cross references.,
G. Branden Robinson <=