X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_printw.3x.html;fp=doc%2Fhtml%2Fman%2Fcurs_printw.3x.html;h=cb50d7b7ee445b611ea6f9cecd54e49be8d34176;hp=c38fc4e3e6510153ecec045271900cd1dc2cb95f;hb=c0f109a299a82a33c16bd7af942a12ce9aefaaf0;hpb=3ef920d65fb2d4046096131d868ae8d4bba79d46
diff --git a/doc/html/man/curs_printw.3x.html b/doc/html/man/curs_printw.3x.html
index c38fc4e3..cb50d7b7 100644
--- a/doc/html/man/curs_printw.3x.html
+++ b/doc/html/man/curs_printw.3x.html
@@ -27,7 +27,7 @@
* sale, use or other dealings in this Software without prior written *
* authorization. *
****************************************************************************
- * @Id: curs_printw.3x,v 1.25 2020/02/02 23:34:34 tom Exp @
+ * @Id: curs_printw.3x,v 1.26 2020/03/14 23:48:47 tom Exp @
-->
@@ -91,21 +91,48 @@
the window pointer is null.
+
+ While printw was implemented in 4BSD, it was unused until 4.2BSD (which
+ used it in games). That early version of curses was before the ANSI C
+ standard. It did not use <varargs.h>, though that was available. In
+ 1991 (a couple of years after SVr4 was generally available, and after
+ the C standard was published), other developers updated the library,
+ using <stdarg.h> internally in 4.4BSD curses. Even with this improve-
+ ment, BSD curses did not use function prototypes (or even declare func-
+ tions) in the <curses.h> header until 1992.
+
+ SVr2 documented printw, wprintw tersely as "printf on stdscr" and
+ tersely as "printf on win", respectively.
+
+ SVr3 added mvprintw, and mvwprintw, with a three-line summary saying
+ that they were analogous to printf(3), explaining that the string which
+ would be output from printf(3) would instead be output using waddstr on
+ the given window. SVr3 also added vwprintw, saying that the third pa-
+ rameter is a va_list, defined in <varargs.h>, and referring the reader
+ to the manual pages for varargs and vprintf for detailed descriptions.
+
+ SVr4 added no new variations of printw, but provided for using
+ <varargs.h> or <stdarg.h> to define the va_list type.
+
+ X/Open Curses added vw_printw to replace vwprintw, stating that its
+ va_list definition requires <stdarg.h>.
+
+
- In this implementation, vw_printw and vwprintw are equivalent, to sup-
+ In this implementation, vw_printw and vwprintw are equivalent, to sup-
port legacy applications. However, the latter (vwprintw) is obsolete:
- o The XSI Curses standard, Issue 4 described these functions. The
- function vwprintw is marked TO BE WITHDRAWN, and is to be replaced
+ o The XSI Curses standard, Issue 4 described these functions. The
+ function vwprintw is marked TO BE WITHDRAWN, and is to be replaced
by a function vw_printw using the <stdarg.h> interface.
- o The Single Unix Specification, Version 2 states that vw_printw is
- preferred to vwprintw since the latter requires including
- <varargs.h>, which cannot be used in the same file as <stdarg.h>.
- This implementation uses <stdarg.h> for both, because that header
+ o The Single Unix Specification, Version 2 states that vw_printw is
+ preferred to vwprintw since the latter requires including
+ <varargs.h>, which cannot be used in the same file as <stdarg.h>.
+ This implementation uses <stdarg.h> for both, because that header
is included in <curses.h>.
- o X/Open Curses, Issue 5 (December 2007) marked vwprintw (along with
+ o X/Open Curses, Issue 5 (December 2007) marked vwprintw (along with
vwscanw and the termcap interface) as withdrawn.
@@ -123,6 +150,7 @@
SYNOPSIS
DESCRIPTION
RETURN VALUE
+HISTORY
PORTABILITY
SEE ALSO