From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Michael Reilly Newsgroups: gmane.emacs.devel Subject: compilation-process-setup-function doc bug? Date: Wed, 04 Nov 2009 17:57:29 -0500 Message-ID: <4AF206D9.1040406@pajato.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1257377025 22645 80.91.229.12 (4 Nov 2009 23:23:45 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 4 Nov 2009 23:23:45 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Nov 05 00:23:38 2009 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 1N5pBf-0002k5-S1 for ged-emacs-devel@m.gmane.org; Thu, 05 Nov 2009 00:22:48 +0100 Original-Received: from localhost ([127.0.0.1]:37262 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1N5pBf-0000kR-Bt for ged-emacs-devel@m.gmane.org; Wed, 04 Nov 2009 18:22:47 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1N5pBW-0000j7-SL for emacs-devel@gnu.org; Wed, 04 Nov 2009 18:22:38 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1N5pBU-0000hd-5S for emacs-devel@gnu.org; Wed, 04 Nov 2009 18:22:37 -0500 Original-Received: from [199.232.76.173] (port=37091 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1N5pBU-0000hZ-0n for emacs-devel@gnu.org; Wed, 04 Nov 2009 18:22:36 -0500 Original-Received: from static-98-118-55-50.bstnma.fios.verizon.net ([98.118.55.50]:41899 helo=copa.pajato.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1N5pBT-0001NW-MA for emacs-devel@gnu.org; Wed, 04 Nov 2009 18:22:35 -0500 Original-Received: from wurb.pajato.com (copa.pajato.com [98.118.55.50]) by copa.pajato.com (8.14.3/8.14.3) with ESMTP id nA4MvTTk015723 for ; Wed, 4 Nov 2009 17:57:29 -0500 User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.4pre) Gecko/20091014 Fedora/3.0-2.8.b4.fc11 Thunderbird/3.0b4 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) X-Greylist: delayed 1505 seconds by postgrey-1.27 at monty-python; Wed, 04 Nov 2009 18:22:35 EST 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:116648 Archived-At: I believe the documentation string for the variable compilation-process-setup-function is wrong or less than clear. It says: *Function to call to customize the compilation process. This function is called immediately before the compilation process is started. It can be used to set any variables or functions that are used while processing the output of the compilation process. The function is called with variables `compilation-buffer' and `compilation-window' bound to the compilation buffer and window, respectively. What does this mean actually? In my blissful ignorance I thought it meant I should create a function like so: (defun test (compilation-buffer compilation-window) ...) and do (setq compilation-process-setup-function 'test) but when I do M-x compile, Emacs is not happy with the arguments. It is actually called with no arguments. So next I'm thinking maybe this is what the documentation means: (defun test () (message "The args are %s %s" compilation-buffer compilation-window) ...) but Emacs complains that the variables are void, which seems reasonable. My take is that the last sentence in the doc string should be expunged. Am I correct? -pmr