bug-ncurses
[Top][All Lists]
Advanced

[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

Attachment: signature.asc
Description: PGP signature


reply via email to

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