# HG changeset patch
# User Per Abrahamsen <abraham@dina.kvl.dk>
# Date 1067175094 0
# Node ID cd6e896ac1113e7e2f24952896db88eb758d0258
# Parent  aadc87ded24c078cb976d358354e7df300feea8f
2003-10-26  Per Abrahamsen  <abraham@dina.kvl.dk>

       * widget.texi (Defining New Widgets): Document new beavior of
       :buttons and :children keywords.

diff -r aadc87ded24c -r cd6e896ac111 man/ChangeLog
--- a/man/ChangeLog	Sun Oct 26 00:57:12 2003 +0000
+++ b/man/ChangeLog	Sun Oct 26 13:31:34 2003 +0000
@@ -1,3 +1,8 @@
+2003-10-26  Per Abrahamsen  <abraham@dina.kvl.dk>
+
+	* widget.texi (Defining New Widgets): Document new beavior of
+	:buttons and :children keywords.
+
 2003-10-22  Miles Bader  <miles@gnu.org>
 
 	* Makefile.in (info): Move before $(top_srcdir)/info.
diff -r aadc87ded24c -r cd6e896ac111 man/widget.texi
--- a/man/widget.texi	Sun Oct 26 00:57:12 2003 +0000
+++ b/man/widget.texi	Sun Oct 26 13:31:34 2003 +0000
@@ -1586,24 +1586,31 @@
 Function to delete a widget.  The function takes one argument, a widget,
 and should remove all traces of the widget from the buffer.
 
+The default value is:
+
+@defun widget-default-delete widget
+Remove @var{widget} from the buffer.
+Delete all @code{:children} and @code{:buttons} in @var{widget}.
+@end defun
+
+In most cases you should not change this value, but instead use
+@code{:value-delete} to make any additional cleanup.
+
 @vindex value-create@r{ keyword}
 @item :value-create
 Function to expand the @samp{%v} escape in the format string.  It will
 be called with the widget as its argument and should insert a
 representation of the widget's value in the buffer.
 
+Nested widgets should be listed in @code{:children} or @code{:buttons}
+to make sure they are automatically deleted.
+
 @vindex value-delete@r{ keyword}
 @item :value-delete
 Should remove the representation of the widget's value from the buffer.
 It will be called with the widget as its argument.  It doesn't have to
 remove the text, but it should release markers and delete nested widgets
-if such have been used.
-
-The following predefined function can be used here:
-
-@defun widget-children-value-delete widget
-Delete all @code{:children} and @code{:buttons} in @var{widget}.
-@end defun
+if these are not listed in @code{:children} or @code{:buttons}.
 
 @vindex value-get@r{ keyword}
 @item :value-get