ncurses 6.4 - patch 20230617

[ncurses.git] / man / curs_memleaks.3x

diff --git a/man/curs_memleaks.3x b/man/curs_memleaks.3x
index 526b2fca45c6a871f8dbf6803fdc56461c50a2e3..1cd1dc921f321e199b6e26200b8d7a414d29b876 100644 (file)
--- a/man/curs_memleaks.3x
+++ b/man/curs_memleaks.3x
@@ -1,5 +1,5 @@
 .\"***************************************************************************
-.\" Copyright 2019-2020,2021 Thomas E. Dickey                                *
+.\" Copyright 2019-2021,2022 Thomas E. Dickey                                *
 .\" Copyright 2008-2010,2017 Free Software Foundation, Inc.                  *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
@@ -27,12 +27,16 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
-.\" $Id: curs_memleaks.3x,v 1.12 2021/12/25 17:39:16 tom Exp $
-.TH curs_memleaks 3X ""
+.\" $Id: curs_memleaks.3x,v 1.16 2022/06/04 23:33:48 tom Exp $
+.TH curs_memleaks 3X 2022-06-04 "ncurses 6.4" "Library calls"
 .ie \n(.g .ds `` \(lq
 .el       .ds `` ``
 .ie \n(.g .ds '' \(rq
 .el       .ds '' ''
+.de bP
+.ie n  .IP \(bu 4
+.el    .IP \(bu 2
+..
 .na
 .hy 0
 .SH NAME
@@ -43,19 +47,19 @@
 .SH SYNOPSIS
 \fB#include <curses.h>\fP
 .br
-\fBvoid exit_curses(int \fP\fIcode\fP\fB);\fP
+\fBvoid exit_curses(int \fIcode\fB);\fR
 .sp
 \fB#include <term.h>\fP
 .br
-\fBvoid exit_terminfo(int \fP\fIcode\fP\fB);\fP
+\fBvoid exit_terminfo(int \fIcode\fB);\fR
 .sp
 /* deprecated (intentionally not declared in curses.h or term.h) */
 .br
 \fBvoid _nc_freeall(void);\fP
 .br
-\fBvoid _nc_free_and_exit(int \fP\fIcode\fP\fB);\fP
+\fBvoid _nc_free_and_exit(int \fIcode\fB);\fR
 .br
-\fBvoid _nc_free_tinfo(int \fP\fIcode\fP\fB);\fP
+\fBvoid _nc_free_tinfo(int \fIcode\fB);\fR
 .SH DESCRIPTION
 These functions are used to simplify analysis of memory leaks in the ncurses
 library.
@@ -102,5 +106,22 @@ These functions do not return a value.
 .SH PORTABILITY
 These functions are not part of X/Open Curses;
 nor do other implementations of curses provide a similar feature.
+.PP
+In any implementation of X/Open Curses, an application can free part
+of the memory allocated by curses:
+.bP
+The portable part of \fBexit_curses\fP can be freed using \fBdelscreen\fP,
+passing the \fBSCREEN*\fP pointer returned by \fBnewterm\fP.
+.IP
+In some implementations, there is a global variable \fBsp\fP
+which could be used, e.g., if the screen were only initialized
+using \fBinitscr\fP.
+.bP
+The portable part of \fBexit_terminfo\fP can be freed using \fBdel_curterm\fP.
+.IP
+In this case, there is a global variable \fBcur_term\fP which can be
+used as parameter.
 .SH SEE ALSO
+\fBcurs_initscr\fP(3X),
+\fBcurs_terminfo\fP(3X).
 \fBcurses\fP(3X).