From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: =?UTF-8?B?Sm/Do28gVMOhdm9yYQ==?= Newsgroups: gmane.emacs.devel Subject: Re: Imports / inclusion of s.el into Emacs Date: Sat, 2 May 2020 15:55:25 +0100 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: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="11699"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Eli Zaretskii , Dmitry Gutov , Stefan Monnier , Richard Stallman , Emacs developers To: Philippe Vaucher Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat May 02 16:56:20 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 1jUtYy-0002wR-8q for ged-emacs-devel@m.gmane-mx.org; Sat, 02 May 2020 16:56:20 +0200 Original-Received: from localhost ([::1]:55682 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jUtYx-000331-9d for ged-emacs-devel@m.gmane-mx.org; Sat, 02 May 2020 10:56:19 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47092) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jUtYM-0001xd-7J for emacs-devel@gnu.org; Sat, 02 May 2020 10:55:42 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jUtYL-0004Ig-MU for emacs-devel@gnu.org; Sat, 02 May 2020 10:55:41 -0400 Original-Received: from mail-il1-x141.google.com ([2607:f8b0:4864:20::141]:37186) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jUtYK-0004Eo-3K; Sat, 02 May 2020 10:55:40 -0400 Original-Received: by mail-il1-x141.google.com with SMTP id u189so7088044ilc.4; Sat, 02 May 2020 07:55:39 -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:content-transfer-encoding; bh=jY8aixabrrOTj+hETXoF59Z1GfWss5rxyhS8VMyAqyk=; b=CG2I8wgpmBJvU0gpsFF1ENYgOCNipDWWLlG4wj0BpQc4uHxVrKXlQaOFYGhWHHi+n6 4zvV4J2lPy2et4WQ1vxzGlCUS84LMh8Ijv82jyTVUhitSLz51sgx29g5OWhhTRrS8qnZ j8hS5KpAntlJp6RODEYVy2CFti3jqgbNaxzBnZZ/MKxwHalE3Tzaxnk/R/KpHbPkH3vk mbZMDwwhDqoaAERJl4dxf4WWNGOwjw6YpdO8INwFxPzhHQr1isEGy/1S2jDylNlicTUw 8PZ1tCkhXj6p3mHCHcUTp4y+kc/tXCz3+tUjP1ygYW53qnAq4mvRSD/7I+If5hI0DXPs iOCw== 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:content-transfer-encoding; bh=jY8aixabrrOTj+hETXoF59Z1GfWss5rxyhS8VMyAqyk=; b=F7uLZdC5oeuoMCpnGJiWqSkQOXA2BPypb4Rggeq+JGi94MuZ5aTlPyvrBbP/xlr/zz Qj2YrHKsSE7kjNBzYuhQ+6hAAgbHJZr+rYNV79T0qVi9YES7DaQKhNxi0rnm3sMqBlG5 DI2X1csqSOPUjHX19FdpqbONzrNnGZTw1N31lhOCzW08yUh0KUIl66LkBXuftpEUwegy 0xpdNCHk35MKMyWHVUTzRPZojMW8VkE8i73lXWpe47R2yitcVNCHjHh3CDj7zXFTrVr1 q3dmc/hih/jwGfX+Q2qGhVIi9QUtbmi0k+kKYlfWIPFdBJ86sW6qqIaQ+cjyqADbDVKB 9gZw== X-Gm-Message-State: AGi0PuZy2Hkq1zR44eKa3UBpylEU708B59L3Ub6swJv4CeWmAk9PFVMm 6prOgCcOwxBCGujYupEk7jJMxJt1Wo8UUbncXs4= X-Google-Smtp-Source: APiQypJIVLPRMCXJu7E5UoRmivriSLVEpcyeOR9cG1OzjqOt1Z6izyYAC1sXCoPQc4AoK5jZN6IODYR+vnbfkrmc9Yc= X-Received: by 2002:a92:4a11:: with SMTP id m17mr8260087ilf.125.1588431338545; Sat, 02 May 2020 07:55:38 -0700 (PDT) In-Reply-To: Received-SPF: pass client-ip=2607:f8b0:4864:20::141; envelope-from=joaotavora@gmail.com; helo=mail-il1-x141.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: 2607:f8b0:4864:20::141 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:248458 Archived-At: > But when I'm discovering the API, it's a gold mine. Some of us are trying to tell you is that the Elisp manual is a gold mine, too. If you see parts where it is not, report it. Lisp languages are traditionally organized differently. If you like some "overview by topic" tool, you yourself have shown it can be built easily (in that "keep-lines" example). Let's do that first and then think it it's still worth including many new foreign words, not the reverse. Jo=C3=A3o On Sat, May 2, 2020 at 3:43 PM Philippe Vaucher wrote: >> >> > 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 o= ften. 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 eve= rytime 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 happe= n 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 do= n't mind the occasional confusion when you have to search 3 times before fi= nding what you want (correct me if I'm wrong). > > Philippe --=20 Jo=C3=A3o T=C3=A1vora