From: Thomas E. Dickey Date: Sun, 2 Jan 2022 01:07:07 +0000 (+0000) Subject: ncurses 6.3 - patch 20220101 X-Git-Tag: v6.4~53 X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=commitdiff_plain;h=3b56f70388c2ae65421ff54b45be77a479e79aea ncurses 6.3 - patch 20220101 + add section on releasing memory to curs_termcap.3x and curs_terminfo.3x manpages. --- diff --git a/Ada95/package/debian/copyright b/Ada95/package/debian/copyright index 897961d0..6e033f7d 100644 --- a/Ada95/package/debian/copyright +++ b/Ada95/package/debian/copyright @@ -4,7 +4,7 @@ Current ncurses maintainer: Thomas Dickey ------------------------------------------------------------------------------- Files: * -Copyright: 2017-2020,2021 by Thomas E. Dickey +Copyright: 2017-2021,2022 by Thomas E. Dickey Copyright: 1998-2016,2017 Free Software Foundation, Inc. Licence: X11 diff --git a/COPYING b/COPYING index 3a229753..57b2be47 100644 --- a/COPYING +++ b/COPYING @@ -1,4 +1,4 @@ -Copyright 2018-2020,2021 Thomas E. Dickey +Copyright 2018-2021,2022 Thomas E. Dickey Copyright 1998-2017,2018 Free Software Foundation, Inc. Permission is hereby granted, free of charge, to any person obtaining a @@ -26,4 +26,4 @@ sale, use or other dealings in this Software without prior written authorization. -- vile:txtmode fc=72 --- $Id: COPYING,v 1.10 2021/01/01 09:54:30 tom Exp $ +-- $Id: COPYING,v 1.11 2022/01/01 11:47:50 tom Exp $ diff --git a/NEWS b/NEWS index 8f29068e..69229618 100644 --- a/NEWS +++ b/NEWS @@ -1,5 +1,5 @@ ------------------------------------------------------------------------------- --- Copyright 2018-2020,2021 Thomas E. Dickey -- +-- Copyright 2018-2021,2022 Thomas E. Dickey -- -- Copyright 1998-2017,2018 Free Software Foundation, Inc. -- -- -- -- Permission is hereby granted, free of charge, to any person obtaining a -- @@ -26,7 +26,7 @@ -- sale, use or other dealings in this Software without prior written -- -- authorization. -- ------------------------------------------------------------------------------- --- $Id: NEWS,v 1.3761 2021/12/26 00:29:27 tom Exp $ +-- $Id: NEWS,v 1.3764 2022/01/01 23:59:36 tom Exp $ ------------------------------------------------------------------------------- This is a log of changes that ncurses has gone through since Zeyd started @@ -46,6 +46,10 @@ 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. +20220101 + + add section on releasing memory to curs_termcap.3x and + curs_terminfo.3x manpages. + 20211225 + improve markup, e.g., for external manpage links in the manpages (prompted by report by Helge Kreutzmann). diff --git a/VERSION b/VERSION index 4d9112c8..4a243ffc 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -5:0:10 6.3 20211225 +5:0:10 6.3 20220101 diff --git a/dist.mk b/dist.mk index a6ce7130..f1d77c47 100644 --- a/dist.mk +++ b/dist.mk @@ -1,5 +1,5 @@ ############################################################################## -# Copyright 2018-2020,2021 Thomas E. Dickey # +# Copyright 2018-2021,2022 Thomas E. Dickey # # Copyright 1998-2017,2018 Free Software Foundation, Inc. # # # # Permission is hereby granted, free of charge, to any person obtaining a # @@ -26,7 +26,7 @@ # use or other dealings in this Software without prior written # # authorization. # ############################################################################## -# $Id: dist.mk,v 1.1458 2021/12/25 22:11:07 tom Exp $ +# $Id: dist.mk,v 1.1460 2022/01/01 11:48:38 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 = 3 -NCURSES_PATCH = 20211225 +NCURSES_PATCH = 20220101 # 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/adacurses6-config.1.html b/doc/html/man/adacurses6-config.1.html index 97937fe5..c15a80a7 100644 --- a/doc/html/man/adacurses6-config.1.html +++ b/doc/html/man/adacurses6-config.1.html @@ -126,7 +126,7 @@

SEE ALSO

        curses(3x)
 
-       This describes ncurses version 6.3 (patch 20211225).
+       This describes ncurses version 6.3 (patch 20220101).
 
 
 
diff --git a/doc/html/man/captoinfo.1m.html b/doc/html/man/captoinfo.1m.html
index f395d62d..b0db730e 100644
--- a/doc/html/man/captoinfo.1m.html
+++ b/doc/html/man/captoinfo.1m.html
@@ -199,7 +199,7 @@

SEE ALSO

        infocmp(1m), curses(3x), terminfo(5)
 
-       This describes ncurses version 6.3 (patch 20211225).
+       This describes ncurses version 6.3 (patch 20220101).

AUTHOR

diff --git a/doc/html/man/clear.1.html b/doc/html/man/clear.1.html
index baf41e32..b9d0b440 100644
--- a/doc/html/man/clear.1.html
+++ b/doc/html/man/clear.1.html
@@ -150,7 +150,7 @@

SEE ALSO

        tput(1), terminfo(5), xterm(1).
 
-       This describes ncurses version 6.3 (patch 20211225).
+       This describes ncurses version 6.3 (patch 20220101).
 
 
 
diff --git a/doc/html/man/curs_termcap.3x.html b/doc/html/man/curs_termcap.3x.html
index 08803073..5c4aaa4c 100644
--- a/doc/html/man/curs_termcap.3x.html
+++ b/doc/html/man/curs_termcap.3x.html
@@ -1,6 +1,6 @@
 
 
 
@@ -76,7 +76,7 @@
        been compiled.
 
 
-

INITIALIZATION

+

Initialization

        The tgetent routine loads the entry for name.  It returns:
 
           1  on success,
@@ -100,7 +100,7 @@
               ing.
 
 
-

CAPABILITY VALUES

+

Capability Values

        The tgetflag routine gets the boolean entry for id, or zero  if  it  is
        not available.
 
@@ -129,7 +129,7 @@
        and tgetstr are compared in lookups.
 
 
-

FORMATTING CAPABILITIES

+

Formatting Capabilities

        The tgoto routine expands the given capability using the parameters.
 
        o   Because  the  capability may have padding characters, the output of
@@ -157,7 +157,7 @@
        It can retrieve capabilities by either termcap or terminfo name.
 
 
-

GLOBAL VARIABLES

+

Global Variables

        The  variables PC, UP and BC are set by tgetent to the terminfo entry's
        data for pad_char, cursor_up and backspace_if_not_bs, respectively.  UP
        is  not used by ncurses.  PC is used in the tdelay_output function.  BC
@@ -165,6 +165,29 @@
        in a system-specific coding to reflect the terminal speed.
 
 
+

Releasing Memory

+       The  termcap  functions  provide  no  means for freeing memory, because
+       legacy termcap implementations used only the buffer areas  provided  by
+       the  caller  via tgetent and tgetstr.  Those buffers are unused in ter-
+       minfo.
+
+       On the other hand, terminfo allocates memory.  It uses setupterm to re-
+       trieve the data used by tgetent and the functions which return capabil-
+       ity values such as tgetstr.  One could use
+
+            del_curterm(cur_term);
+
+
+       to free this memory, but  there  is  an  additional  complication  with
+       ncurses.   It uses a fixed-size pool of storage locations, one per set-
+       ting of the TERM variable when tgetent is called.  The  screen(1)  pro-
+       gram relies upon this arrangement, to improve its performance.
+
+       An  application  which  uses only the low-level termcap functions could
+       free the memory using del_curterm, because the pool is freed using oth-
+       er functions (see curs_memleaks(3x)).
+
+

RETURN VALUE

        Except  where  explicitly noted, routines that return an integer return
        ERR upon failure and OK (SVr4 only specifies "an  integer  value  other
@@ -322,10 +345,11 @@
 
  • SYNOPSIS
    • 
 
  • DESCRIPTION
 
 
    • 
 
  • RETURN VALUE
    • 
diff --git a/doc/html/man/curs_terminfo.3x.html b/doc/html/man/curs_terminfo.3x.html
index b052f963..283fa474 100644
--- a/doc/html/man/curs_terminfo.3x.html
+++ b/doc/html/man/curs_terminfo.3x.html
@@ -1,6 +1,6 @@