ncurses 6.5 - patch 20240504

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

diff --git a/man/curs_printw.3x b/man/curs_printw.3x
index ea3a6b5857ab20059842c83aa0bc16392d6831b3..282536b363e0a7dc59fa5fb2b41afc24f939e6cc 100644 (file)
--- a/man/curs_printw.3x
+++ b/man/curs_printw.3x
@@ -1,5 +1,5 @@
 .\"***************************************************************************
 .\"***************************************************************************

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

 .\" Copyright 1998-2010,2017 Free Software Foundation, Inc.                  *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" Copyright 1998-2010,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_printw.3x,v 1.45 2023/12/18 00:03:28 tom Exp $
-.TH curs_printw 3X 2023-12-17 "ncurses 6.4" "Library calls"
+.\" $Id: curs_printw.3x,v 1.53 2024/04/20 19:18:18 tom Exp $
+.TH curs_printw 3X 2024-04-20 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls"

 .ie \n(.g \{\
 .ds `` \(lq
 .ds '' \(rq
 .ie \n(.g \{\
 .ds `` \(lq
 .ds '' \(rq


@@ -96,16 +96,18 @@ upon failure and
 upon success.
 .PP
 In
 upon success.
 .PP
 In

-.I \%ncurses,
+.IR \%ncurses ,

 failure occurs if the library cannot allocate enough memory for the
 buffer into which the output is formatted,
 or if the window pointer
 .I win
 is null.
 .PP
 failure occurs if the library cannot allocate enough memory for the
 buffer into which the output is formatted,
 or if the window pointer
 .I win
 is null.
 .PP

-Functions with a \*(``mv\*('' prefix first perform a cursor movement
-using \fB\%wmove\fP,
-and fail if the position is outside the window.
+Functions prefixed with \*(``mv\*('' first perform cursor movement and
+fail if the position
+.RI ( y ,
+.IR x )
+is outside the window boundaries.

 .SH NOTES
 No wide character counterpart functions are defined by the
 \*(``wide\*(''
 .SH NOTES
 No wide character counterpart functions are defined by the
 \*(``wide\*(''


@@ -116,7 +118,8 @@ To format and write a wide-character string to a
 window,
 consider using \fI\%swprintf\fP(3) and \fB\%waddwstr\fP(3X) or similar.
 .SH PORTABILITY
 window,
 consider using \fI\%swprintf\fP(3) and \fB\%waddwstr\fP(3X) or similar.
 .SH PORTABILITY

-X/Open Curses, Issue 4, describes these functions.
+X/Open Curses,
+Issue 4 describes these functions.

 It specifies no error conditions for them.
 .PP
 .I \%ncurses
 It specifies no error conditions for them.
 .PP
 .I \%ncurses


@@ -125,14 +128,15 @@ legacy applications.
 However,
 the latter is obsolete.
 .bP
 However,
 the latter is obsolete.
 .bP

-X/Open Curses, Issue 4, Version 2 (1996),
+X/Open Curses,
+Issue 4 Version 2 (1996),

 marked \fB\%vwprintw\fP as requiring \fI\%varargs.h\fP and
 \*(``TO BE WITHDRAWN\*('',
 and specified \fB\%vw_printw\fP using the \fI\%stdarg.h\fP interface.
 .bP
 X/Open Curses, Issue 5, Draft 2
 (December 2007) marked \fBvwprintw\fP (along with
 marked \fB\%vwprintw\fP as requiring \fI\%varargs.h\fP and
 \*(``TO BE WITHDRAWN\*('',
 and specified \fB\%vw_printw\fP using the \fI\%stdarg.h\fP interface.
 .bP
 X/Open Curses, Issue 5, Draft 2
 (December 2007) marked \fBvwprintw\fP (along with

-\fBvwscanw\fP and the termcap interface) as withdrawn.
+\fBvwscanw\fP and the \fItermcap\fP interface) as withdrawn.

 After incorporating review comments,
 this became
 X/Open Curses, Issue 7 (2009).
 After incorporating review comments,
 this became
 X/Open Curses, Issue 7 (2009).


@@ -160,7 +164,7 @@ In 1991
 and after the C standard was published),
 other developers updated the library,
 using \fI\%stdarg.h\fP internally in 4.4BSD
 and after the C standard was published),
 other developers updated the library,
 using \fI\%stdarg.h\fP internally in 4.4BSD

-.I curses.
+.IR curses .

 Even with this improvement,
 BSD
 .I curses
 Even with this improvement,
 BSD
 .I curses