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: dash.el [was: Re: Imports / inclusion of s.el into Emacs] Date: Sun, 10 May 2020 09:18:58 +0200 Message-ID: References: <0c88192c-3c33-46ed-95cb-b4c6928016e3@default> <87wo5mc04t.fsf@fastmail.fm> <835zd5h6tq.fsf@gnu.org> <87wo5kqzjc.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="99635"; mail-complaints-to="usenet@ciao.gmane.io" To: Richard Stallman , Philippe Vaucher , Joost Kremers , Emacs developers Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun May 10 09:20:14 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 1jXgFy-000PoV-5X for ged-emacs-devel@m.gmane-mx.org; Sun, 10 May 2020 09:20:14 +0200 Original-Received: from localhost ([::1]:60138 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jXgFw-0000Pt-Nl for ged-emacs-devel@m.gmane-mx.org; Sun, 10 May 2020 03:20:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34910) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jXgFE-0008CH-0u for emacs-devel@gnu.org; Sun, 10 May 2020 03:19:28 -0400 Original-Received: from mail-lj1-x229.google.com ([2a00:1450:4864:20::229]:39337) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jXgFD-0006bq-3P; Sun, 10 May 2020 03:19:27 -0400 Original-Received: by mail-lj1-x229.google.com with SMTP id u6so6023929ljl.6; Sun, 10 May 2020 00:19:26 -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; bh=tASy4YBptlcQrj/BQR1SsADM6W89rGXYXn52LCG3dtU=; b=NppZMuc3U9xKFo+qd8DvuULjTj2DldqNvStMb/qVZnihswIcQ+XAhKH72e/SXx5U/6 OyoFH335YLhbpbKVBVYH0UJ2/X2Hvu0egZmGkFyxzlDKH5zTasSHSqXFO3yWG/7z/ltt McEpnTCNoDXIZXWd+fzu7D4Oa5GFsEr1C+GLpLG6ulD8hb/hoaaEHfHp6S/eo4Yp4Ffz uukIn+DdbAhkuUTC+xPtYcT7LW4m+2s4vGRtbPdDaGJ+dJi5Rbg+5QixcfPcrHL9t0lb 81yU1GpVptWeUkSoKkEOSlezbf1WeBVw/OonQYRUg9A56TRCkWIkp8sAW/164JCB1pjh cQgw== 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; bh=tASy4YBptlcQrj/BQR1SsADM6W89rGXYXn52LCG3dtU=; b=UeAN0cWEBZjdhKOe464Bxxy7ZFRZwPajDSX5uLB4S2TizsmFA3551SCkIxh1c3Dctb P8O/H4f1nhzz1gtYLoRk635SZNfHTPUb1p2QdqOHtJRckTkDBRdfyuOqg+b/xJsG7KNY hqWVDB0Loj13yEUpN9ZQe9OAnLQvgXYO5ji7Hfd9qYOiV1bcDZdWhV+kMB8t+k4M05/R NwkFbiVF/M+Rck+8abwTf8WsR3X9Ubjb93Lpxq2onuGfC/QCmHIBJhLjIldbdbwYcXGq vR/y9/dVktXSrJckFYShydACkkK4OySb8tFMZGNoVg535OldUa5IevM+lEpp8aQM+qLn aYOQ== X-Gm-Message-State: AOAM532fmBDyU6QzvOZjS1T++/IThuPYg/b5v5iGwPRFSOk7NRxmppZG VYkKBnW1xBByyRYWNBLMfujHJ/TOXFNTlbSEGJuQnl/3G4I= X-Google-Smtp-Source: ABdhPJx2GwG8F04DsktolGxiriJkT4EyleKPge90qC8v46vn7SlP1fjYyS5uVEIunxZc8pyPEj1LM/fBLrP6n88Ynog= X-Received: by 2002:a2e:700e:: with SMTP id l14mr6694329ljc.135.1589095164799; Sun, 10 May 2020 00:19:24 -0700 (PDT) In-Reply-To: <87wo5kqzjc.fsf@gnu.org> Received-SPF: pass client-ip=2a00:1450:4864:20::229; envelope-from=philippe.vaucher@gmail.com; helo=mail-lj1-x229.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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:249638 Archived-At: > > > > Would you like to send me the API documentation of s.el? > > > > > https://github.com/magnars/s.el > > > > The URL suggests it is actually the source code. I can make do with > > that, but I would rather get just the API spec, so I can honestly say > > I never read the source code. > > Indeed, the address may suggest it's an el file, but in fact it is not, > and it's the URL for the git repository containing s.el and other files. And when you arrive on this page, the README is displayed which is the API spec. It starts with a short summary of the function (from which I already understand 95% of what it does just by reading the signature) and then for each function if you click you have a longer description of what it does and a small example of use.