[Emacs-diffs] Changes to emacs/man/widget.texi [lexbind]

[Miles Bader]

Index: emacs/man/widget.texi
diff -c emacs/man/widget.texi:1.13.2.2 emacs/man/widget.texi:1.13.2.3
*** emacs/man/widget.texi:1.13.2.2      Tue Oct 14 18:56:25 2003
--- emacs/man/widget.texi       Thu Nov 20 19:36:13 2003
***************
*** 112,118 ****
  meaning.  The user is not supposed to change or delete any of the text
  between the fields.  Examples of forms in Emacs are the @file{forms}
  package (of course), the customize buffers, the mail and news compose
! modes, and the @sc{html} form support in the @file{w3} browser.
  
  @cindex widget library, why use it
  The advantages for a programmer of using the @code{widget} package to
--- 112,118 ----
  meaning.  The user is not supposed to change or delete any of the text
  between the fields.  Examples of forms in Emacs are the @file{forms}
  package (of course), the customize buffers, the mail and news compose
! modes, and the @acronym{HTML} form support in the @file{w3} browser.
  
  @cindex widget library, why use it
  The advantages for a programmer of using the @code{widget} package to
***************
*** 739,745 ****
  @end example
  
  @findex address@hidden, and @code{url-link} widget}
! When this link is invoked, the @sc{www} browser specified by
  @code{browse-url-browser-function} will be called with @var{url}.
  
  @node info-link, push-button, url-link, Basic Types
--- 739,745 ----
  @end example
  
  @findex address@hidden, and @code{url-link} widget}
! When this link is invoked, the @acronym{WWW} browser specified by
  @code{browse-url-browser-function} will be called with @var{url}.
  
  @node info-link, push-button, url-link, Basic Types
***************
*** 1586,1609 ****
  Function to delete a widget.  The function takes one argument, a widget,
  and should remove all traces of the widget from the buffer.
  
  @vindex address@hidden 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.
  
  @vindex address@hidden 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
  
  @vindex address@hidden keyword}
  @item :value-get
--- 1586,1616 ----
  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 address@hidden 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 address@hidden 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 these are not listed in @code{:children} or @code{:buttons}.
  
  @vindex address@hidden keyword}
  @item :value-get