From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Philippe Vaucher Newsgroups: gmane.emacs.devel Subject: Re: Imports / inclusion of s.el into Emacs Date: Sat, 2 May 2020 16:42:23 +0200 Message-ID: References: <831ro2tqqx.fsf@gnu.org> <4a1fd3f4-df92-c756-9874-4d07b54148ac@yandex.ru> <83v9lesapw.fsf@gnu.org> <83pnbms9m8.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="000000000000dc252a05a4ab4f3a" Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="86159"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Emacs developers , Stefan Monnier , Richard Stallman , Dmitry Gutov To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat May 02 16:43:24 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 1jUtMS-000MH6-09 for ged-emacs-devel@m.gmane-mx.org; Sat, 02 May 2020 16:43:24 +0200 Original-Received: from localhost ([::1]:45144 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jUtMR-00038a-2S for ged-emacs-devel@m.gmane-mx.org; Sat, 02 May 2020 10:43:23 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:41848) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jUtLy-0002gX-Bu for emacs-devel@gnu.org; Sat, 02 May 2020 10:42:54 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jUtLx-0003yu-TA for emacs-devel@gnu.org; Sat, 02 May 2020 10:42:54 -0400 Original-Received: from mail-lf1-x129.google.com ([2a00:1450:4864:20::129]:43861) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jUtLw-0003ql-G8; Sat, 02 May 2020 10:42:52 -0400 Original-Received: by mail-lf1-x129.google.com with SMTP id 188so6014347lfa.10; Sat, 02 May 2020 07:42:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=moeH2phLEBxFP0Evm1mEbYbXaBTrULboPCfvONMZbcY=; b=dfbV7B75JluaRnXcyrYCxXE6GeF6zHnMqc6uKp1tWOMZtyu9Xfufz2JKG6RGJ11ML6 I8Lrx9NcZB/PpBfXyzhaI8yIwsWgyPitG3sR+ht4MaJaEB2nxyS4hj985JGrWlIpWfRy N14fPls1f7HuDK4H+WDOpgZUYHIyQFWu/Oe1WlIjKtsTifzhH2f5BUdgAChYRpbPAEBZ yQxA7wcXY5ZuXyxM+kUsmqIHWBVwQeyq9BxJDUrQ9bmB+0TfPyUqHKz0OzIoPLBO73zL D7pkM1tVPq373aBESrbqLWsqeVMjqWo8Ka9WT4aPkB26y7rsWhsUEOKmmVfZwY0XFmfu 1SDA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=moeH2phLEBxFP0Evm1mEbYbXaBTrULboPCfvONMZbcY=; b=ccLID5maXXKMe3bfxZSUGN/tdNhNGkndlF/GIFoENTpyvMtNnnmGrUwmJXTcHT+g0V 2DWXAQryeFHXBM2PpBvzZCZb6R019PEmW8UuiirkQd9dE97asALCpE88xgNykMNo/gmK 5ZwtTy0PLjuHCktsacu8QNAtjArL7ZIsUfo31ZV5L4tfgduh6DrXJsoit0udnck+7CIE zV5JzmhEXu7dL1XB0tYt/l7ph9B4BTBQXQWRHHKcwOLsVezCqdt/BYIy6g19RgAb3FTG pLsXT4arAehf0PSJd0MhuB/yesZYbQkiiPEFSWL/D8FSvi0h+yjCsEBtypeZYVXqFrMH 4IwQ== X-Gm-Message-State: AGi0PuYOmYfzOJzhea0YoiEAd3Dyff6ZZZl6aKotSnp+YMOSa/5Bn4F0 8T/WU08YVxSf416h11PWrjhF4Mb/AYeDaS94iRnzEYw8U3Q= X-Google-Smtp-Source: APiQypL0tcaqfaukRAfUdlJY1zcg3Y0LiaVKLyBtIw9Dt4FZNUl4CYLxH2+oiiYTEjXXTY/jzX56mZbphWHlrtSnBJQ= X-Received: by 2002:a05:6512:53a:: with SMTP id o26mr5806402lfc.111.1588430569742; Sat, 02 May 2020 07:42:49 -0700 (PDT) In-Reply-To: <83pnbms9m8.fsf@gnu.org> Received-SPF: pass client-ip=2a00:1450:4864:20::129; envelope-from=philippe.vaucher@gmail.com; helo=mail-lf1-x129.google.com X-detected-operating-system: by eggs.gnu.org: Error: [-] PROGRAM ABORT : Malformed IPv6 address (bad octet value). Location : parse_addr6(), p0f-client.c:67 X-Received-From: 2a00:1450:4864:20::129 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:248455 Archived-At: --000000000000dc252a05a4ab4f3a Content-Type: text/plain; charset="UTF-8" > > > https://ruby-doc.org/core-2.2.0/File.html > > Thank you. This shows 60 file-related functions. Does anyone want to > look through a list that long to find what they need? I don't. Does anyone? Yes, me and I suspect thousands of people. This is the crux of the issue. You never need to do that, and I to that often. When I search for a single function I'm like you, I don't really need that list. But when I'm discovering the API, it's a gold mine. I can just read that, quickly understand what it offers and what it does not. Also everytime I fall on that list it reminds me of almost the whole API because it's so condensed. Because it's all grouped in one place I can also curiously click on the names and quickly read what they're about, which cannot happen in the Emacs manual's "paragraph form". Hope I was able to give you some insights about how I & other function. I totally understand your point of view tho, you just always search exactly for what you want, you think viewing this overview is overrated, and you don't mind the occasional confusion when you have to search 3 times before finding what you want (correct me if I'm wrong). Philippe --000000000000dc252a05a4ab4f3a Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
> https://ruby-doc.org/core-2.2.0/Fil= e.html

Thank you.=C2=A0 This shows 60 file-related functions.=C2=A0 Does anyone wa= nt to
look through a list that long to find what they need?=C2=A0 I don't.

Does anyone? Yes, me and I suspect thousands = of people.

This is the crux of the issue. You neve= r need to do that, and I to that often. When I search for a single function= I'm like you, I don't really need that list. But when I'm disc= overing the API, it's a gold mine. I can just read that, quickly unders= tand what it offers and what it does not. Also everytime I fall on that lis= t it reminds me of almost the whole API because it's so condensed. Beca= use it's all grouped in one place I can also curiously click on the nam= es and quickly read what they're about, which cannot happen in the Emac= s manual's "paragraph form".

Hope I = was able to give you=C2=A0some insights about how I & other function. I= totally understand your point of view tho, you just always search exactly = for what you want, you think viewing this overview is overrated, and you do= n't mind the occasional confusion when you have to search 3 times befor= e finding what you want (correct me if I'm wrong).

=
Philippe
--000000000000dc252a05a4ab4f3a--