diff options
Diffstat (limited to 'man/curs_printw.3x')
| -rw-r--r-- | man/curs_printw.3x | 46 |
1 files changed, 36 insertions, 10 deletions
diff --git a/man/curs_printw.3x b/man/curs_printw.3x index 9918f9d..4d060d7 100644 --- a/man/curs_printw.3x +++ b/man/curs_printw.3x @@ -1,5 +1,6 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2006,2010 Free Software Foundation, Inc. * +.\" Copyright 2018-2019,2020 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 * @@ -26,8 +27,16 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_printw.3x,v 1.20 2010/12/04 18:40:45 tom Exp $ +.\" $Id: curs_printw.3x,v 1.25 2020/02/02 23:34:34 tom Exp $ .TH curs_printw 3X "" +.ie \n(.g .ds `` \(lq +.el .ds `` `` +.ie \n(.g .ds '' \(rq +.el .ds '' '' +.de bP +.ie n .IP \(bu 4 +.el .IP \(bu 2 +.. .na .hy 0 .SH NAME @@ -49,13 +58,15 @@ .br \fBint mvwprintw(WINDOW *win, int y, int x, const char *fmt, ...);\fR .br -\fBint vwprintw(WINDOW *win, const char *fmt, va_list varglist);\fR -.br \fBint vw_printw(WINDOW *win, const char *fmt, va_list varglist);\fR +.sp +/* obsolete */ .br +\fBint vwprintw(WINDOW *win, const char *fmt, va_list varglist);\fR .SH DESCRIPTION The \fBprintw\fR, \fBwprintw\fR, \fBmvprintw\fR and \fBmvwprintw\fR -routines are analogous to \fBprintf\fR [see \fBprintf\fR(3)]. In +routines are analogous to \fBprintf\fR [see \fBprintf\fR(3)]. +In effect, the string that would be output by \fBprintf\fR is output instead as though \fBwaddstr\fR were used on the given window. .PP @@ -75,18 +86,33 @@ an error may be returned if it cannot allocate enough memory for the buffer used to format the results. It will return an error if the window pointer is null. .PP -Functions with a "mv" prefix first perform a cursor movement using +Functions with a \*(``mv\*('' prefix first perform a cursor movement using \fBwmove\fP, and return an error if the position is outside the window, or if the window pointer is null. .SH PORTABILITY -The XSI Curses standard, Issue 4 describes these functions. The function +In this implementation, \fBvw_printw\fP and \fBvwprintw\fP are equivalent, +to support legacy applications. +However, the latter (\fBvwprintw\fP) is obsolete: +.bP +The XSI Curses standard, Issue 4 described these functions. +The function \fBvwprintw\fR is marked TO BE WITHDRAWN, and is to be replaced by a function \fBvw_printw\fR using the \fB<stdarg.h>\fR interface. +.bP The Single Unix Specification, Version 2 states that \fBvw_printw\fR is preferred to \fBvwprintw\fR since the latter requires including \fB<varargs.h>\fR, which cannot be used in the same file as \fB<stdarg.h>\fR. -This implementation uses \fB<stdarg.h>\fR for both, because that header -is included in \fB<curses.h\fR>. +This implementation uses \fB<stdarg.h>\fR for both, +because that header is included in \fB<curses.h\fR>. +.bP +X/Open Curses, Issue 5 (December 2007) marked \fBvwprintw\fP (along with +\fBvwscanw\fP and the termcap interface) as withdrawn. .SH SEE ALSO -\fBcurses\fR(3X), \fBprintf\fR(3), \fBvprintf(3)\fR +.na +\fBcurses\fR(3X), +\fBcurs_addstr\fR(3X), +\fBcurs_scanw\fR(3X), +\fBcurs_termcap\fP(3X), +\fBprintf\fR(3), +\fBvprintf\fR(3). |