From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: grischka Newsgroups: gmane.emacs.devel Subject: Re: display-buffer-alist simplifications Date: Mon, 08 Aug 2011 16:01:07 +0200 Message-ID: <4E3FEC23.50101@gmx.de> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1312812098 18293 80.91.229.12 (8 Aug 2011 14:01:38 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 8 Aug 2011 14:01:38 +0000 (UTC) Cc: emacs-devel@gnu.org To: theophilusx@gmail.com Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Aug 08 16:01:33 2011 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QqQOZ-0008GZ-Oc for ged-emacs-devel@m.gmane.org; Mon, 08 Aug 2011 16:01:31 +0200 Original-Received: from localhost ([::1]:49094 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QqQOZ-0005L5-9C for ged-emacs-devel@m.gmane.org; Mon, 08 Aug 2011 10:01:31 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:47972) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QqQOS-0005JI-KM for emacs-devel@gnu.org; Mon, 08 Aug 2011 10:01:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QqQON-0003jX-Q8 for emacs-devel@gnu.org; Mon, 08 Aug 2011 10:01:24 -0400 Original-Received: from mailout-de.gmx.net ([213.165.64.22]:48756) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1QqQON-0003j8-1h for emacs-devel@gnu.org; Mon, 08 Aug 2011 10:01:19 -0400 Original-Received: (qmail invoked by alias); 08 Aug 2011 14:01:17 -0000 Original-Received: from unknown (EHLO [10.129.173.231]) [89.204.139.231] by mail.gmx.net (mp062) with SMTP; 08 Aug 2011 16:01:17 +0200 X-Authenticated: #18588216 X-Provags-ID: V01U2FsdGVkX1+ghbovsC+gvUyqRur/6jgZNWhlaEmU+DGLKkWp5L ZvZJAmNXNrhH7O User-Agent: Thunderbird 2.0.0.24 (Windows/20100228) Original-References: CAC=50j9K-Lo6c75+H=ynobpDhe7nFvOjfM3YLrei+HcO3MB25A@mail.gmail.com X-Y-GMX-Trusted: 0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 213.165.64.22 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:143020 Archived-At: Tim Cross wrote: > However, I still think a doc string of over 280 lines > is excessive and wonder if part of the reason people have trouble > understanding it is that there are conflicting objectives in the > string. On one hand, trying to be very concise and on the other, > trying to explain something potentially complex. It wants to look complex, written with lot of redundancy for people who can't understand concepts, and with lots of 'cons' and 'car' for people who can't read lisp. The message between the lines is clearly: "You don't want to use this if you know what you're doing." --- grischka