ncurses 6.5 - patch 20240622

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

diff --git a/man/curs_touch.3x b/man/curs_touch.3x
index 8fc44abe6b9fd2d0d7af81d225ccb5451593f2d6..ca90dce59b30738bd77b9514f6bb4d59841e7cf7 100644 (file)
--- a/man/curs_touch.3x
+++ b/man/curs_touch.3x
@@ -1,5 +1,5 @@
 .\"***************************************************************************
 .\"***************************************************************************

-.\" Copyright 2018-2022,2023 Thomas E. Dickey                                *
+.\" Copyright 2018-2023,2024 Thomas E. Dickey                                *

 .\" Copyright 1998-2015,2017 Free Software Foundation, Inc.                  *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" Copyright 1998-2015,2017 Free Software Foundation, Inc.                  *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *


@@ -27,8 +27,8 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" $Id: curs_touch.3x,v 1.40 2023/10/07 21:19:07 tom Exp $
-.TH curs_touch 3X 2023-10-07 "ncurses 6.4" "Library calls"
+.\" $Id: curs_touch.3x,v 1.49 2024/05/25 20:10:58 tom Exp $
+.TH curs_touch 3X 2024-05-25 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls"

 .SH NAME
 \fB\%touchwin\fP,
 \fB\%touchline\fP,
 .SH NAME
 \fB\%touchwin\fP,
 \fB\%touchline\fP,


@@ -81,14 +81,15 @@ All routines return the integer \fBERR\fP upon failure and an integer value
 other than \fBERR\fP upon successful completion, unless otherwise noted in the
 preceding routine descriptions.
 .PP
 other than \fBERR\fP upon successful completion, unless otherwise noted in the
 preceding routine descriptions.
 .PP

-X/Open does not define any error conditions.
+X/Open Curses does not specify any error conditions.

 In this implementation
 .RS 3
 .TP 5
 \fBis_linetouched\fP
 In this implementation
 .RS 3
 .TP 5
 \fBis_linetouched\fP

-returns an error
+returns
+.B ERR

 if the window pointer is null, or
 if the window pointer is null, or

-if the line number is outside the window.
+if the line number is outside the window boundaries.

 .IP
 The constant \fBERR\fP is distinct from \fBTRUE\fP and \fBFALSE\fP,
 which are the normal return values of this function.
 .IP
 The constant \fBERR\fP is distinct from \fBTRUE\fP and \fBFALSE\fP,
 which are the normal return values of this function.


@@ -101,10 +102,13 @@ the \fBERR\fP is provided by a macro named \fB\%is_linetouched\fP.
 The actual function returns \fBFALSE\fP when it detects an error.
 .TP 5
 \fBwtouchln\fP
 The actual function returns \fBFALSE\fP when it detects an error.
 .TP 5
 \fBwtouchln\fP

-returns an error
+returns
+.B ERR

 if the window pointer is null, or
 if the window pointer is null, or

-if the line number is outside the window.
+if the line number is outside the window boundaries.

 .RE
 .RE

+.SH NOTES
+All of these routines except \fB\%wtouchln\fP may be macros.

 .SH PORTABILITY
 These functions were introduced by SVr4.
 The Solaris \fIcurses\fP header file,
 .SH PORTABILITY
 These functions were introduced by SVr4.
 The Solaris \fIcurses\fP header file,


@@ -114,10 +118,8 @@ SVr4 \fIcurses\fP does not check the window parameter \fIwin\fP to ensure
 that it is not \fBNULL\fP;
 otherwise this implementation behaves the same as SVr4.
 .PP
 that it is not \fBNULL\fP;
 otherwise this implementation behaves the same as SVr4.
 .PP

-The XSI Curses standard, Issue 4 describes these functions,
+X/Open Curses, Issue 4 describes these functions,

 but defines no error conditions.
 but defines no error conditions.

-.SH NOTES
-All of these routines except \fB\%wtouchln\fP may be macros.

 .SH SEE ALSO
 \fB\%curses\fP(3X),
 \fB\%curs_refresh\fP(3X),
 .SH SEE ALSO
 \fB\%curses\fP(3X),
 \fB\%curs_refresh\fP(3X),