From 1dd25cc0259e0683290fe889707b04979b5fda0a Mon Sep 17 00:00:00 2001 From: "Thomas E. Dickey" Date: Sun, 4 Dec 2016 02:16:58 +0000 Subject: [PATCH] ncurses 6.0 - patch 20161203 + improve discussion of field validation in form_driver.3x manual page. + update curs_trace.3x manual page. --- NEWS | 6 +- VERSION | 2 +- dist.mk | 4 +- doc/html/man/adacurses6-config.1.html | 2 +- doc/html/man/captoinfo.1m.html | 2 +- doc/html/man/clear.1.html | 2 +- doc/html/man/curs_trace.3x.html | 92 +++++++++++++++++---------- doc/html/man/form.3x.html | 2 +- doc/html/man/form_driver.3x.html | 76 ++++++++++++++++------ doc/html/man/infocmp.1m.html | 2 +- doc/html/man/infotocap.1m.html | 2 +- doc/html/man/menu.3x.html | 2 +- doc/html/man/ncurses.3x.html | 2 +- doc/html/man/ncurses6-config.1.html | 2 +- doc/html/man/panel.3x.html | 2 +- doc/html/man/tabs.1.html | 2 +- doc/html/man/terminfo.5.html | 2 +- doc/html/man/tic.1m.html | 2 +- doc/html/man/toe.1m.html | 2 +- doc/html/man/tput.1.html | 2 +- doc/html/man/tset.1.html | 2 +- man/curs_trace.3x | 77 +++++++++++++--------- man/form_driver.3x | 33 +++++++++- package/debian-mingw/changelog | 4 +- package/debian-mingw64/changelog | 4 +- package/debian/changelog | 4 +- package/mingw-ncurses.nsi | 4 +- package/mingw-ncurses.spec | 2 +- package/ncurses.spec | 2 +- progs/tic.c | 4 +- test/README | 59 ++++++++--------- 31 files changed, 260 insertions(+), 145 deletions(-) diff --git a/NEWS b/NEWS index 3bfbfdee..6470e10b 100644 --- a/NEWS +++ b/NEWS @@ -25,7 +25,7 @@ -- sale, use or other dealings in this Software without prior written -- -- authorization. -- ------------------------------------------------------------------------------- --- $Id: NEWS,v 1.2703 2016/11/27 01:41:10 tom Exp $ +-- $Id: NEWS,v 1.2705 2016/12/04 01:02:15 tom Exp $ ------------------------------------------------------------------------------- This is a log of changes that ncurses has gone through since Zeyd started @@ -45,6 +45,10 @@ See the AUTHORS file for the corresponding full names. Changes through 1.9.9e did not credit all contributions; it is not possible to add this information. +20161203 + + improve discussion of field validation in form_driver.3x manual page. + + update curs_trace.3x manual page. + 20161126 + modify linux-16color to not mask dim, standout or reverse with the ncv capability -TD diff --git a/VERSION b/VERSION index de15c5bb..34955bfb 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -5:0:9 6.0 20161126 +5:0:9 6.0 20161203 diff --git a/dist.mk b/dist.mk index d4c654c3..05f8869d 100644 --- a/dist.mk +++ b/dist.mk @@ -25,7 +25,7 @@ # use or other dealings in this Software without prior written # # authorization. # ############################################################################## -# $Id: dist.mk,v 1.1134 2016/11/21 22:34:14 tom Exp $ +# $Id: dist.mk,v 1.1135 2016/12/03 16:11:11 tom Exp $ # Makefile for creating ncurses distributions. # # This only needs to be used directly as a makefile by developers, but @@ -37,7 +37,7 @@ SHELL = /bin/sh # These define the major/minor/patch versions of ncurses. NCURSES_MAJOR = 6 NCURSES_MINOR = 0 -NCURSES_PATCH = 20161126 +NCURSES_PATCH = 20161203 # We don't append the patch to the version, since this only applies to releases VERSION = $(NCURSES_MAJOR).$(NCURSES_MINOR) diff --git a/doc/html/man/adacurses6-config.1.html b/doc/html/man/adacurses6-config.1.html index c65cb7c9..da09cbbe 100644 --- a/doc/html/man/adacurses6-config.1.html +++ b/doc/html/man/adacurses6-config.1.html @@ -131,7 +131,7 @@

SEE ALSO

        curses(3x)
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).
 
 
 
diff --git a/doc/html/man/captoinfo.1m.html b/doc/html/man/captoinfo.1m.html
index 4f49b21a..8d9ef150 100644
--- a/doc/html/man/captoinfo.1m.html
+++ b/doc/html/man/captoinfo.1m.html
@@ -198,7 +198,7 @@

SEE ALSO

        infocmp(1m), curses(3x), terminfo(5)
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).

AUTHOR

diff --git a/doc/html/man/clear.1.html b/doc/html/man/clear.1.html
index 1af92704..a779802c 100644
--- a/doc/html/man/clear.1.html
+++ b/doc/html/man/clear.1.html
@@ -135,7 +135,7 @@

SEE ALSO

        tput(1), terminfo(5)
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).
 
 
 
diff --git a/doc/html/man/curs_trace.3x.html b/doc/html/man/curs_trace.3x.html
index c066797f..e8ae83b9 100644
--- a/doc/html/man/curs_trace.3x.html
+++ b/doc/html/man/curs_trace.3x.html
@@ -26,7 +26,7 @@
   * sale, use or other dealings in this Software without prior written       *
   * authorization.                                                           *
   ****************************************************************************
-  * @Id: curs_trace.3x,v 1.14 2016/10/15 17:26:09 tom Exp @
+  * @Id: curs_trace.3x,v 1.16 2016/12/03 23:53:23 tom Exp @
 -->
 
 
@@ -46,27 +46,30 @@

NAME

-       _tracef, _tracedump, _traceattr, _traceattr2,
-       _nc_tracebits, _tracecchar_t, _tracecchar_t2, _tracechar,
-       _tracechtype, _tracechtype2, _tracemouse, trace - curses
-       debugging routines
+       trace, _tracef, _traceattr, _traceattr2, _tracecchar_t,
+       _tracecchar_t2, _tracechar, _tracechtype, _tracechtype2,
+       _nc_tracebits, _tracedump, _tracemouse - curses debugging
+       routines

SYNOPSIS

        #include <curses.h>
 
+       void trace(const unsigned int param);
+
        void _tracef(const char *format, ...);
-       void _tracedump(const char *label, WINDOW *win);
+
        char *_traceattr(attr_t attr);
        char *_traceattr2(int buffer, chtype ch);
-       char *_nc_tracebits(void);
-       char * _tracecchar_t(const cchar_t *string);
-       char * _tracecchar_t2(int buffer, const cchar_t *string);
+       char *_tracecchar_t(const cchar_t *string);
+       char *_tracecchar_t2(int buffer, const cchar_t *string);
        char *_tracechar(int ch);
        char *_tracechtype(chtype ch);
        char *_tracechtype2(int buffer, chtype ch);
+
+       void _tracedump(const char *label, WINDOW *win);
+       char *_nc_tracebits(void);
        char *_tracemouse(const MEVENT *event);
-       void trace(const unsigned int param);

DESCRIPTION

@@ -79,6 +82,8 @@
        are only available with the  wide-character  configuration
        of the libraries.
 
+
+

Functions

        The principal parts of this interface are
 
        o   trace,  which  selectively  enables  different tracing
@@ -87,13 +92,32 @@
        o   _tracef, which writes  formatted  data  to  the  trace
            file.
 
-       Calling  trace  with  a  nonzero  parameter opens the file
-       trace in the current directory for output.  The  parameter
-       is formed by OR'ing values from the list of TRACE_xxx def-
-       initions in <curses.h>.  These include:
+       Calling  trace  with  a nonzero parameter creates the file
+       trace in the current directory for output.   If  the  file
+       already exists, no tracing is done.
+
+       The  other  functions either return a pointer to a string-
+       area (allocated by the corresponding function), or  return
+       no  value (such as _tracedump, which implements the screen
+       dump for TRACE_UPDATE).  The caller should not free  these
+       strings,  since  the  allocation  is  reused on successive
+       calls.  To work around the problem of a single string-area
+       per  function, some use a buffer-number parameter, telling
+       the library to allocate additional string-areas.
+
+
+

Trace Parameter

+       The trace parameter is formed by OR'ing  values  from  the
+       list  of  TRACE_xxx  definitions in <curses.h>.  These in-
+       clude:
 
        TRACE_DISABLE
-            turn off tracing.
+            turn off tracing by passing a zero parameter.
+
+            The library flushes the output file, but  retains  an
+            open file-descriptor to the trace file so that it can
+            resume tracing later if a nonzero parameter is passed
+            to the trace function.
 
        TRACE_TIMES
             trace user and system times of updates.
@@ -111,8 +135,8 @@
             trace all character outputs.
 
        TRACE_ORDINARY
-            trace all update actions.  The  old  and  new  screen
-            contents  are  written to the trace file for each re-
+            trace  all  update  actions.   The old and new screen
+            contents are written to the trace file for  each  re-
             fresh.
 
        TRACE_CALLS
@@ -141,28 +165,21 @@
             trace changes to video attributes and colors.
 
        TRACE_MAXIMUM
-            maximum  trace  level,  enables  all  of the separate
+            maximum trace level,  enables  all  of  the  separate
             trace features.
 
-       Some tracing features are enabled whenever the  trace  pa-
-       rameter  is nonzero.  Some features overlap.  The specific
+       Some  tracing  features are enabled whenever the trace pa-
+       rameter is nonzero.  Some features overlap.  The  specific
        names are used as a guideline.
 
-       The other functions either return a pointer to  a  string-
-       area  (allocated by the corresponding function), or return
-       no value (such as _tracedump, which implements the  screen
-       dump  for TRACE_UPDATE).  The caller should not free these
-       strings, since the  allocation  is  reused  on  successive
-       calls.  To work around the problem of a single string-area
-       per function, some use a buffer-number parameter,  telling
-       the library to allocate additional string-areas.
 
+

Initialization

        These  functions check the NCURSES_TRACE environment vari-
        able, to set the tracing feature as if trace was called:
 
-              filter, initscr, new_prescr, newterm, nofilter,
-              restartterm, ripoffline, setupterm, slk_init, tge-
-              tent, use_env, use_extended_names, use_tioctl
+           filter, initscr, new_prescr, newterm, nofilter,
+           restartterm, ripoffline, setupterm, slk_init, tgetent,
+           use_env, use_extended_names, use_tioctl

RETURN VALUE

@@ -176,6 +193,11 @@
        undocumented  features,  but  they are not compatible with
        ncurses.
 
+       A few functions are not provided when symbol versioning is
+       used:
+
+           _nc_tracebits, _tracedump, _tracemouse
+

SEE ALSO

        curses(3x).
@@ -188,7 +210,13 @@

Field validation

+       The form library makes updates to  the  window  associated
+       with  form  fields  rather than directly to the field buf-
+       fers.
+
+       The form driver provides low-level control over updates to
+       the  form fields.  The form driver also provides for vali-
+       dating modified fields to ensure that  the  contents  meet
+       whatever  constraints  an  application  may  attach  using
+       set_field_type.
+
+       You can validate a field without making any changes to  it
+       using  REQ_VALIDATION.   The  form driver also validates a
+       field in these cases:
+
+       o   a call to set_current_field attempts to move to a dif-
+           ferent field.
+
+       o   a  call to set_current_page attempts to move to a dif-
+           ferent page of the form.
+
+       o   a request attempts to move to a different field.
+
+       o   a request attempts to move to a different page of  the
+           form.
+
+       In each case, the move fails if the field is invalid.
+
+       If the modified field is valid, the form driver copies the
+       modified data from the window associated with the field to
+       the field buffer.
+
+

Mouse handling

-       If the second argument is the KEY_MOUSE special  key,  the
+       If  the  second argument is the KEY_MOUSE special key, the
        associated mouse event is translated into one of the above
-       pre-defined requests.  Currently only clicks in  the  user
-       window  (e.g., inside the form display area or the decora-
+       pre-defined  requests.   Currently only clicks in the user
+       window (e.g., inside the form display area or the  decora-
        tion window) are handled.
 
        If you click above the display region of the form:
@@ -179,33 +212,33 @@
 
           a REQ_LAST_FIELD is generated for a triple-click.
 
-       If you click at an field inside the display  area  of  the
+       If  you  click  at an field inside the display area of the
        form:
 
           o   the form cursor is positioned to that field.
 
-          o   If  you  double-click  a  field, the form cursor is
-              positioned to that field and  E_UNKNOWN_COMMAND  is
+          o   If you double-click a field,  the  form  cursor  is
+              positioned  to  that field and E_UNKNOWN_COMMAND is
               returned.  This return value makes sense, because a
-              double click usually means that  an  field-specific
-              action  should be returned.  It is exactly the pur-
-              pose of this return value to signal that an  appli-
+              double  click  usually means that an field-specific
+              action should be returned.  It is exactly the  pur-
+              pose  of this return value to signal that an appli-
               cation specific command should be executed.
 
-          o   If   a   translation   into  a  request  was  done,
+          o   If  a  translation  into  a   request   was   done,
               form_driver returns the result of this request.
 
-       If you clicked outside the user window or the mouse  event
-       could   not   be   translated   into  a  form  request  an
+       If  you clicked outside the user window or the mouse event
+       could  not  be  translated  into   a   form   request   an
        E_REQUEST_DENIED is returned.

Application-defined commands

        If the second argument is neither printable nor one of the
-       above  pre-defined form requests, the driver assumes it is
+       above pre-defined form requests, the driver assumes it  is
        an application-specific command and returns E_UNKNOWN_COM-
        MAND.  Application-defined commands should be defined rel-
-       ative to MAX_COMMAND, the  maximum  value  of  these  pre-
+       ative  to  MAX_COMMAND,  the  maximum  value of these pre-
        defined requests.
 
 
@@ -215,7 +248,7 @@
        E_OK The routine succeeded.
 
        E_BAD_ARGUMENT
-            Routine  detected  an incorrect or out-of-range argu-
+            Routine detected an incorrect or  out-of-range  argu-
             ment.
 
        E_BAD_STATE
@@ -239,7 +272,9 @@

SEE ALSO

-       curses(3x), form(3x), form_variables(3x), curs_getch(3x).
+       curses(3x),        form(3x),        form_field_buffer(3x),
+       form_field_validation(3x),  form_fieldtype(3x), form_vari-
+       ables(3x), curs_getch(3x).

NOTES

@@ -248,12 +283,12 @@

PORTABILITY

-       These routines emulate the System V forms  library.   They
+       These  routines  emulate the System V forms library.  They
        were not supported on Version 7 or BSD versions.

AUTHORS

-       Juergen  Pfeifer.   Manual  pages  and  adaptation for new
+       Juergen Pfeifer.  Manual  pages  and  adaptation  for  new
        curses by Eric S. Raymond.
 
 
@@ -269,6 +304,7 @@
 
  • form_driver
    • 
 
  • form_driver_w
    • 
 
  • Form-driver requests
    • 
+
  • Field validation
    • 
 
  • Mouse handling
    • 
 
  • Application-defined commands
    • 
 
diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html
index e99f3203..9ea09e81 100644
--- a/doc/html/man/infocmp.1m.html
+++ b/doc/html/man/infocmp.1m.html
@@ -478,7 +478,7 @@
 
        http://invisible-island.net/ncurses/tctest.html
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).

    AUTHOR

    diff --git a/doc/html/man/infotocap.1m.html b/doc/html/man/infotocap.1m.html
index 54b2f1ad..9f623760 100644
--- a/doc/html/man/infotocap.1m.html
+++ b/doc/html/man/infotocap.1m.html
@@ -88,7 +88,7 @@

    SEE ALSO

            curses(3x), tic(1m), infocmp(1m), terminfo(5)
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).

    AUTHOR

    diff --git a/doc/html/man/menu.3x.html b/doc/html/man/menu.3x.html
index bad4c5d3..05c9ed62 100644
--- a/doc/html/man/menu.3x.html
+++ b/doc/html/man/menu.3x.html
@@ -217,7 +217,7 @@
        curses(3x) and related pages whose names begin "menu_" for
        detailed descriptions of the entry points.
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).
 
 
 
diff --git a/doc/html/man/ncurses.3x.html b/doc/html/man/ncurses.3x.html
index b10d2017..19952bbe 100644
--- a/doc/html/man/ncurses.3x.html
+++ b/doc/html/man/ncurses.3x.html
@@ -60,7 +60,7 @@
        sonable optimization.  This implementation is "new curses"
        (ncurses) and is the approved replacement for 4.4BSD clas-
        sic  curses,  which has been discontinued.  This describes
-       ncurses version 6.0 (patch 20161119).
+       ncurses version 6.0 (patch 20161203).
 
        The ncurses library emulates the curses library of  System
        V  Release  4  UNIX,  and  XPG4 (X/Open Portability Guide)
diff --git a/doc/html/man/ncurses6-config.1.html b/doc/html/man/ncurses6-config.1.html
index 28fc6821..c0539d40 100644
--- a/doc/html/man/ncurses6-config.1.html
+++ b/doc/html/man/ncurses6-config.1.html
@@ -114,7 +114,7 @@

    SEE ALSO

            curses(3x)
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).
 
 
 
diff --git a/doc/html/man/panel.3x.html b/doc/html/man/panel.3x.html
index 10741b46..b7cd6a28 100644
--- a/doc/html/man/panel.3x.html
+++ b/doc/html/man/panel.3x.html
@@ -208,7 +208,7 @@

    SEE ALSO

            curses(3x), curs_variables(3x),
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).

    AUTHOR

    diff --git a/doc/html/man/tabs.1.html b/doc/html/man/tabs.1.html
index 290f9978..8771059b 100644
--- a/doc/html/man/tabs.1.html
+++ b/doc/html/man/tabs.1.html
@@ -164,7 +164,7 @@

    SEE ALSO

            tset(1), infocmp(1m), curses(3x), terminfo(5).
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).
 
 
 
diff --git a/doc/html/man/terminfo.5.html b/doc/html/man/terminfo.5.html
index 3ab6070b..87f9e8e4 100644
--- a/doc/html/man/terminfo.5.html
+++ b/doc/html/man/terminfo.5.html
@@ -75,7 +75,7 @@
        nals by giving a set of capabilities which they  have,  by
        specifying how to perform screen operations, and by speci-
        fying padding requirements and  initialization  sequences.
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).
 
        Entries in terminfo consist of a sequence of `,' separated
        fields (embedded commas may be escaped with a backslash or
diff --git a/doc/html/man/tic.1m.html b/doc/html/man/tic.1m.html
index cd14ee64..ddb1c450 100644
--- a/doc/html/man/tic.1m.html
+++ b/doc/html/man/tic.1m.html
@@ -401,7 +401,7 @@
        infocmp(1m),   captoinfo(1m),   infotocap(1m),    toe(1m),
        curses(3x), term(5).  terminfo(5).
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).

    AUTHOR

    diff --git a/doc/html/man/toe.1m.html b/doc/html/man/toe.1m.html
index b67450cd..0559dcf9 100644
--- a/doc/html/man/toe.1m.html
+++ b/doc/html/man/toe.1m.html
@@ -117,7 +117,7 @@
        tic(1m),   infocmp(1m),   captoinfo(1m),    infotocap(1m),
        curses(3x), terminfo(5).
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).
 
 
 
diff --git a/doc/html/man/tput.1.html b/doc/html/man/tput.1.html
index bbc22a4e..2e4e5595 100644
--- a/doc/html/man/tput.1.html
+++ b/doc/html/man/tput.1.html
@@ -441,7 +441,7 @@
        clear(1),   stty(1),   tabs(1),   tset(1),    terminfo(5),
        curs_termcap(3x).
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).
 
 
 
diff --git a/doc/html/man/tset.1.html b/doc/html/man/tset.1.html
index 964cee63..22004866 100644
--- a/doc/html/man/tset.1.html
+++ b/doc/html/man/tset.1.html
@@ -387,7 +387,7 @@
        csh(1),   sh(1),   stty(1),   curs_terminfo(3x),   tty(4),
        terminfo(5), ttys(5), environ(7)
 
-       This describes ncurses version 6.0 (patch 20161119).
+       This describes ncurses version 6.0 (patch 20161203).
 
 
 
diff --git a/man/curs_trace.3x b/man/curs_trace.3x
index 85df283c..123577c4 100644
--- a/man/curs_trace.3x
+++ b/man/curs_trace.3x
@@ -26,7 +26,7 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
-.\" $Id: curs_trace.3x,v 1.14 2016/10/15 17:26:09 tom Exp $
+.\" $Id: curs_trace.3x,v 1.16 2016/12/03 23:53:23 tom Exp $
 .de bP
 .IP \(bu 4
 ..
@@ -34,46 +34,46 @@
 .na
 .hy 0
 .SH NAME
+\fBtrace\fR,
 \fB_tracef\fR,
-\fB_tracedump\fR,
 \fB_traceattr\fR,
 \fB_traceattr2\fR,
-\fB_nc_tracebits\fR,
 \fB_tracecchar_t\fR,
 \fB_tracecchar_t2\fR,
 \fB_tracechar\fR,
 \fB_tracechtype\fR,
 \fB_tracechtype2\fR,
-\fB_tracemouse\fR,
-\fBtrace\fR \- \fBcurses\fR debugging routines
+\fB_nc_tracebits\fR,
+\fB_tracedump\fR,
+\fB_tracemouse\fR \- \fBcurses\fR debugging routines
 .ad
 .hy
 .SH SYNOPSIS
 \fB#include \fR
 .sp
+\fBvoid trace(const unsigned int \fP\fIparam\fP\fB);\fR
+.sp
 \fBvoid _tracef(const char *\fP\fIformat\fP\fB, ...);\fR
-.br
-\fBvoid _tracedump(const char *\fP\fIlabel\fP\fB, WINDOW *\fP\fIwin\fP\fB);\fR
-.br
+.sp
 \fBchar *_traceattr(attr_t \fP\fIattr\fP\fB);\fR
 .br
 \fBchar *_traceattr2(int \fP\fIbuffer\fP\fB, chtype \fP\fIch\fP\fB);\fR
 .br
-\fBchar *_nc_tracebits(void);\fR
-.br
-\fBchar * _tracecchar_t(const cchar_t *\fP\fIstring\fP\fB);\fR
+\fBchar *_tracecchar_t(const cchar_t *\fP\fIstring\fP\fB);\fR
 .br
-\fBchar * _tracecchar_t2(int \fP\fIbuffer\fP\fB, const cchar_t *\fP\fIstring\fP\fB);\fR
+\fBchar *_tracecchar_t2(int \fP\fIbuffer\fP\fB, const cchar_t *\fP\fIstring\fP\fB);\fR
 .br
 \fBchar *_tracechar(int \fP\fIch\fP\fB);\fR
 .br
 \fBchar *_tracechtype(chtype \fP\fIch\fP\fB);\fR
 .br
 \fBchar *_tracechtype2(int \fP\fIbuffer\fP\fB, chtype \fP\fIch\fP\fB);\fR
+.sp
+\fBvoid _tracedump(const char *\fP\fIlabel\fP\fB, WINDOW *\fP\fIwin\fP\fB);\fR
 .br
-\fBchar *_tracemouse(const MEVENT *\fP\fIevent\fP\fB);\fR
+\fBchar *_nc_tracebits(void);\fR
 .br
-\fBvoid trace(const unsigned int \fP\fIparam\fP\fB);\fR
+\fBchar *_tracemouse(const MEVENT *\fP\fIevent\fP\fB);\fR
 .SH DESCRIPTION
 The \fBtrace\fR routines are used for debugging the ncurses libraries,
 as well as applications which use the ncurses libraries.
@@ -82,21 +82,38 @@ e.g., \fIlibncurses_g.a\fR, but may be compiled into any model (shared, static,
 profile) by defining the symbol \fBTRACE\fR.
 Additionally, some functions are only available with the wide-character
 configuration of the libraries.
-.PP
+.SS Functions
 The principal parts of this interface are
 .bP
 \fBtrace\fR, which selectively enables different tracing features, and
 .bP
 \fB_tracef\fR, which writes formatted data to the \fItrace\fR file.
 .PP
-Calling \fBtrace\fR with a nonzero parameter opens the file \fBtrace\fR
+Calling \fBtrace\fR with a nonzero parameter creates the file \fBtrace\fR
 in the current directory for output.
-The parameter is formed by OR'ing
+If the file already exists, no tracing is done.
+.PP
+The other functions either return a pointer to a string-area
+(allocated by the corresponding function),
+or return no value (such as \fB_tracedump\fP, which implements the
+screen dump for \fBTRACE_UPDATE\fP).
+The caller should not free these
+strings, since the allocation is reused on successive calls.
+To work around the problem of a single string-area per function,
+some use a buffer-number parameter, telling the library to allocate
+additional string-areas.
+.SS Trace Parameter
+The trace parameter is formed by OR'ing
 values from the list of \fBTRACE_\fP\fIxxx\fR definitions in \fB\fR.
 These include:
 .TP 5
 .B TRACE_DISABLE
-turn off tracing.
+turn off tracing by passing a zero parameter.
+.IP
+The library flushes the output file,
+but retains an open file-descriptor to the trace file
+so that it can resume tracing later if a nonzero parameter is passed
+to the \fBtrace\fP function.
 .TP 5
 .B TRACE_TIMES
 trace user and system times of updates.
@@ -150,22 +167,13 @@ Some tracing features are enabled whenever the \fBtrace\fR parameter
 is nonzero.
 Some features overlap.
 The specific names are used as a guideline.
-.PP
-The other functions either return a pointer to a string-area
-(allocated by the corresponding function),
-or return no value (such as \fB_tracedump\fP, which implements the
-screen dump for \fBTRACE_UPDATE\fP).
-The caller should not free these
-strings, since the allocation is reused on successive calls.
-To work around the problem of a single string-area per function,
-some use a buffer-number parameter, telling the library to allocate
-additional string-areas.
-.PP
+.SS Initialization
 These functions check the \fBNCURSES_TRACE\fP environment variable,
 to set the tracing feature as if \fBtrace\fP was called:
-.RS
+.RS 4
 .PP
 .na
+.hy 0
 filter,
 initscr,
 new_prescr,
@@ -179,6 +187,7 @@ tgetent,
 use_env,
 use_extended_names,
 use_tioctl
+.hy
 .ad
 .RE
 .SH RETURN VALUE
@@ -189,5 +198,13 @@ These functions are not part of the XSI interface.
 Some other curses implementations are known to
 have similar, undocumented features,
 but they are not compatible with ncurses.
+.PP
+A few functions are not provided when symbol versioning is used:
+.RS 4
+.PP
+_nc_tracebits,
+_tracedump,
+_tracemouse
+.RE
 .SH SEE ALSO
 \fBcurses\fR(3X).
diff --git a/man/form_driver.3x b/man/form_driver.3x
index 73245851..e70fe4dc 100644
--- a/man/form_driver.3x
+++ b/man/form_driver.3x
@@ -1,5 +1,5 @@
 .\"***************************************************************************
-.\" Copyright (c) 1998-2010,2015 Free Software Foundation, Inc.              *
+.\" Copyright (c) 1998-2015,2016 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,7 +26,7 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
-.\" $Id: form_driver.3x,v 1.25 2015/12/05 21:06:26 tom Exp $
+.\" $Id: form_driver.3x,v 1.26 2016/12/04 01:01:17 tom Exp $
 .TH form_driver 3X ""
 .de bP
 .IP \(bu 4
@@ -134,6 +134,32 @@ REQ_VALIDATION	Validate field.
 If the second argument is a printable character, the driver places it
 in the current position in the current field.  If it is one of the forms
 requests listed above, that request is executed.
+.SS Field validation
+The form library makes updates to the window associated with form fields rather than
+directly to the field buffers.
+.PP
+The form driver provides low-level control over updates to the form fields.
+The form driver also provides for validating modified fields to ensure that the contents
+meet whatever constraints an application may attach using \fBset_field_type\fP.
+.PP
+.PP
+You can validate a field without making any changes to it using
+\fBREQ_VALIDATION\fP.
+The form driver also validates a field in these cases:
+.bP
+a call to \fBset_current_field\fP attempts to move to a different field.
+.bP
+a call to \fBset_current_page\fP attempts to move to a different page of the form.
+.bP
+a request attempts to move to a different field.
+.bP
+a request attempts to move to a different page of the form.
+.PP
+In each case, the move fails if the field is invalid.
+.PP
+If the modified field is valid, the form driver copies the modified
+data from the window associated with the field
+to the field buffer.
 .SS Mouse handling
 .PP
 If the second argument is the KEY_MOUSE special key, the associated
@@ -218,6 +244,9 @@ The form driver code saw an unknown request code.
 .SH SEE ALSO
 \fBcurses\fR(3X),
 \fBform\fR(3X),
+\fBform_field_buffer\fR(3X),
+\fBform_field_validation\fR(3X),
+\fBform_fieldtype\fR(3X),
 \fBform_variables\fR(3X),
 \fBgetch\fR(3X).
 .SH NOTES
diff --git a/package/debian-mingw/changelog b/package/debian-mingw/changelog
index 948672cd..4fcda4d5 100644
--- a/package/debian-mingw/changelog
+++ b/package/debian-mingw/changelog
@@ -1,8 +1,8 @@
-ncurses6 (6.0+20161126) unstable; urgency=low
+ncurses6 (6.0+20161203) unstable; urgency=low
 
   * latest weekly patch
 
- -- Thomas E. Dickey   Mon, 21 Nov 2016 17:34:14 -0500
+ -- Thomas E. Dickey   Sat, 03 Dec 2016 11:11:11 -0500
 
 ncurses6 (5.9-20131005) unstable; urgency=low
 
diff --git a/package/debian-mingw64/changelog b/package/debian-mingw64/changelog
index 948672cd..4fcda4d5 100644
--- a/package/debian-mingw64/changelog
+++ b/package/debian-mingw64/changelog
@@ -1,8 +1,8 @@
-ncurses6 (6.0+20161126) unstable; urgency=low
+ncurses6 (6.0+20161203) unstable; urgency=low
 
   * latest weekly patch
 
- -- Thomas E. Dickey   Mon, 21 Nov 2016 17:34:14 -0500
+ -- Thomas E. Dickey   Sat, 03 Dec 2016 11:11:11 -0500
 
 ncurses6 (5.9-20131005) unstable; urgency=low
 
diff --git a/package/debian/changelog b/package/debian/changelog
index ee8c9005..7791b025 100644
--- a/package/debian/changelog
+++ b/package/debian/changelog
@@ -1,8 +1,8 @@
-ncurses6 (6.0+20161126) unstable; urgency=low
+ncurses6 (6.0+20161203) unstable; urgency=low
 
   * latest weekly patch
 
- -- Thomas E. Dickey   Mon, 21 Nov 2016 17:34:14 -0500
+ -- Thomas E. Dickey   Sat, 03 Dec 2016 11:11:11 -0500
 
 ncurses6 (5.9-20120608) unstable; urgency=low
 
diff --git a/package/mingw-ncurses.nsi b/package/mingw-ncurses.nsi
index 35863b27..bf9fa03f 100644
--- a/package/mingw-ncurses.nsi
+++ b/package/mingw-ncurses.nsi
@@ -1,4 +1,4 @@
-; $Id: mingw-ncurses.nsi,v 1.186 2016/11/21 22:34:14 tom Exp $
+; $Id: mingw-ncurses.nsi,v 1.187 2016/12/03 16:11:11 tom Exp $
 
 ; TODO add examples
 ; TODO bump ABI to 6
@@ -10,7 +10,7 @@
 !define VERSION_MAJOR "6"
 !define VERSION_MINOR "0"
 !define VERSION_YYYY  "2016"
-!define VERSION_MMDD  "1126"
+!define VERSION_MMDD  "1203"
 !define VERSION_PATCH ${VERSION_YYYY}${VERSION_MMDD}
 
 !define MY_ABI   "5"
diff --git a/package/mingw-ncurses.spec b/package/mingw-ncurses.spec
index 0d0a7cb0..cbf82fc5 100644
--- a/package/mingw-ncurses.spec
+++ b/package/mingw-ncurses.spec
@@ -3,7 +3,7 @@
 Summary: shared libraries for terminal handling
 Name: mingw32-ncurses6
 Version: 6.0
-Release: 20161126
+Release: 20161203
 License: X11
 Group: Development/Libraries
 Source: ncurses-%{version}-%{release}.tgz
diff --git a/package/ncurses.spec b/package/ncurses.spec
index 84af698e..7498d36b 100644
--- a/package/ncurses.spec
+++ b/package/ncurses.spec
@@ -1,7 +1,7 @@
 Summary: shared libraries for terminal handling
 Name: ncurses6
 Version: 6.0
-Release: 20161126
+Release: 20161203
 License: X11
 Group: Development/Libraries
 Source: ncurses-%{version}-%{release}.tgz
diff --git a/progs/tic.c b/progs/tic.c
index 4285d1a4..7339f11a 100644
--- a/progs/tic.c
+++ b/progs/tic.c
@@ -48,7 +48,7 @@
 #include 
 #include 
 
-MODULE_ID("$Id: tic.c,v 1.228 2016/11/26 22:01:41 tom Exp $")
+MODULE_ID("$Id: tic.c,v 1.229 2016/12/04 02:12:38 tom Exp $")
 
 #define STDIN_NAME ""
 
@@ -1244,7 +1244,7 @@ check_ansi_cursor(char *list[4])
     }
     if (!repeated) {
 	char *up = list[1];
-	size_t prefix = csi_length(up);
+	size_t prefix = (size_t) csi_length(up);
 
 	if (prefix) {
 	    suffix = prefix;
diff --git a/test/README b/test/README
index 7bab08b2..a6c31ec4 100644
--- a/test/README
+++ b/test/README
@@ -25,7 +25,7 @@
 -- sale, use or other dealings in this Software without prior written        --
 -- authorization.                                                            --
 -------------------------------------------------------------------------------
--- $Id: README,v 1.55 2016/04/02 23:57:07 tom Exp $
+-- $Id: README,v 1.56 2016/12/04 01:16:34 tom Exp $
 -------------------------------------------------------------------------------
 
 The programs in this directory are used to test and demonstrate ncurses.
@@ -157,6 +157,7 @@ set_form_userptr		-
 set_form_win			test: cardfile demo_forms ncurses
 set_max_field			test: demo_forms
 set_new_page			test: demo_forms
+unfocus_current_field		-
 unpost_form			test: cardfile demo_forms form_driver_w ncurses
 
 libmenu:
@@ -251,17 +252,17 @@ addchstr			test: test_addchstr
 addnstr				test: test_addstr
 addnwstr			test: ncurses test_addwstr
 addstr				test: blue bs cardfile filter gdc hanoi lrtest ncurses test_addstr
-addwstr				test: test_addwstr
+addwstr				test: blue test_addwstr
 assume_default_colors		test: background ncurses
 assume_default_colors_sp	-
 attr_get			-
 attr_off			test: ncurses
 attr_on				test: ncurses
 attr_set			test: ncurses
-attroff				test: dots_curses echochar filter gdc ncurses tclock
-attron				test: bs dots_curses echochar filter gdc ncurses
+attroff				test: blue dots_curses echochar filter gdc ncurses tclock
+attron				test: blue bs dots_curses echochar filter gdc ncurses
 attrset				test: bs filter firework gdc hanoi insdelln ncurses rain tclock testaddch testcurs
-baudrate			lib: ncurses
+baudrate			test: ncurses
 baudrate_sp			lib: ncurses
 beep				test: blue bs cardfile chgat clip_printw demo_forms demo_menus demo_panels edit_field hanoi inch_wide inchs ins_wide insdelln inserts knight movewindow ncurses savescreen tclock test_add_wchstr test_addchstr test_addstr test_addwstr test_get_wstr test_getstr test_instr test_inwstr test_opaque testcurs view xmas
 beep_sp				lib: ncurses
@@ -281,7 +282,7 @@ can_change_color_sp		-
 cbreak				test: background blue bs cardfile chgat clip_printw color_set demo_altkeys demo_defkey demo_forms demo_keyok demo_menus demo_panels ditto filter firework foldkeys form_driver_w gdc hanoi hashtest inch_wide inchs ins_wide insdelln inserts knight lrtest movewindow ncurses newdemo savescreen tclock test_add_wchstr test_addchstr test_addstr test_addwstr test_get_wstr test_getstr test_instr test_inwstr test_opaque testcurs view worm xmas
 cbreak_sp			lib: ncurses
 chgat				test: chgat
-clear				test: blue bs gdc ncurses testcurs xmas
+clear				test: blue bs filter gdc ncurses testcurs xmas
 clearok				test: bs knight
 clrtobot			test: demo_menus ncurses
 clrtoeol			test: blue bs demo_altkeys filter foldkeys form_driver_w hanoi hashtest movewindow ncurses view
@@ -289,7 +290,7 @@ color_content			test: ncurses
 color_content_sp		-
 color_set			test: color_set ncurses
 copywin				test: ncurses testcurs
-cur_term			test: demo_termcap demo_terminfo dots dots_mvcur lrtest test_sgr test_vid_puts test_vidputs progs: clear tabs tput tset
+cur_term			test: demo_termcap demo_terminfo dots dots_mvcur filter list_keys lrtest test_sgr test_vid_puts test_vidputs progs: clear_cmd reset_cmd tabs tput tset
 curs_set			test: echochar firework gdc hanoi lrtest ncurses newdemo rain savescreen tclock testcurs worm xmas
 curs_set_sp			lib: ncurses
 curscr				test: demo_panels edit_field knight lrtest ncurses savescreen tclock view
@@ -319,9 +320,9 @@ echochar			test: echochar ncurses
 endwin				test: background blue bs cardfile chgat clip_printw color_set demo_altkeys demo_defkey demo_forms demo_keyok demo_menus demo_panels ditto dots_curses dots_mvcur echochar filter firework firstlast foldkeys form_driver_w gdc hanoi hashtest inch_wide inchs ins_wide insdelln inserts key_names keynames knight lrtest movewindow ncurses newdemo rain redraw savescreen tclock test_add_wchstr test_addchstr test_addstr test_addwstr test_get_wstr test_getstr test_instr test_inwstr test_opaque testaddch testcurs testscanw view worm xmas
 endwin_sp			lib: ncurses
 erase				test: cardfile demo_menus filter firework firstlast hanoi lrtest ncurses tclock test_opaque testcurs
-erasechar			lib: ncurses
+erasechar			test: ncurses
 erasechar_sp			lib: ncurses
-erasewchar			-
+erasewchar			test: ncurses
 filter				test: filter
 filter_sp			-
 flash				test: cardfile filter lrtest movewindow ncurses tclock testcurs
@@ -356,9 +357,9 @@ halfdelay			test: view
 halfdelay_sp			-
 has_colors			test: background bs cardfile chgat clip_printw color_set demo_forms demo_menus demo_panels dots_curses echochar filter firework gdc hanoi ins_wide insdelln inserts knight ncurses newdemo rain savescreen tclock test_add_wchstr test_addchstr test_addstr test_addwstr testcurs view worm xmas
 has_colors_sp			lib: ncurses
-has_ic				test: lrtest
+has_ic				test: lrtest ncurses
 has_ic_sp			lib: ncurses
-has_il				-
+has_il				test: ncurses
 has_il_sp			lib: ncurses
 has_key				-
 has_key_sp			lib: ncurses
@@ -398,13 +399,13 @@ is_cleared			test: test_opaque
 is_idcok			test: test_opaque
 is_idlok			test: test_opaque
 is_immedok			test: test_opaque
-is_keypad			test: test_opaque
+is_keypad			test: ncurses test_opaque
 is_leaveok			test: test_opaque
 is_linetouched			lib: form
 is_nodelay			test: test_opaque
 is_notimeout			test: test_opaque
 is_pad				-
-is_scrollok			test: test_opaque
+is_scrollok			test: ncurses test_opaque
 is_subwin			-
 is_syncok			test: test_opaque
 is_term_resized			-
@@ -422,11 +423,11 @@ keyname_sp			lib: ncurses
 keyok				test: demo_keyok foldkeys
 keyok_sp			lib: ncurses
 keypad				test: bs cardfile chgat clip_printw demo_altkeys demo_defkey demo_forms demo_keyok demo_menus demo_panels ditto edit_field filter firework foldkeys form_driver_w hashtest inch_wide inchs ins_wide insdelln inserts key_names keynames knight lrtest movewindow ncurses redraw savescreen tclock test_add_wchstr test_addchstr test_addstr test_addwstr test_get_wstr test_getstr test_instr test_inwstr test_opaque testcurs testscanw view
-killchar			lib: ncurses
+killchar			test: ncurses
 killchar_sp			lib: ncurses
-killwchar			-
+killwchar			test: ncurses
 leaveok				test: hanoi test_opaque
-longname			test: testcurs progs: tput
+longname			test: ncurses testcurs progs: tput
 longname_sp			-
 mcprint				-
 mcprint_sp			-
@@ -527,7 +528,7 @@ new_prescr			lib: ncurses
 newpad				test: edit_field ncurses testcurs
 newpad_sp			lib: ncurses
 newscr				lib: ncurses
-newterm				test: demo_altkeys ditto dots_mvcur filter foldkeys gdc key_names keynames test_setupterm
+newterm				test: demo_altkeys ditto dots_mvcur filter foldkeys gdc key_names keynames
 newterm_sp			-
 newwin				test: cardfile chgat clip_printw demo_defkey demo_forms demo_keyok demo_menus demo_panels ditto edit_field firstlast inch_wide inchs ins_wide insdelln inserts knight movewindow ncurses newdemo redraw savescreen test_add_wchstr test_addchstr test_addstr test_addwstr test_get_wstr test_getstr test_instr test_inwstr test_opaque testcurs xmas
 newwin_sp			lib: ncurses
@@ -560,7 +561,7 @@ pechochar			-
 pnoutrefresh			test: edit_field ncurses
 prefresh			test: testcurs
 printw				test: background blue bs color_set demo_altkeys demo_defkey demo_keyok filter foldkeys ncurses savescreen testcurs testscanw view
-putp				test: test_sgr progs: tput
+putp				test: filter test_sgr progs: tput
 putp_sp				-
 putwin				test: ncurses
 qiflush				-
@@ -571,7 +572,7 @@ redrawwin			test: redraw view
 refresh				test: blue bs demo_defkey demo_forms demo_keyok demo_menus demo_panels dots_curses echochar filter firstlast form_driver_w gdc hanoi hashtest lrtest movewindow ncurses savescreen tclock testcurs view xmas
 reset_prog_mode			test: filter ncurses
 reset_prog_mode_sp		lib: ncurses
-reset_shell_mode		test: bs filter savescreen test_setupterm
+reset_shell_mode		test: bs filter savescreen
 reset_shell_mode_sp		lib: ncurses
 resetty				-
 resetty_sp			-
@@ -579,7 +580,7 @@ resize_term			test: view
 resize_term_sp			-
 resizeterm			-
 resizeterm_sp			lib: ncurses
-restartterm			test: test_setupterm
+restartterm			-
 restartterm_sp			-
 ripoffline			test: demo_menus ncurses
 ripoffline_sp			-
@@ -596,7 +597,7 @@ scr_set_sp			-
 scrl				test: view
 scroll				test: testcurs
 scrollok			test: clip_printw demo_altkeys demo_defkey demo_keyok demo_panels ditto foldkeys hashtest knight ncurses redraw test_opaque testcurs testscanw view
-set_curterm			lib: ncurses
+set_curterm			test: list_keys
 set_curterm_sp			-
 set_escdelay			test: test_opaque
 set_escdelay_sp			lib: ncurses
@@ -605,7 +606,7 @@ set_tabsize_sp			-
 set_term			lib: ncurses
 setcchar			test: demo_panels ins_wide ncurses test_add_wchstr test_addwstr view
 setscrreg			test: view
-setupterm			test: demo_terminfo dots test_setupterm test_sgr test_vid_puts test_vidputs progs: clear tabs tput tset
+setupterm			test: demo_terminfo dots list_keys test_setupterm test_sgr test_vid_puts test_vidputs progs: clear tabs tput tset
 slk_attr			-
 slk_attr_off			-
 slk_attr_on			-
@@ -643,8 +644,8 @@ start_color			test: background blue bs cardfile chgat clip_printw color_set demo
 start_color_sp			-
 stdscr				test: bs chgat clip_printw demo_altkeys demo_forms demo_menus demo_panels ditto filter firework foldkeys form_driver_w gdc hanoi hashtest inch_wide inchs ins_wide insdelln inserts key_names keynames knight lrtest movewindow ncurses rain redraw savescreen tclock test_add_wchstr test_addchstr test_addstr test_addwstr test_get_wstr test_getstr test_instr test_inwstr test_opaque testcurs testscanw view worm xmas
 strcodes			test: demo_termcap test_arrays progs: dump_entry
-strfnames			test: demo_terminfo test_arrays progs: dump_entry
-strnames			test: demo_termcap demo_terminfo foldkeys test_arrays progs: dump_entry infocmp tic
+strfnames			test: demo_terminfo list_keys test_arrays progs: dump_entry
+strnames			test: demo_termcap demo_terminfo foldkeys list_keys test_arrays progs: dump_entry infocmp tic
 subpad				test: testcurs
 subwin				test: movewindow ncurses newdemo testcurs
 syncok				test: test_opaque
@@ -652,7 +653,7 @@ term_attrs			test: ncurses
 term_attrs_sp			-
 termattrs			test: ncurses testcurs
 termattrs_sp			lib: ncurses
-termname			test: testcurs
+termname			test: list_keys ncurses testcurs
 termname_sp			lib: ncurses
 tgetent				test: demo_termcap dots_termcap railroad
 tgetent_sp			-
@@ -667,14 +668,14 @@ tigetflag			test: demo_terminfo progs: tic tput
 tigetflag_sp			-
 tigetnum			test: demo_terminfo ncurses progs: tput
 tigetnum_sp			-
-tigetstr			test: demo_defkey demo_terminfo foldkeys test_sgr testcurs progs: clear tput
+tigetstr			test: blue demo_defkey demo_terminfo foldkeys list_keys test_sgr testcurs progs: clear_cmd tput
 tigetstr_sp			-
 timeout				test: filter rain savescreen
 tiparm				-
 touchline			test: chgat clip_printw insdelln
 touchwin			test: chgat clip_printw demo_menus edit_field filter firstlast inch_wide inchs ins_wide insdelln inserts movewindow ncurses redraw savescreen test_add_wchstr test_addchstr test_addstr test_addwstr test_get_wstr test_getstr test_instr test_inwstr test_opaque xmas
-tparm				test: dots dots_mvcur test_sgr progs: tabs tic tput
-tputs				test: dots dots_mvcur dots_termcap railroad test_vid_puts test_vidputs progs: clear tabs tset
+tparm				test: dots dots_mvcur test_sgr progs: reset_cmd tabs tic tput
+tputs				test: dots dots_mvcur dots_termcap railroad test_vid_puts test_vidputs progs: clear_cmd reset_cmd tabs
 tputs_sp			lib: ncurses
 trace				test: demo_menus hashtest lrtest ncurses testcurs view worm
 ttytype				test: demo_terminfo test_sgr
@@ -693,7 +694,7 @@ use_default_colors		test: background filter firework gdc hanoi knight ncurses ra
 use_default_colors_sp		-
 use_env				test: ncurses progs: tput
 use_env_sp			-
-use_extended_names		progs: infocmp tic
+use_extended_names		test: demo_termcap demo_terminfo list_keys progs: infocmp tic
 use_legacy_coding		-
 use_legacy_coding_sp		-
 use_screen			test: ditto
-- 
2.44.0