From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Per Abrahamsen Newsgroups: gmane.emacs.devel Subject: Re: :format strings in Custom ending in %h Date: Fri, 24 Oct 2003 18:00:54 +0200 Organization: The Church of Emacs Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200308210154.h7L1sJc21082@raven.dms.auburn.edu> <200308212100.h7LL0d125524@raven.dms.auburn.edu> <200308221441.h7MEfoT27405@raven.dms.auburn.edu> <200308241717.h7OHHSu03863@raven.dms.auburn.edu> <200310201805.h9KI5Pm09318@raven.dms.auburn.edu> <200310202110.h9KLAnk11006@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1067011724 15898 80.91.224.253 (24 Oct 2003 16:08:44 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 24 Oct 2003 16:08:44 +0000 (UTC) Cc: teirllm@dms.auburn.edu, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Fri Oct 24 18:08:42 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1AD4UU-0006j3-00 for ; Fri, 24 Oct 2003 18:08:42 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AD4UU-0001Tm-00 for ; Fri, 24 Oct 2003 18:08:42 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AD4Qa-0005uD-Uh for emacs-devel@quimby.gnus.org; Fri, 24 Oct 2003 12:04:40 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AD4O4-00059v-EO for emacs-devel@gnu.org; Fri, 24 Oct 2003 12:02:04 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AD4NJ-0004yJ-Gf for emacs-devel@gnu.org; Fri, 24 Oct 2003 12:01:48 -0400 Original-Received: from [130.225.40.227] (helo=sheridan.dina.kvl.dk) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AD4NF-0004ts-DI; Fri, 24 Oct 2003 12:01:13 -0400 Original-Received: by sheridan.dina.kvl.dk (Postfix, from userid 304) id 25D3A13D10; Fri, 24 Oct 2003 18:00:54 +0200 (CEST) Original-To: rms@gnu.org X-Face: +kRV2]2q}lixHkE{U)mY#+6]{AH=yN~S9@IFiOa@X6?GM|8MBp/ In-Reply-To: (Richard Stallman's message of "Thu, 23 Oct 2003 14:37:19 -0400") User-Agent: Gnus/5.1003 (Gnus v5.10.3) Emacs/21.2 (gnu/linux) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:17407 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17407 Richard Stallman writes: > Only the one line patch is necessary. The rest is about removing > redundant but harmless code, and documenting the new behavior. > > we can live without removing the redundant code, but documenting the > change is essential. can someone write the doc? Here is a doc change: *** widget.texi.~1.22.~ 2003-10-24 15:35:50.000000000 +0200 --- widget.texi 2003-10-24 17:59:49.000000000 +0200 *************** *** 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 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. @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 @vindex value-get@r{ 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 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 these are not listed in @code{:children} or @code{:buttons}. @vindex value-get@r{ keyword} @item :value-get