ncurses 6.3 - patch 20211021

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

diff --git a/man/curs_scr_dump.3x b/man/curs_scr_dump.3x
index 9603175414873491271c05a5e4c0f3c3a7e73d0c..faa614466de2d4c6aa44b7271a6d1a7b984379c3 100644 (file)
--- a/man/curs_scr_dump.3x
+++ b/man/curs_scr_dump.3x
@@ -1,5 +1,6 @@
 .\"***************************************************************************
 .\"***************************************************************************

-.\" Copyright (c) 1998-2018,2019 Free Software Foundation, Inc.              *
+.\" Copyright 2018-2020,2021 Thomas E. Dickey                                *
+.\" Copyright 1998-2010,2017 Free Software Foundation, Inc.                  *

 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" copy of this software and associated documentation files (the            *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" copy of this software and associated documentation files (the            *


@@ -26,7 +27,7 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" $Id: curs_scr_dump.3x,v 1.14 2019/11/30 21:06:30 tom Exp $
+.\" $Id: curs_scr_dump.3x,v 1.17 2021/10/20 22:37:48 tom Exp $

 .TH curs_scr_dump 3X ""
 .ie \n(.g .ds `` \(lq
 .el       .ds `` ``
 .TH curs_scr_dump 3X ""
 .ie \n(.g .ds `` \(lq
 .el       .ds `` ``


@@ -48,23 +49,27 @@
 .SH SYNOPSIS
 \fB#include <curses.h>\fR
 .sp
 .SH SYNOPSIS
 \fB#include <curses.h>\fR
 .sp

-\fBint scr_dump(const char *filename);\fR
+\fBint scr_dump(const char *\fP\fIfilename\fP\fB);\fR

 .br
 .br

-\fBint scr_restore(const char *filename);\fR
+\fBint scr_restore(const char *\fP\fIfilename\fP\fB);\fR

 .br
 .br

-\fBint scr_init(const char *filename);\fR
+\fBint scr_init(const char *\fP\fIfilename\fP\fB);\fR

 .br
 .br

-\fBint scr_set(const char *filename);\fR
+\fBint scr_set(const char *\fP\fIfilename\fP\fB);\fR

 .br
 .SH DESCRIPTION
 .br
 .SH DESCRIPTION

+.SS scr_dump
+.PP

 The \fBscr_dump\fR routine dumps the current contents
 of the \fIvirtual screen\fP
 to the file \fIfilename\fR.
 The \fBscr_dump\fR routine dumps the current contents
 of the \fIvirtual screen\fP
 to the file \fIfilename\fR.

+.SS scr_restore

 .PP
 The \fBscr_restore\fR routine sets the \fIvirtual screen\fP to the contents
 of \fIfilename\fR, which must have been written using \fBscr_dump\fR.
 The next call to \fBdoupdate\fR restores
 the \fIphysical screen\fP to the way it looked in the dump file.
 .PP
 The \fBscr_restore\fR routine sets the \fIvirtual screen\fP to the contents
 of \fIfilename\fR, which must have been written using \fBscr_dump\fR.
 The next call to \fBdoupdate\fR restores
 the \fIphysical screen\fP to the way it looked in the dump file.

+.SS scr_init

 .PP
 The \fBscr_init\fR routine reads in the contents of \fIfilename\fR and uses
 them to initialize the \fBcurses\fR data structures about what the terminal
 .PP
 The \fBscr_init\fR routine reads in the contents of \fIfilename\fR and uses
 them to initialize the \fBcurses\fR data structures about what the terminal


@@ -81,6 +86,7 @@ The data is declared invalid
 if the terminfo capabilities \fBrmcup\fR and \fBnrrmc\fR exist, also
 .bP
 if the terminal has been written to since the preceding \fBscr_dump\fR call.
 if the terminfo capabilities \fBrmcup\fR and \fBnrrmc\fR exist, also
 .bP
 if the terminal has been written to since the preceding \fBscr_dump\fR call.

+.SS scr_set

 .PP
 The \fBscr_set\fR routine is a combination of \fBscr_restore\fR and
 \fBscr_init\fR.  It tells the program that the information in \fIfilename\fR is
 .PP
 The \fBscr_set\fR routine is a combination of \fBscr_restore\fR and
 \fBscr_init\fR.  It tells the program that the information in \fIfilename\fR is