From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: What's missing in ELisp that makes people want to use cl-lib? Date: Fri, 17 Nov 2023 22:03:54 -0500 Message-ID: References: <8734xetjkk.fsf@yahoo.com> <87cywhsrcf.fsf@yahoo.com> <87cywgx1z0.fsf@web.de> <83wmuowwp3.fsf@gnu.org> <8334xcwank.fsf@gnu.org> <320999cc-6c83-2315-0044-cc0403400af3@gutov.dev> <9ab5d2bd-a648-cae0-a4a7-ae86be10af0f@gutov.dev> <87r0kuqxbf.fsf@gmail.com> <54e115a2-fc36-3056-a030-0dbf32416ddb@gutov.dev> <43f290b0-4119-597b-c89a-0fb4c7db1665@gutov.dev> <87bkbtn79k.fsf@web.de> <87wmuhpxxv.fsf@gmail.com> <87v8a1lodp.fsf@web.de> <83msvdps4k.fsf@gnu.org> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39973"; mail-complaints-to="usenet@ciao.gmane.io" Cc: eliz@gnu.org, michael_heerdegen@web.de, emacs-devel@gnu.org To: =?iso-8859-1?Q?Jo=C3=A3o_T=C3=A1vora?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Nov 18 04:04:43 2023 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 1r4BdT-000A7F-1I for ged-emacs-devel@m.gmane-mx.org; Sat, 18 Nov 2023 04:04:43 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1r4Bcl-0006l5-Hr; Fri, 17 Nov 2023 22:03:59 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r4Bcj-0006kX-C3 for emacs-devel@gnu.org; Fri, 17 Nov 2023 22:03:57 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r4Bci-0005Tq-Ew; Fri, 17 Nov 2023 22:03:56 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=b/OYlwACMHBrZzvYyKCfj2l4SMXpIdst+7R8S5YRpxA=; b=H/5eeoyTUZPJ v5TPlPs8D38tplwW5tncb+UDMDSjmp4+SQq+N1nA/mtSfxp4mIXODM4Iv4JWYwtt01kl4/FhwTlis MYMWl5nP7fFHkVuTRx6HrB8sBQjcEhsKtfbhGKNvUZ47aL79QmQeMnIBoFHBomJkUcddgR/hQFuxS pSuxychH8H3rmLhGqfw4pmTfh6wZkjD7wved0Ii7K1AEjXUEI6olnAfxVaiEiG6ud+JiS58V73OnP R7kg+LePEjsJkie4IERF41R3tNA4472bXmSDDY+i4cSwhd8KW2u2RTdRkeXsf28ORCy1g2N//MiBz Pg6YDOwrN4QbH9XxczOx9w==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1r4Bcg-00042t-0H; Fri, 17 Nov 2023 22:03:54 -0500 In-Reply-To: (message from =?iso-8859-1?Q?Jo=C3=A3o_T=C3=A1vora?= on Thu, 16 Nov 2023 21:58:51 +0000) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:312885 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > ?? There's a whole section in the ELisp manual called "Sequence > > Functions", which documents the seq-* functions. > Yes, but from a custom sequence implementors perspective, > the "best" documentation is still that bit in the header, > which describes "you must implement these to get a working > custom sequence". > So while the Elisp manual addresses custom sequences > (very briefly -- it just tells the user to look up generic > functions) it spends most time describing the generic > functions one by one, and while that's important, it's > just not enough. We need both of these two kinds of documentation. The Emacs Lisp Reference Manual should say how to _use_ the seq functions, and comments in seq.el should say how to understand and maintain it. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)