From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#73431: Add `setf` support for `stream.el` in ELPA Date: Tue, 29 Oct 2024 14:43:46 +0200 Message-ID: <861pzz6pvh.fsf@gnu.org> References: <827cc7fc-10be-4b93-bd67-f275193e5d84@protonmail.com> <87a5fic3om.fsf@posteo.net> <7de379ab-a4f2-4853-96dc-cdf05dd7218e@protonmail.com> <09504d12-9ca6-4b4d-84ff-c7f9d1087192@protonmail.com> <87o73dmp7q.fsf@web.de> <87ed48mgbu.fsf@web.de> <87ttcwimw8.fsf@web.de> <5d5ae196-f7f2-4b30-aafe-daed980680f1@protonmail.com> <87plnjqli7.fsf@web.de> <87ldy7qjs1.fsf@web.de> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="28774"; mail-complaints-to="usenet@ciao.gmane.io" Cc: okamsn@protonmail.com, philipk@posteo.net, nicolas@petton.fr, monnier@iro.umontreal.ca, 73431@debbugs.gnu.org To: Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Oct 29 13:44:22 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1t5la9-0007HJ-HV for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 29 Oct 2024 13:44:21 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1t5lZs-0006HU-9V; Tue, 29 Oct 2024 08:44:04 -0400 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 1t5lZq-0006HL-RN for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2024 08:44:02 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1t5lZq-0002Pg-It for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2024 08:44:02 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=References:In-Reply-To:From:Date:To:Subject; bh=SJPW4NFvEs01dsp1KQf+bhMN4lJh75jxfdtViZhCArg=; b=Rtsxq0RM13cjzdAoZ3HuXMHN0cP+n498AJwoluV7pIO2jGmPCQDXs6nZ4m2HTX5UXEhJeoYYm3C5wPF6txBiBHsTgeylg5/9JCgl8CbXqhMCkkD0tZf1hlgDXKL9IUNZrJr9ZjVYx2Om07q6k1Oziie7CGMEbSklkLDAViy6LB60hTp7VXltgxr6hGMPJOHdmPDFZI+iRUuj9SC+8iGecWkxRCv3q7ARPtX/jAjXe5zEsz2doTfhJ8hBVfZciJr/zHDaMQomtx3TLqDRShuXIzBzcBef/Ola44aCZ20hokF/OSm2aGkqx1DR8qsFVC3zr3pFgVMtynczkDAJEEZEBQ==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1t5lZp-0003DQ-W9 for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2024 08:44:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 29 Oct 2024 12:44:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 73431 X-GNU-PR-Package: emacs Original-Received: via spool by 73431-submit@debbugs.gnu.org id=B73431.173020584012347 (code B ref 73431); Tue, 29 Oct 2024 12:44:01 +0000 Original-Received: (at 73431) by debbugs.gnu.org; 29 Oct 2024 12:44:00 +0000 Original-Received: from localhost ([127.0.0.1]:56331 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t5lZn-0003D5-JO for submit@debbugs.gnu.org; Tue, 29 Oct 2024 08:43:59 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:55246) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t5lZl-0003Cx-E9 for 73431@debbugs.gnu.org; Tue, 29 Oct 2024 08:43:58 -0400 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 1t5lZe-0002Od-2F; Tue, 29 Oct 2024 08:43:50 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=SJPW4NFvEs01dsp1KQf+bhMN4lJh75jxfdtViZhCArg=; b=Ieoe5lSu7hF7 ZxKNiUqfWhqIKHUZbR6GX7jsXGfP1AvSuimrjJ11MHGaFa6Yl0iFw+4GqJbIj3i+6/VJd6xAEstEY qNyYPl3lQbw0r6gfMs/ccHUPWGCN70sHPmRFviXLIubyj4U7LVOvMsDgwzGI1vmY5DuAPcI3qHACW Ck72lhupMREVmzqXqK0c6PuOO+lURQiBqpxykYIVYAyyNgLegalXhT3o5HZpmy9TVSFF7uxie6NLC kYZOMYBytgM1wN4F8+DQmHbkVKikfU2tNKKMKMFVegsCUQ6nHijZU9ciPwKJvSi5ViaPK5D24gkDJ Os4cZWtP3D9V8l1180x1MQ==; In-Reply-To: <87ldy7qjs1.fsf@web.de> (bug-gnu-emacs@gnu.org) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:294482 Archived-At: > Cc: Okamsn , philipk@posteo.net, nicolas@petton.fr, > 73431@debbugs.gnu.org > Date: Tue, 29 Oct 2024 11:35:10 +0100 > From: Michael Heerdegen via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > Is it allowed for method docstrings that the first line is not a > complete sentence with these and that requirements? Then I would remove > the first, redundant and thus confusing sentence (doesn't tell anything > about this implementation) and use a docstring like > > "Example: > > (the Fibo example ...)" The rule that the first line should be a complete sentence (actually, a summary) is for the benefit of the apropos commands, which show only the first line of each doc string. So the answer to your question depends on whether these methods can wind up in output of apropos commands, and what happens if and when they do.