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 17:43:43 +0200 Message-ID: <86h68u6hjk.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> <861pzz6pvh.fsf@gnu.org> <87zfmnujbd.fsf@web.de> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="11540"; 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 16:44:14 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 1t5oOD-0002ow-VJ for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 29 Oct 2024 16:44:14 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1t5oO7-0001d4-HC; Tue, 29 Oct 2024 11:44:07 -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 1t5oO5-0001ZN-Tb for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2024 11:44:05 -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 1t5oO2-0003Qh-H3 for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2024 11:44:05 -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=ailHV0NusDaUfOdBtLFyVLW0f2+IUwlGr1OGGTYEoiI=; b=SnSZY8IpiY1xSuhFJsDrKIxWK5tgZwMjEYN/658ke76UG7ytQttTpSeFb6P3BWyvLfycG053/7Zknln8iC6D4udqMF8X+ja8qWYeiggditBY1XcYfDUceVdE9S/x8f2CKWzNmGX/5DVf54D2ALujWTzGGb65OFXcz68xSPmaHbGYLv3/SPEZ2N5hPEFJR+mPfnuhAVMW3yu7as9nr9/vqY3dQqRYVFIQOkaRbE7hEoPaqsE7DnTtIo0K5W92lipG0QABKIVXhExo3jiUYMR5mUrH8cX/bO0RhZ+0/ojhWnVbfXRh0dYT3RIJR+hkkIIV4JdCmIxGrP9X42YJM2Qplg==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1t5oO2-0000g6-CG for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2024 11: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 15:44:02 +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.17302166352593 (code B ref 73431); Tue, 29 Oct 2024 15:44:02 +0000 Original-Received: (at 73431) by debbugs.gnu.org; 29 Oct 2024 15:43:55 +0000 Original-Received: from localhost ([127.0.0.1]:57042 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t5oNv-0000fl-47 for submit@debbugs.gnu.org; Tue, 29 Oct 2024 11:43:55 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:57268) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t5oNt-0000ff-4U for 73431@debbugs.gnu.org; Tue, 29 Oct 2024 11:43:54 -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 1t5oNl-0003PS-MD; Tue, 29 Oct 2024 11:43:45 -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=ailHV0NusDaUfOdBtLFyVLW0f2+IUwlGr1OGGTYEoiI=; b=TBnLMGvU/8EZ E4nO+xU/+P/XPoG165KFEdMHU18t3QM/m2vEmI7mdZGe5Hf4uMnKJ8nQKPd/m80zlqSztLYIwz9ro t0leHN1/6g5v/DfU2FK4EB4++xmah/M8WFXBDrVa2L2rcDIqhY2jGtuYgxYCA8mlEhw+l4UuBtkRe kSswfpZ6FQiVMfYJC7X9QY+eWIuAzIkNupE0EYWhR0l6MWzY7HIeoU/KLoFoEUb52T64V2qChDnp4 bXjWGQb+VNg69rBVXf8sf4JDmWO31c1iefXYpGAF8xc3XjGppnnIUIJUtHFgqPNbhsOFS05k6JHCl tdoBz2nnNazufJ00O4tYcA==; In-Reply-To: <87zfmnujbd.fsf@web.de> (message from Michael Heerdegen on Tue, 29 Oct 2024 14:31:34 +0100) 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:294501 Archived-At: > From: Michael Heerdegen > Cc: monnier@iro.umontreal.ca, okamsn@protonmail.com, philipk@posteo.net, > nicolas@petton.fr, 73431@debbugs.gnu.org > Date: Tue, 29 Oct 2024 14:31:34 +0100 > > Eli Zaretskii writes: > > > 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. > > Thanks. > > At the first glance this doesn't seem the case. We do have this FIXME > in "apropos.el" though: > > ;; FIXME: Print information about each individual method: both > ;; its docstring and specializers (bug#21422). > > So I guess we want to follow the rule here. But then - how to provide > the nice example here, without repeating the first sentence of the > generic. Any idea? Can you point me to the doc strings you are talking about, so I could see their text and the examples you'd like to keep?