X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_printw.3x.html;h=9ee58d47aaae59ccccf875ddd09eca2c65f0ecaa;hp=88adfe4a47970c202247545efa5ad5c9d2b8147e;hb=5899b5e464ecec4b1613f6fef8cb7b75793c88e3;hpb=02c4e383be9337e73a0e75844dfd1047745adb28;ds=sidebyside diff --git a/doc/html/man/curs_printw.3x.html b/doc/html/man/curs_printw.3x.html index 88adfe4a..9ee58d47 100644 --- a/doc/html/man/curs_printw.3x.html +++ b/doc/html/man/curs_printw.3x.html @@ -1,6 +1,7 @@ @@ -34,7 +35,7 @@
+ 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. @@ -122,6 +150,7 @@