.\"***************************************************************************
-.\" Copyright 2020-2022,2023 Thomas E. Dickey *
+.\" Copyright 2020-2023,2024 Thomas E. Dickey *
.\" Copyright 1998-2013,2015 Free Software Foundation, Inc. *
.\" *
.\" Permission is hereby granted, free of charge, to any person obtaining a *
.\" authorization. *
.\"***************************************************************************
.\"
-.\" $Id: curs_overlay.3x,v 1.36 2023/12/16 21:32:51 tom Exp $
-.TH curs_overlay 3X 2023-12-16 "ncurses 6.4" "Library calls"
+.\" $Id: curs_overlay.3x,v 1.45 2024/05/25 20:10:58 tom Exp $
+.TH curs_overlay 3X 2024-05-25 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls"
.ie \n(.g \{\
.ds `` \(lq
.ds '' \(rq
\fBint \fIdmaxcol\fB, int \fIoverlay\fB);\fR
.fi
.SH DESCRIPTION
-.SS overlay, overwrite
+.SS "overlay, overwrite"
The \fBoverlay\fP and \fBoverwrite\fP routines overlay \fIsrcwin\fP on
top of \fIdstwin\fP.
\fIscrwin\fP and \fIdstwin\fP are not required
X/Open defines no error conditions.
In this implementation,
\fBcopywin\fP,
-\fBoverlay\fP and \fBoverwrite\fP return an error
+\fBoverlay\fP and \fBoverwrite\fP return
+.B ERR
if either of the window pointers are null, or
if some part of the window would be placed off-screen.
.SH NOTES
Note that \fBoverlay\fP and \fBoverwrite\fP may be macros.
.SH PORTABILITY
-These functions are described in the XSI Curses standard, Issue 4,
+These functions are described in X/Open Curses, Issue 4,
which adds \fI\%const\fP qualifiers to the arguments.
It further specifies their behavior in the presence of characters
with multibyte renditions (not yet supported in this implementation).