bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 118/177] man/curs_mouse.3x: Revise "BUGS" section.


From: G. Branden Robinson
Subject: [PATCH 118/177] man/curs_mouse.3x: Revise "BUGS" section.
Date: Mon, 13 Jan 2025 11:33:51 -0600

Content:
* When discussing terminfo capabilities, use both full name and
  cap-code.  (Except where this would be repetitious.)  Identify
  cap-codes as such in narrative.

Markup:
* Favor man(7) font macros over roff(7) font selection escape sequences,
  except for man page cross references (because man/make_sed.sh
  recognizes only certain patterns when rewriting such cross references)
  and terms in the "NAME" section (because the generated edit_man.sh
  script expects font selection escape sequences when scraping terms
  thence to gather names for man page aliases).
---
 man/curs_mouse.3x | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/man/curs_mouse.3x b/man/curs_mouse.3x
index 14c5a8f07..1d51ec24a 100644
--- a/man/curs_mouse.3x
+++ b/man/curs_mouse.3x
@@ -662,7 +662,7 @@ .SH BUGS
 are
 .I not
 ignored in canonical mode if they have been enabled by
-\fB\%mousemask\fP.
+.BR \%mousemask "."
 Instead,
 the
 .I \%xterm
@@ -676,11 +676,16 @@ .SH BUGS
 since they are encoded like function keys.
 Set the terminal's
 .I \%term\%info
-capability \fB\%kmous\fP to \*(``\eE[M\*(''
+capability
+.B \%key_mouse
+.RB ( \%kmous )
+to \*(``\eE[M\*(''
 (the beginning of the response from
 .I \%xterm
 for mouse clicks).
-Other values of \fB\%kmous\fP are permitted under the same assumption,
+Other values of
+.B \%key_mouse
+are permitted under the same assumption,
 that is,
 the report begins with that sequence.
 .PP
@@ -689,11 +694,17 @@ .SH BUGS
 .I \%xterm
 mouse protocol,
 .I \%ncurses
-assumes that if \fB\%kmous\fP is defined in the terminal description,
+assumes that if
+.B \%key_mouse
+.RB ( \%kmous )
+is defined in the terminal description,
 or if the terminal type's primary name or aliases contain the string
 \%\*(``xterm\*('',
 then the terminal may send mouse events.
-The \fB\%kmous\fP capability is checked first,
+.I \%ncurses
+checks the
+.B \%kmous
+cap-code first,
 allowing use of newer
 .I \%xterm
 mouse protocols,
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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