From a1c9e77bebcdf278d9c290a97c82961e159cd896 Mon Sep 17 00:00:00 2001 From: "Thomas E. Dickey" Date: Sun, 18 Feb 2024 01:08:55 +0000 Subject: [PATCH] ncurses 6.4 - patch 20240217 + add vt100+noapp, vt100+noapp+pc, xterm+app+pc, xterm+decedit from xterm #389 -TD + fix inconsistent description of wmouse_trafo() (Debian #1059778). + modify wenclose() to handle pads (Debian #1059783). + improve manpage discussion of mouseinterval() (Debian #1058560). --- NEWS | 9 +- VERSION | 2 +- dist.mk | 4 +- doc/html/man/curs_getch.3x.html | 91 +++++++++--------- doc/html/man/curs_mouse.3x.html | 157 +++++++++++++++++-------------- doc/html/man/ncurses.3x.html | 2 +- doc/html/man/tabs.1.html | 4 +- doc/html/man/terminfo.5.html | 2 +- man/curs_getch.3x | 11 ++- man/curs_mouse.3x | 51 +++++++--- man/manhtml.aliases | 6 +- misc/terminfo.src | 26 ++++- ncurses/base/lib_mouse.c | 30 ++++-- package/debian-mingw/changelog | 4 +- package/debian-mingw64/changelog | 4 +- package/debian/changelog | 4 +- package/mingw-ncurses.nsi | 4 +- package/mingw-ncurses.spec | 2 +- package/ncurses.spec | 2 +- package/ncursest.spec | 2 +- 20 files changed, 253 insertions(+), 164 deletions(-) diff --git a/NEWS b/NEWS index 331b4cda..50fb97b7 100644 --- a/NEWS +++ b/NEWS @@ -26,7 +26,7 @@ -- sale, use or other dealings in this Software without prior written -- -- authorization. -- ------------------------------------------------------------------------------- --- $Id: NEWS,v 1.4078 2024/02/10 23:48:51 tom Exp $ +-- $Id: NEWS,v 1.4081 2024/02/17 22:44:28 tom Exp $ ------------------------------------------------------------------------------- This is a log of changes that ncurses has gone through since Zeyd started @@ -46,6 +46,13 @@ See the AUTHORS file for the corresponding full names. Changes through 1.9.9e did not credit all contributions; it is not possible to add this information. +20240217 + + add vt100+noapp, vt100+noapp+pc, xterm+app+pc, xterm+decedit from + xterm #389 -TD + + fix inconsistent description of wmouse_trafo() (Debian #1059778). + + modify wenclose() to handle pads (Debian #1059783). + + improve manpage discussion of mouseinterval() (Debian #1058560). + 20240210 + compiler-warning fixes, while investigating an optimizer bug in "gcc (MacPorts gcc13 13.2.0_4+stdlib_flag) 13.2.0" diff --git a/VERSION b/VERSION index cd1c0655..43ce880a 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -5:0:10 6.4 20240210 +5:0:10 6.4 20240217 diff --git a/dist.mk b/dist.mk index 8a24cb7d..8a6afe69 100644 --- a/dist.mk +++ b/dist.mk @@ -26,7 +26,7 @@ # use or other dealings in this Software without prior written # # authorization. # ############################################################################## -# $Id: dist.mk,v 1.1597 2024/02/10 12:26:54 tom Exp $ +# $Id: dist.mk,v 1.1598 2024/02/17 11:23:23 tom Exp $ # Makefile for creating ncurses distributions. # # This only needs to be used directly as a makefile by developers, but @@ -38,7 +38,7 @@ SHELL = /bin/sh # These define the major/minor/patch versions of ncurses. NCURSES_MAJOR = 6 NCURSES_MINOR = 4 -NCURSES_PATCH = 20240210 +NCURSES_PATCH = 20240217 # We don't append the patch to the version, since this only applies to releases VERSION = $(NCURSES_MAJOR).$(NCURSES_MINOR) diff --git a/doc/html/man/curs_getch.3x.html b/doc/html/man/curs_getch.3x.html index a005043c..3b04f52f 100644 --- a/doc/html/man/curs_getch.3x.html +++ b/doc/html/man/curs_getch.3x.html @@ -1,7 +1,7 @@ -curs_getch 3x 2023-12-23 ncurses 6.4 Library calls +curs_getch 3x 2024-02-17 ncurses 6.4 Library calls -

curs_getch 3x 2023-12-23 ncurses 6.4 Library calls

+

curs_getch 3x 2024-02-17 ncurses 6.4 Library calls

 curs_getch(3x)                   Library calls                  curs_getch(3x)
 
@@ -290,60 +290,65 @@
                returns ERR if there is no more room in the FIFO.
 
           wgetch
-               returns ERR if the window pointer is null, or  if  its  timeout
-               expires  without  having  any  data,  or  if  the execution was
-               interrupted by a signal (errno will be set to EINTR).
+               returns ERR
 
-       Functions with a "mv" prefix first  perform  a  cursor  movement  using
+               o   if the window pointer is null, or
+
+               o   if its timeout expires without having any data, or
+
+               o   if the execution was interrupted by a signal (errno will be
+                   set to EINTR).
+
+       Functions  with  a  "mv"  prefix  first perform a cursor movement using
        wmove, and return an error if the position is outside the window, or if
        the window pointer is null.

NOTES

-       Use of the escape key by a programmer for a single  character  function
-       is  discouraged, as it will cause a delay of up to one second while the
+       Use  of  the escape key by a programmer for a single character function
+       is discouraged, as it will cause a delay of up to one second while  the
        keypad code looks for a following function-key sequence.
 
-       Some keys may  be  the  same  as  commonly  used  control  keys,  e.g.,
+       Some  keys  may  be  the  same  as  commonly  used  control keys, e.g.,
        KEY_ENTER  versus  control/M,  KEY_BACKSPACE  versus  control/H.   Some
        curses implementations may differ according to whether they treat these
-       control  keys  specially (and ignore the terminfo), or use the terminfo
-       definitions.  ncurses uses the terminfo definition.  If  it  says  that
-       KEY_ENTER  is  control/M,  getch  will  return KEY_ENTER when you press
+       control keys specially (and ignore the terminfo), or use  the  terminfo
+       definitions.   ncurses  uses  the terminfo definition.  If it says that
+       KEY_ENTER is control/M, getch will  return  KEY_ENTER  when  you  press
        control/M.
 
-       Generally, KEY_ENTER denotes the character(s) sent by the Enter key  on
+       Generally,  KEY_ENTER denotes the character(s) sent by the Enter key on
        the numeric keypad:
 
        o   the terminal description lists the most useful keys,
 
-       o   the  Enter  key  on  the regular keyboard is already handled by the
+       o   the Enter key on the regular keyboard is  already  handled  by  the
            standard ASCII characters for carriage-return and line-feed,
 
        o   depending on whether nl or nonl was called, pressing "Enter" on the
-           regular  keyboard may return either a carriage-return or line-feed,
+           regular keyboard may return either a carriage-return or  line-feed,
            and finally
 
        o   "Enter or send" is the standard description for this key.
 
-       When  using  getch,  wgetch,  mvgetch,  or  mvwgetch,   nocbreak   mode
-       (nocbreak)  and  echo  mode (echo) should not be used at the same time.
-       Depending on the state of the tty driver when each character is  typed,
+       When   using   getch,  wgetch,  mvgetch,  or  mvwgetch,  nocbreak  mode
+       (nocbreak) and echo mode (echo) should not be used at  the  same  time.
+       Depending  on the state of the tty driver when each character is typed,
        the program may produce undesirable results.
 
        Note that getch, mvgetch, and mvwgetch may be macros.
 
-       Historically,  the  set  of  keypad  macros  was largely defined by the
-       extremely function-key-rich keyboard of the AT&T  7300,  aka  3B1,  aka
-       Safari  4.   Modern personal computers usually have only a small subset
-       of these.  IBM PC-style consoles typically  support  little  more  than
-       KEY_UP,  KEY_DOWN,  KEY_LEFT,  KEY_RIGHT, KEY_HOME, KEY_END, KEY_NPAGE,
-       KEY_PPAGE, and function keys 1 through 12.   The  Ins  key  is  usually
+       Historically, the set of keypad  macros  was  largely  defined  by  the
+       extremely  function-key-rich  keyboard  of  the AT&T 7300, aka 3B1, aka
+       Safari 4.  Modern personal computers usually have only a  small  subset
+       of  these.   IBM  PC-style  consoles typically support little more than
+       KEY_UP, KEY_DOWN, KEY_LEFT, KEY_RIGHT,  KEY_HOME,  KEY_END,  KEY_NPAGE,
+       KEY_PPAGE,  and  function  keys  1  through 12.  The Ins key is usually
        mapped to KEY_IC.

EXTENSIONS

-       has_key  was designed for ncurses(3x), and is not found in SVr4 curses,
+       has_key was designed for ncurses(3x), and is not found in SVr4  curses,
        4.4BSD curses, or any other previous curses implementation.
 
 
@@ -351,35 +356,35 @@
        Applications employing ncurses extensions should condition their use on
        the visibility of the NCURSES_VERSION preprocessor macro.
 
-       X/Open  Curses,  Issue  4, Version 2, describes getch, wgetch, mvgetch,
-       mvwgetch, and ungetch.  They read  single-byte  characters  only.   The
-       standard  specifies  that  they return ERR on failure, but describes no
+       X/Open Curses, Issue 4, Version 2, describes  getch,  wgetch,  mvgetch,
+       mvwgetch,  and  ungetch.   They  read single-byte characters only.  The
+       standard specifies that they return ERR on failure,  but  describes  no
        failure conditions.
 
-       The echo behavior of these functions on  input  of  KEY_  or  backspace
-       characters   was   not  specified  in  the  SVr4  documentation.   This
+       The  echo  behavior  of  these  functions on input of KEY_ or backspace
+       characters  was  not  specified  in  the  SVr4   documentation.    This
        description is adapted from X/Open Curses.
 
        The behavior of getch and friends in the presence of signal handlers is
        unspecified  in  the  SVr4  documentation  and  X/Open  Curses.   Under
-       historical curses implementations, it varied depending on  whether  the
-       operating  system's  dispatch  of  a  signal  to a handler interrupts a
-       read(2) call in progress or not, and  also  (in  some  implementations)
+       historical  curses  implementations, it varied depending on whether the
+       operating system's dispatch of a  signal  to  a  handler  interrupts  a
+       read(2)  call  in  progress  or not, and also (in some implementations)
        whether an input timeout or non-blocking mode has been set.
 
        KEY_MOUSE is mentioned in X/Open Curses, along with a few related term-
-       info capabilities, but no higher-level functions use the feature.   The
+       info  capabilities, but no higher-level functions use the feature.  The
        implementation in ncurses is an extension.
 
-       KEY_RESIZE  is  an  extension  first  implemented  for ncurses.  NetBSD
+       KEY_RESIZE is an  extension  first  implemented  for  ncurses.   NetBSD
        curses later added this extension.
 
-       Programmers concerned about portability should be prepared  for  either
-       of  two  cases: (a) signal receipt does not interrupt getch; (b) signal
-       receipt interrupts getch and causes it to return ERR with errno set  to
+       Programmers  concerned  about portability should be prepared for either
+       of two cases: (a) signal receipt does not interrupt getch;  (b)  signal
+       receipt  interrupts getch and causes it to return ERR with errno set to
        EINTR.
 
-       The  has_key function is unique to ncurses.  We recommend that any code
+       The has_key function is unique to ncurses.  We recommend that any  code
        using it be conditionalized on the NCURSES_VERSION feature macro.
 
 
@@ -387,12 +392,12 @@
        curses(3x),     curs_inopts(3x),     curs_mouse(3x),     curs_move(3x),
        curs_outopts(3x), curs_refresh(3x), curs_variables(3x), resizeterm(3x)
 
-       Comparable  functions  in  the  wide-character  (ncursesw)  library are
+       Comparable functions  in  the  wide-character  (ncursesw)  library  are
        described in curs_get_wch(3x).
 
 
 
-ncurses 6.4                       2023-12-23                    curs_getch(3x)
+ncurses 6.4                       2024-02-17                    curs_getch(3x)