From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Jean-Christophe Helary Newsgroups: gmane.emacs.devel Subject: Re: Imports / inclusion of s.el into Emacs Date: Sun, 3 May 2020 18:48:06 +0900 Message-ID: References: <87ftchy0go.fsf@gnus.org> <87368hxwj4.fsf@gnus.org> <87y2q9we56.fsf@gnus.org> Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.80.23.2.2\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="119848"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Stefan Monnier , Richard Stallman , Emacs developers To: Lars Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun May 03 11:49:13 2020 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 1jVBFI-000V6A-I6 for ged-emacs-devel@m.gmane-mx.org; Sun, 03 May 2020 11:49:12 +0200 Original-Received: from localhost ([::1]:51678 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jVBFH-0002TT-Kh for ged-emacs-devel@m.gmane-mx.org; Sun, 03 May 2020 05:49:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51002) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jVBEe-0001sq-O0 for emacs-devel@gnu.org; Sun, 03 May 2020 05:48:32 -0400 Original-Received: from relay3-d.mail.gandi.net ([217.70.183.195]:39511) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jVBEc-0003IW-SQ; Sun, 03 May 2020 05:48:32 -0400 X-Originating-IP: 128.53.210.217 Original-Received: from [10.0.1.13] (pl6361.ag0304.nttpc.ne.jp [128.53.210.217]) (Authenticated sender: jean.christophe.helary@traduction-libre.org) by relay3-d.mail.gandi.net (Postfix) with ESMTPSA id DCB7160007; Sun, 3 May 2020 09:48:08 +0000 (UTC) In-Reply-To: <87y2q9we56.fsf@gnus.org> X-Mailer: Apple Mail (2.3608.80.23.2.2) Received-SPF: pass client-ip=217.70.183.195; envelope-from=jean.christophe.helary@traduction-libre.org; helo=relay3-d.mail.gandi.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/03 03:58:12 X-ACL-Warn: Detected OS = Linux 3.11 and newer [fuzzy] X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action 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:248668 Archived-At: > On May 3, 2020, at 18:39, Lars Ingebrigtsen wrote: >=20 > Jean-Christophe Helary > writes: >=20 >>> On May 3, 2020, at 17:17, Lars Ingebrigtsen wrote: >>>=20 >>> (The one thing s.el has, though, is an excellent overview of the >>> functions: Just a list of all the functions, and examples that show = how >>> they work. This is what most people who are trying to use a new >>> language wants -- very few people are interested in reading a = manual.) >>=20 >> And that is *very much* one of the things that is being discussed = here :) >=20 > Perhaps we should just have an in-Emacs solution for the = discoverability > problem. >=20 > For instance, the doc strings of all the string related functions = could > have a link "For more string functions, click here" and then you're > taken to a (info?) buffer that lists all the functions in the style of > s.el's overview. That is, just function signatures and examples, no > in-depth talk at all. >=20 > (The functions could link to the "real" manual pages, of course.) The helpful package does a lot of extra linking and formatting. Have you = checked it ? Jean-Christophe Helary ----------------------------------------------- http://mac4translators.blogspot.com @brandelune