X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_printw.3x;h=ee9ea8a37c02a73d7b89078d7b1b924f071cbff5;hp=ea3a6b5857ab20059842c83aa0bc16392d6831b3;hb=HEAD;hpb=d90067f9008bb8338a77c1ed519bc108c275ed04 diff --git a/man/curs_printw.3x b/man/curs_printw.3x index ea3a6b58..282536b3 100644 --- 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 * @@ -27,8 +27,8 @@ .\" 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 @@ -96,16 +96,18 @@ upon failure and 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 -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\*('' @@ -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 -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 @@ -125,14 +128,15 @@ legacy applications. 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 -\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). @@ -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 -.I curses. +.IR curses . Even with this improvement, BSD .I curses