From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Helpful in Emacs? Date: Fri, 10 Sep 2021 14:14:20 +0300 Message-ID: <83pmtgisxf.fsf@gnu.org> References: <83wnnoj3gz.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="18618"; mail-complaints-to="usenet@ciao.gmane.io" Cc: me@wilfred.me.uk, stefan@marxist.se, mardani29@yahoo.es, emacs-devel@gnu.org To: Arthur Miller Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Sep 10 13:16:23 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mOeW7-0004db-K9 for ged-emacs-devel@m.gmane-mx.org; Fri, 10 Sep 2021 13:16:23 +0200 Original-Received: from localhost ([::1]:41500 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mOeW6-0006Nq-L1 for ged-emacs-devel@m.gmane-mx.org; Fri, 10 Sep 2021 07:16:22 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46764) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mOeUS-0004tN-3l for emacs-devel@gnu.org; Fri, 10 Sep 2021 07:14:40 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:57150) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mOeUQ-0007le-PN; Fri, 10 Sep 2021 07:14:38 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:3856 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mOeUQ-00071v-CK; Fri, 10 Sep 2021 07:14:38 -0400 In-Reply-To: (message from Arthur Miller on Fri, 10 Sep 2021 10:00:47 +0200) 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:274511 Archived-At: > From: Arthur Miller > Cc: stefan@marxist.se, me@wilfred.me.uk, emacs-devel@gnu.org, > mardani29@yahoo.es > Date: Fri, 10 Sep 2021 10:00:47 +0200 > > What I care most for at the moment are: doc lookup for autoladed functions > without the doc in the stub, and not yet loaded; and code inlined in help buffer, > instead of just plain link. The former would make it possible to save some > space, for example docs does not need to be included in stubs, and can be > fetched on demand. For example package-quickstart.el wouldn't need to pack 800 > kb of docs when some of those will never be requested anyway. If this means asking for help on an autoloaded function will load its package, I don't think it should be the default. We could perhaps arrange for a button that would load the package and display the full documentation, but that's all. > The latter is just plain nice to have. It saves time if I can just scroll other > (help) buffer and read the source without need ot click on link in it to fetch > the source code. Again, displaying the source by default is too much, IMNSHO: the code of a function could be very large. Doing this by default also assumes that the user will necessarily want to look at the source, something that is IME questionable at best. So this should also be optional, and even then the code should be changed to avoid showing a huge *Help* window (since currently, we fit the window size to the text in the *Help* buffer).