From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#10785: 24.0.93; Doc of display-buffer doesn't explain alists Date: Sat, 11 Feb 2012 00:04:22 +0100 Message-ID: <874nuyi93d.fsf@web.de> Reply-To: michael_heerdegen@web.de NNTP-Posting-Host: plane.gmane.org X-Trace: dough.gmane.org 1328915033 11586 80.91.229.3 (10 Feb 2012 23:03:53 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 10 Feb 2012 23:03:53 +0000 (UTC) To: 10785@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Feb 11 00:03:52 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RvzVQ-0001YN-Ag for geb-bug-gnu-emacs@m.gmane.org; Sat, 11 Feb 2012 00:03:52 +0100 Original-Received: from localhost ([::1]:57119 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RvzVP-0000Pt-HE for geb-bug-gnu-emacs@m.gmane.org; Fri, 10 Feb 2012 18:03:51 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:57473) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RvzVM-0000Lm-Qi for bug-gnu-emacs@gnu.org; Fri, 10 Feb 2012 18:03:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RvzVL-0007Y0-E6 for bug-gnu-emacs@gnu.org; Fri, 10 Feb 2012 18:03:48 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:60017) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RvzVL-0007Wx-9b for bug-gnu-emacs@gnu.org; Fri, 10 Feb 2012 18:03:47 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1RvzWY-0001FX-9v for bug-gnu-emacs@gnu.org; Fri, 10 Feb 2012 18:05:02 -0500 X-Loop: help-debbugs@gnu.org 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: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.13289150704763 (code B ref -1); Fri, 10 Feb 2012 23:05:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 10 Feb 2012 23:04:30 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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) Original-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 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:56776 Archived-At: 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''