From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Juanma Barranquero" Newsgroups: gmane.emacs.devel Subject: Docstring of `window-scroll-functions' Date: Tue, 28 Oct 2008 18:57:05 +0100 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1225216781 1469 80.91.229.12 (28 Oct 2008 17:59:41 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 28 Oct 2008 17:59:41 +0000 (UTC) Cc: Emacs Devel To: "Martin Rudalics" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Oct 28 19:00:42 2008 connect(): Connection refused Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1KusrB-0006ft-5l for ged-emacs-devel@m.gmane.org; Tue, 28 Oct 2008 18:59:53 +0100 Original-Received: from localhost ([127.0.0.1]:38179 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Kusq5-0005tK-6a for ged-emacs-devel@m.gmane.org; Tue, 28 Oct 2008 13:58:45 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KusoW-0005Pm-Cf for emacs-devel@gnu.org; Tue, 28 Oct 2008 13:57:08 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KusoU-0005PM-OH for emacs-devel@gnu.org; Tue, 28 Oct 2008 13:57:07 -0400 Original-Received: from [199.232.76.173] (port=42868 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KusoU-0005PJ-Id for emacs-devel@gnu.org; Tue, 28 Oct 2008 13:57:06 -0400 Original-Received: from yx-out-1718.google.com ([74.125.44.155]:18758) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1KusoU-0000mY-B6 for emacs-devel@gnu.org; Tue, 28 Oct 2008 13:57:06 -0400 Original-Received: by yx-out-1718.google.com with SMTP id 34so717392yxf.66 for ; Tue, 28 Oct 2008 10:57:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to :subject:cc:mime-version:content-type:content-transfer-encoding :content-disposition; bh=3XxkufpcpsRHMwBaDJZhJmQ9B98cDaoVTnSfz+2xHYA=; b=iQZifzFuhJJY7VDNoN+5kjqSwnw29MpNfeVIRWHK+ibGyS92YSNzkWWmwapPOZpims RWlmICkAsuULgFULCarunUKDLgApGpi5DIk0UnPy+beTNcv9KMNxc5hbx39YBE60dl7j SZA0y8hJeekIZMkllF3QD+X6MNx3AAHnR8Hq0= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:mime-version:content-type :content-transfer-encoding:content-disposition; b=KjpVoZ/NhaN3VEQ8rHDf8lbVOPdqfzjijgDGCo0T+f60UyHPhdnygwJOiWyPIGDyNT t3Arbt3CnpKTalsYSO7OlSOuPuNLdLzi/Qjc9TsRN01XFOZOiI/DHzZ62eFHNkbsesR/ e+GZgSL4QunUWPhhp0oFNz0lKEmnpPAU/GHeY= Original-Received: by 10.100.122.12 with SMTP id u12mr7403039anc.78.1225216625359; Tue, 28 Oct 2008 10:57:05 -0700 (PDT) Original-Received: by 10.100.13.13 with HTTP; Tue, 28 Oct 2008 10:57:05 -0700 (PDT) Content-Disposition: inline X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:105089 Archived-At: The docstring for `set-window-buffer' mentions that it runs `window-scroll-functions', but says nothing about `window-configuration-change-hook', which is weird. Perhaps that's because the programmer can reasonably expect for `set-window-buffer' to run the window configuration change hook, but not `window-scroll-functions'? In any case, I'd suggest at least adding wording to window-scroll-function's docstring making clear that it can be run from `set-window-buffer', because at it stands now, it would be a bit unexpected if the programmer happens to read just the variable's doc and not the function's: window-scroll-functions is a variable defined in `C source code'. Its value is nil Documentation: List of functions to call before redisplaying a window with scrolling. Each function is called with two arguments, the window and its new display-start position. Note that the value of `window-end' is not valid when these functions are called. `set-window-buffer' has no apparent relation with scrolling. Juanma