From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?UTF-8?B?Sm/Do28gVMOhdm9yYQ==?= Newsgroups: gmane.emacs.devel Subject: Re: What's missing in ELisp that makes people want to use cl-lib? Date: Thu, 9 Nov 2023 12:40:24 +0000 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> <8a7362da-3cc4-221c-7b8a-a9918677adff@gutov.dev> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="28648"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Alan Mackenzie , =?UTF-8?Q?Gerd_M=C3=B6llmann?= , =?UTF-8?B?QmrDtnJuIEJpZGFy?= , emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Nov 09 13:41:39 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 1r14Lq-0007FI-IW for ged-emacs-devel@m.gmane-mx.org; Thu, 09 Nov 2023 13:41:38 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1r14LG-0002h6-1M; Thu, 09 Nov 2023 07:41:02 -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 1r14L3-0002cz-F6 for emacs-devel@gnu.org; Thu, 09 Nov 2023 07:40:53 -0500 Original-Received: from mail-lf1-x12c.google.com ([2a00:1450:4864:20::12c]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1r14Kz-0002s2-6y for emacs-devel@gnu.org; Thu, 09 Nov 2023 07:40:48 -0500 Original-Received: by mail-lf1-x12c.google.com with SMTP id 2adb3069b0e04-507a98517f3so976449e87.0 for ; Thu, 09 Nov 2023 04:40:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1699533636; x=1700138436; darn=gnu.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=GDs2avfFtdpUpU2MSySfPtnQbpyioi5fQ5D92topHjU=; b=Yfnk42luedMdsz/dZjkxCoALI/u1i2wJ/uzFUk/8w0JzxKiq/MrrErGyOwc2uoT1+t mDRubqBiUCQ1RsFCDOIGKcCM3C3zbsm88V080EHQCf44iYDCTw62ys7C3mb3AyXnRyWx 8Bx1QbW44RyZoQxhQ5GYurf5x9yUCunJ+zj1vHocnZ0NoqdjMh3ac+1KzN68AzO3AaP/ bDFgFN1ZpcZj1Nk0Q7rkrAskH4GSYxp7JNehECM5JB9jLZxWNBfZNvItwcvrTaACwDU2 DPRshyVD7ruDncdHK1hrFYybpS+9bT3r7b+3ofKdPVNXddt3ti1eESGjqku7/gmWypL8 Tlng== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1699533636; x=1700138436; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=GDs2avfFtdpUpU2MSySfPtnQbpyioi5fQ5D92topHjU=; b=qT2TF8D3bbGNhKAx1kXMGEVCMTCfHEmsyj0UMqCp0rfP5PLUxUoTNEJFCw0YLu0/P0 5WB6o18dWGrfD0QDATzOJx4zQJtGRNJGZwOCXpW0c+w7MSbJgRZvx7KZ/nWEBqeGwlj7 +zNOz+KEV56I5WZauNjUicuccjz6Y+GvjlpgtmQVxCzdO88/ZgJWdCofH4OLSzkftxwr TjTkGVvL095yYPF0C8T8hFNsn+Z5qRXyE2if7rhUk/cs23V5juDGax/7QZP7vKKrWyZ/ AU5PUnpqOIUCbfkSGsk9BMpmp4C8zXnf9ajrP8PRUwJOGJosA2NwLn6c/Yvk1CjgZR+K lQoQ== X-Gm-Message-State: AOJu0YyQhLKkX6psvz3ylodd09sA1D9DjwTxwWFDKwiRpBPKZV4a8vOU M4496V7s9fKK1Km/yCYgUISDArju3+d0I45Y2cs= X-Google-Smtp-Source: AGHT+IEQfbRE9yDFXrG3RawpBbmFykNFCVckM7DQ3X2HV/N2NKVbf3Czq7/MfudmoSInkso2dn/y9wMqwvl6bkk1tBg= X-Received: by 2002:ac2:5ed0:0:b0:503:3453:ea7a with SMTP id d16-20020ac25ed0000000b005033453ea7amr1307824lfq.66.1699533635707; Thu, 09 Nov 2023 04:40:35 -0800 (PST) In-Reply-To: <8a7362da-3cc4-221c-7b8a-a9918677adff@gutov.dev> Received-SPF: pass client-ip=2a00:1450:4864:20::12c; envelope-from=joaotavora@gmail.com; helo=mail-lf1-x12c.google.com 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_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action 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:312404 Archived-At: On Thu, Nov 9, 2023 at 11:49=E2=80=AFAM Dmitry Gutov wro= te: > Improving cl-lib's documentation would be a welcome effort. For sure, and not a hard one as well, as all those functions and macros are pretty good, often flawless emulations of CL functions that are impeccably documented in http://www.lispworks.com/documentation/HyperSpec/Front/ Which is of free access (though not of a compatible license, I think). But if people can point to the 5 most confusing functions they think are poorly documented, I volunteer to rewrite the docstrings for them. Jo=C3=A3o