From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Lars Hansen Newsgroups: gmane.emacs.devel Subject: Documentation of write-contents-functions Date: Wed, 23 Jun 2004 11:14:42 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <40D94A02.3090809@math.ku.dk> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------020802010002060807010308" X-Trace: sea.gmane.org 1087982131 28352 80.91.224.253 (23 Jun 2004 09:15:31 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 23 Jun 2004 09:15:31 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Wed Jun 23 11:15:21 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1Bd3qj-0003za-00 for ; Wed, 23 Jun 2004 11:15:21 +0200 Original-Received: from lists.gnu.org ([199.232.76.165]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1Bd3qi-0007XM-00 for ; Wed, 23 Jun 2004 11:15:20 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Bd3s4-0004BG-5q for emacs-devel@quimby.gnus.org; Wed, 23 Jun 2004 05:16:44 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1Bd3ry-0004Av-JL for emacs-devel@gnu.org; Wed, 23 Jun 2004 05:16:38 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1Bd3rx-0004AP-GZ for emacs-devel@gnu.org; Wed, 23 Jun 2004 05:16:38 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Bd3rx-0004AM-DI for emacs-devel@gnu.org; Wed, 23 Jun 2004 05:16:37 -0400 Original-Received: from [213.170.224.162] (helo=smtp.kabelnettet.dk) by monty-python.gnu.org with esmtp (Exim 4.34) id 1Bd3q7-0007ev-Tc for emacs-devel@gnu.org; Wed, 23 Jun 2004 05:14:44 -0400 Original-Received: from math.ku.dk (0x52b410e6.dhcp.kabelnettet.dk [82.180.16.230]) by smtp.kabelnettet.dk (Postfix) with ESMTP id 82905609905; Wed, 23 Jun 2004 11:14:41 +0200 (CEST) User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.2.1) Gecko/20021213 Debian/1.2.1-2.bunk X-Accept-Language: en Original-To: Luc Teirlinck X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 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:25208 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:25208 This is a multi-part message in MIME format. --------------020802010002060807010308 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit To me the description in files.texi of write-contents-functions does not make much sense. I suggest the chances attached. Do you agree? --------------020802010002060807010308 Content-Type: text/plain; name="files.texi.diff" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="files.texi.diff" *** files.texi.~1.66.~ Sun May 30 08:41:47 2004 --- files.texi Tue Jun 22 21:04:00 2004 *************** *** 416,426 **** @c Emacs 19 feature @defvar write-contents-functions This works just like @code{write-file-functions}, but it is intended for ! hooks that pertain to the contents of the file, as opposed to hooks that ! pertain to where the file came from. Such hooks are usually set up by major modes, as buffer-local bindings for this variable. If any of the ! functions in this hook returns non-@code{nil}, @code{write-file-functions} ! is not run. This variable automatically becomes buffer-local whenever it is set; switching to a new major mode always resets this variable, but --- 416,427 ---- @c Emacs 19 feature @defvar write-contents-functions This works just like @code{write-file-functions}, but it is intended for ! hooks that pertain to the contents of the buffer, as opposed to hooks that ! pertain to the file the buffers visits. Such hooks are usually set up by major modes, as buffer-local bindings for this variable. If any of the ! functions in this hook returns non-@code{nil}, the file is considered ! already written and the rest are not called and neither are the functions ! in @code{write-file-functions}. This variable automatically becomes buffer-local whenever it is set; switching to a new major mode always resets this variable, but --------------020802010002060807010308 Content-Type: text/plain; name="files.el.diff" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="files.el.diff" *** files.el.~1.705.~ Thu Jun 17 08:26:50 2004 --- files.el Tue Jun 22 21:02:01 2004 *************** *** 393,399 **** (defvar write-contents-functions nil "List of functions to be called before writing out a buffer to a file. If one of them returns non-nil, the file is considered already written ! and the rest are not called. This variable is meant to be used for hooks that pertain to the buffer's contents, not to the particular visited file; thus, --- 393,400 ---- (defvar write-contents-functions nil "List of functions to be called before writing out a buffer to a file. If one of them returns non-nil, the file is considered already written ! and the rest are not called and neither are the functions in ! `write-file-functions'. This variable is meant to be used for hooks that pertain to the buffer's contents, not to the particular visited file; thus, --------------020802010002060807010308 Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Emacs-devel mailing list Emacs-devel@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-devel --------------020802010002060807010308--