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, 10 Nov 2023 22:13:51 -0500 Message-ID: References: <871qd8sfdx.fsf@posteo.net> <838r7g8pys.fsf@gnu.org> <87bkcbrgnr.fsf@posteo.net> <25924.21015.19614.951576@orion.rgrjr.com> <87bkc4jpja.fsf@dataswamp.org> <87msvnhsdi.fsf@dataswamp.org> <25933.15157.138544.776911@orion.rgrjr.com> 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="23625"; mail-complaints-to="usenet@ciao.gmane.io" Cc: incal@dataswamp.org, emacs-devel@gnu.org To: Bob Rogers Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Nov 11 04:14:37 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 1r1eSD-0005r6-KW for ged-emacs-devel@m.gmane-mx.org; Sat, 11 Nov 2023 04:14:37 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1r1eRV-0006QR-Te; Fri, 10 Nov 2023 22:13:53 -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 1r1eRU-0006QG-GZ for emacs-devel@gnu.org; Fri, 10 Nov 2023 22:13:52 -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 1r1eRT-00038W-Cb; Fri, 10 Nov 2023 22:13:51 -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=z87J+X63G17OalrcuF+ZwyHDxpYmGC5CscV/fKXUse0=; b=D9fHWzP1HRn8 vdgORLqzsf7Ihm/2BfOuEJFNXIOFuiZdrpOIc2yCh0RPsD+qBZsiWsmtoZj09FcCcPfGurcdXdFoe 1b5AXwc8jGO1Lg3IUe/l1ZmMVfRLn3z2zRzcMog8slZnrAON14UVsEzHnajhcnIjhGKXmMHwmNMiT prw8M/JIGHettMuIN+FFn5Ur6CV/NO0MsAHyiJhH/jj7HxCBC5a1jmW0/u/Etgy42RrmDzUOjxskf 64TR/cRN1xjauajHdGFZNH7/m1GuyWZQ+RFtNYF7b83BFF5BYjt/d9yDE/ALcP+W787J4vsh+8E4s JJ4VqpPvdHQ9z5pijhUYwA==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1r1eRT-0003kA-3x; Fri, 10 Nov 2023 22:13:51 -0500 In-Reply-To: <25933.15157.138544.776911@orion.rgrjr.com> (message from Bob Rogers on Thu, 9 Nov 2023 12:04:05 -0800) 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:312522 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. ]]] > Why not instead provide them with docstrings, I think everyone > can agree they should have them? > As a long-time CL/EL hacker, I will also undertake to document cl-lib > functions. I think that is a much easier, and safer, alternative to > trying to recode cl-* usage. Those functions certainly should have doc strings, and adding some is a good thing to do. But that will not cure the larger problem caused by too much usage of those functions. They were meant to be used in a few obsure corners, not used so often that maintainers need to know about them. -- 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)