From unknown Sun Jun 15 08:30:59 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#10785 <10785@debbugs.gnu.org> To: bug#10785 <10785@debbugs.gnu.org> Subject: Status: 24.0.93; Doc of display-buffer doesn't explain alists Reply-To: bug#10785 <10785@debbugs.gnu.org> Date: Sun, 15 Jun 2025 15:30:59 +0000 retitle 10785 24.0.93; Doc of display-buffer doesn't explain alists reassign 10785 emacs submitter 10785 michael_heerdegen@web.de severity 10785 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 10 18:04:30 2012 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 To: bug-gnu-emacs@gnu.org Subject: 24.0.93; Doc of display-buffer doesn't explain alists 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-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: michael_heerdegen@web.de 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 debbugs-submit-bounces@debbugs.gnu.org Sun Feb 12 00:13:39 2012 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 To: michael_heerdegen@web.de Subject: Re: bug#10785: 24.0.93; Doc of display-buffer doesn't explain alists 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-Debbugs-Envelope-To: 10785 Cc: 10785@debbugs.gnu.org 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 From unknown Sun Jun 15 08:30:59 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 11 Mar 2012 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator