From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] master 29d1c72: Introduce new value t for compilation-context-lines to eliminate scrolling Date: Mon, 2 Sep 2019 19:34:05 +0000 Message-ID: <20190902193405.GB4133@ACM> References: <20190825102323.5080620CD5@vcs0.savannah.gnu.org> <20190825190637.GE4724@ACM> <838srhghoc.fsf@gnu.org> <20190826162651.GA4137@ACM> <83ef17gaar.fsf@gnu.org> <20190827200520.GC20676@ACM> <8336hjbzn5.fsf@gnu.org> <20190831105316.GA4822@ACM> <83woet8uh5.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="101798"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mutt/1.10.1 (2018-07-13) Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 02 21:40:39 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1i4sBq-000QNK-1w for ged-emacs-devel@m.gmane.org; Mon, 02 Sep 2019 21:40:38 +0200 Original-Received: from localhost ([::1]:39554 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i4sBo-0001LH-Pv for ged-emacs-devel@m.gmane.org; Mon, 02 Sep 2019 15:40:36 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51542) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i4s5l-000544-BR for emacs-devel@gnu.org; Mon, 02 Sep 2019 15:34:22 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i4s5k-0007Zw-49 for emacs-devel@gnu.org; Mon, 02 Sep 2019 15:34:21 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:37245 helo=mail.muc.de) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1i4s5j-0007Tz-Ui for emacs-devel@gnu.org; Mon, 02 Sep 2019 15:34:20 -0400 Original-Received: (qmail 77344 invoked by uid 3782); 2 Sep 2019 18:41:15 -0000 Original-Received: from acm.muc.de (p4FE15DD5.dip0.t-ipconnect.de [79.225.93.213]) by colin.muc.de (tmda-ofmipd) with ESMTP; Mon, 02 Sep 2019 20:41:13 +0200 Original-Received: (qmail 4660 invoked by uid 1000); 2 Sep 2019 19:34:05 -0000 Content-Disposition: inline In-Reply-To: <83woet8uh5.fsf@gnu.org> X-Delivery-Agent: TMDA/1.1.12 (Macallan) X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 9.x [fuzzy] X-Received-From: 193.149.48.1 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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" Xref: news.gmane.org gmane.emacs.devel:239780 Archived-At: Hello, Eli. On Sat, Aug 31, 2019 at 14:06:30 +0300, Eli Zaretskii wrote: > > Date: Sat, 31 Aug 2019 10:53:16 +0000 > > From: Alan Mackenzie > > Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org > > > The subsection describing the display margins is part of the section > > > which documents the 'display' properties in general, so I think it's > > > in a correct and logical place. > > > Where would you expect it to be mentioned, not to be "buried"? > > Maybe on the page "Emacs Display", rather than the current menu point: > > * Display Property Enabling special display features. > > , something like: > > * Display Property Images, margins, text size, etc. > > might be more helpful. > We could perhaps mention it in some higher-level section, but moving > this subsection up two levels is too much, I think. What I've proposed is purely changing the caption on the menu point, not moving any section text. I think that the text "Enabling special display features" is frustratingly vague, repetitive and uninformative. "Images, margins, text size, etc.", by contrast, gives the reader reason to follow the menu point. > > As above, I think a complete example in the "Display Margins" page would > > be helpful. I'll get around to formulating this some time (soon?). > Thanks. -- Alan Mackenzie (Nuremberg, Germany).