From unknown Sat Jun 14 19:31:11 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10785: 24.0.93; Doc of display-buffer doesn't explain alists Resent-From: Michael Heerdegen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 10 Feb 2012 23:05:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 10785 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 10785@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Reply-To: michael_heerdegen@web.de Received: via spool by submit@debbugs.gnu.org id=B.13289150704763 (code B ref -1); Fri, 10 Feb 2012 23:05:02 +0000 Received: (at submit) by debbugs.gnu.org; 10 Feb 2012 23:04:30 +0000 Received: from localhost ([127.0.0.1]:35407 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RvzW1-0001El-GT for submit@debbugs.gnu.org; Fri, 10 Feb 2012 18:04:29 -0500 Received: from eggs.gnu.org ([140.186.70.92]:42143) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RvzVy-0001EY-SV for submit@debbugs.gnu.org; Fri, 10 Feb 2012 18:04:27 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RvzUf-0007Pd-3R for submit@debbugs.gnu.org; Fri, 10 Feb 2012 18:03:05 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE, T_RP_MATCHES_RCVD autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([140.186.70.17]:60015) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RvzUf-0007PZ-1x for submit@debbugs.gnu.org; Fri, 10 Feb 2012 18:03:05 -0500 Received: from eggs.gnu.org ([140.186.70.92]:57281) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RvzUe-0000IM-0s for bug-gnu-emacs@gnu.org; Fri, 10 Feb 2012 18:03:05 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RvzUc-0007OG-GK for bug-gnu-emacs@gnu.org; Fri, 10 Feb 2012 18:03:03 -0500 Received: from fmmailgate05.web.de ([217.72.192.243]:45007) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RvzUc-0007Nk-BS for bug-gnu-emacs@gnu.org; Fri, 10 Feb 2012 18:03:02 -0500 Received: from moweb002.kundenserver.de (moweb002.kundenserver.de [172.19.20.108]) by fmmailgate05.web.de (Postfix) with ESMTP id 8C932696559C for ; Sat, 11 Feb 2012 00:03:00 +0100 (CET) Received: from snow.dragon ([82.113.121.242]) by smtp.web.de (mrweb001) with ESMTPA (Nemesis) id 0M0yzv-1So6eK46WN-00uzro; Sat, 11 Feb 2012 00:03:00 +0100 Date: Sat, 11 Feb 2012 00:04:22 +0100 Message-Id: <874nuyi93d.fsf@web.de> From: Michael Heerdegen X-Provags-ID: V02:K0:ltd+OHodxXpQsbdD9iKVIH+5QGt5OtFZT7rzUkAUQjg qf0jcedVPG2bIM+wv1OrvlxdVPnnhCskMyT08bNGZ0pL9EOI6O I7R81QhVhi3JMBfOZSg+ej66D7G5ia8ZdhB0a9cqBSqlufdDJ7 YPLqpvJfku8b+QQhkgPQXDlHFcNLZZXLmqvGYaf0b1qJhEpTPK XgCXJMW1fJBl9s2yrWLS5mKQMY8nY+VAAIyWY1pJW0= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4-2.6 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -4.2 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) Hello, the docstring of `display-buffer' mentions certain "alists" in several places, but doesn't say at all how they must look like and what an effect they have. Also most of the docstrings of the variables mentioned there don't explain their purpose, like `display-buffer-alist': ACTION is a cons cell (FUNCTION . ALIST), where FUNCTION is a function or a list of functions. Each such function should accept two arguments: a buffer to display and an alist of the same form as ALIST. See `display-buffer' for details. It's all quite cyclic. Michael. In GNU Emacs 24.0.93.1 (i486-pc-linux-gnu, GTK+ Version 3.2.3) of 2012-02-08 on zelenka, modified by Debian (emacs-snapshot package, version 2:20120208-1) Windowing system distributor `The X.Org Foundation', version 11.0.11103901 Configured using: `configure '--build' 'i486-linux-gnu' '--host' 'i486-linux-gnu' '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' '--localstatedir=/var' '--infodir=/usr/share/info' '--mandir=/usr/share/man' '--with-pop=yes' '--enable-locallisppath=/etc/emacs-snapshot:/etc/emacs:/usr/local/share/emacs/24.0.93/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/24.0.93/site-lisp:/usr/share/emacs/site-lisp' '--without-compress-info' '--with-crt-dir=/usr/lib/i386-linux-gnu/' '--with-x=yes' '--with-x-toolkit=gtk3' '--with-imagemagick=yes' 'build_alias=i486-linux-gnu' 'host_alias=i486-linux-gnu' 'CFLAGS=-DDEBIAN -DSITELOAD_PURESIZE_EXTRA=5000 -g -O2'' From unknown Sat Jun 14 19:31:11 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10785: 24.0.93; Doc of display-buffer doesn't explain alists Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 12 Feb 2012 05:14:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10785 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: michael_heerdegen@web.de Cc: 10785@debbugs.gnu.org Received: via spool by 10785-submit@debbugs.gnu.org id=B10785.132902361919696 (code B ref 10785); Sun, 12 Feb 2012 05:14:02 +0000 Received: (at 10785) by debbugs.gnu.org; 12 Feb 2012 05:13:39 +0000 Received: from localhost ([127.0.0.1]:36682 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RwRko-00057c-RI for submit@debbugs.gnu.org; Sun, 12 Feb 2012 00:13:39 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:59727 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RwRkl-00057V-Vx for 10785@debbugs.gnu.org; Sun, 12 Feb 2012 00:13:36 -0500 Received: from bb121-7-229-69.singnet.com.sg ([121.7.229.69]:49913 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1RwRjQ-0002Mg-AL; Sun, 12 Feb 2012 00:12:12 -0500 From: Chong Yidong References: <874nuyi93d.fsf@web.de> Date: Sun, 12 Feb 2012 13:12:04 +0800 In-Reply-To: <874nuyi93d.fsf@web.de> (Michael Heerdegen's message of "Sat, 11 Feb 2012 00:04:22 +0100") Message-ID: <87aa4o7hzv.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.93 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.2 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) Michael Heerdegen writes: > the docstring of `display-buffer' mentions certain "alists" in several > places, but doesn't say at all how they must look like and what an > effect they have. They are arbitrary association lists, and their effect is left up to the function arguments. I tweaked the docstring to clarify this. From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 12 00:13:52 2012 Received: (at control) by debbugs.gnu.org; 12 Feb 2012 05:13:52 +0000 Received: from localhost ([127.0.0.1]:36685 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RwRl0-00057z-9Y for submit@debbugs.gnu.org; Sun, 12 Feb 2012 00:13:52 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:59740 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RwRky-00057s-8y for control@debbugs.gnu.org; Sun, 12 Feb 2012 00:13:48 -0500 Received: from bb121-7-229-69.singnet.com.sg ([121.7.229.69]:49914 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1RwRjd-0002N9-0A for control@debbugs.gnu.org; Sun, 12 Feb 2012 00:12:25 -0500 From: Chong Yidong To: control@debbugs.gnu.org Subject: close 10785 Date: Sun, 12 Feb 2012 13:12:18 +0800 Message-ID: <87y5s88wjx.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.2 (----) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) close 10785 thanks