GNU logs - #76199, boring messages

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
Resent-From: Daniel Mendler <mail@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 11 Feb 2025 10:27:02 +0000
Resent-Message-ID: <handler.76199.B.173926956525469 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 76199 <at> debbugs.gnu.org
From: Daniel Mendler <mail@HIDDEN>
Date: Tue, 11 Feb 2025 11:25:24 +0100
Message-ID: <87seokhj6z.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
Received-SPF: pass client-ip=2a01:4f8:c012:9177::1;
 envelope-from=mail@HIDDEN; helo=mail.qxqx.de
X-Spam_score_int: -27
X-Spam_score: -2.8
X-Spam_bar: --
X-Spam_report: (-2.8 / 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,
 RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.9 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.1 (/)

Since documentation came up in bug#76028, it seems that
`completing-read-multiple' is not documented in the Elisp
manual, in particular in doc/lispref/minibuf.texi.

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Daniel Mendler <mail@HIDDEN>
Subject: bug#76199: Acknowledgement (30.0.93; completing-read-multiple is
 not documented in the manual)
Message-ID: <handler.76199.B.173926956525469.ack <at> debbugs.gnu.org>
References: <87seokhj6z.fsf@HIDDEN>
X-Gnu-PR-Message: ack 76199
X-Gnu-PR-Package: emacs
Reply-To: 76199 <at> debbugs.gnu.org
Date: Tue, 11 Feb 2025 10:27:02 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-gnu-emacs@HIDDEN

If you wish to submit further information on this problem, please
send it to 76199 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
76199: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D76199
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
Resent-From: Eli Zaretskii <eliz@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 11 Feb 2025 13:31:02 +0000
Resent-Message-ID: <handler.76199.B76199.173928063320154 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: Daniel Mendler <mail@HIDDEN>
Cc: 76199 <at> debbugs.gnu.org
Date: Tue, 11 Feb 2025 15:30:20 +0200
Message-Id: <86tt90wqvn.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
In-Reply-To: <87seokhj6z.fsf@HIDDEN> (bug-gnu-emacs@HIDDEN)
References: <87seokhj6z.fsf@HIDDEN>
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

> Date: Tue, 11 Feb 2025 11:25:24 +0100
> From:  Daniel Mendler via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
> 
> Since documentation came up in bug#76028, it seems that
> `completing-read-multiple' is not documented in the Elisp
> manual, in particular in doc/lispref/minibuf.texi.

We don't necessarily document every function.  Is this one important
enough to be in the manual?

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
Resent-From: Daniel Mendler <mail@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 11 Feb 2025 13:39:02 +0000
Resent-Message-ID: <handler.76199.B76199.173928108821382 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: Eli Zaretskii <eliz@HIDDEN>
Cc: 76199 <at> debbugs.gnu.org
From: Daniel Mendler <mail@HIDDEN>
In-Reply-To: <86tt90wqvn.fsf@HIDDEN> (Eli Zaretskii's message of "Tue, 11 Feb
 2025 15:30:20 +0200")
References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN>
Date: Tue, 11 Feb 2025 14:37:56 +0100
Message-ID: <87pljohaa3.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

Eli Zaretskii <eliz@HIDDEN> writes:

>> Date: Tue, 11 Feb 2025 11:25:24 +0100
>> From:  Daniel Mendler via "Bug reports for GNU Emacs,
>>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
>> 
>> Since documentation came up in bug#76028, it seems that
>> `completing-read-multiple' is not documented in the Elisp
>> manual, in particular in doc/lispref/minibuf.texi.
>
> We don't necessarily document every function.  Is this one important
> enough to be in the manual?

I think so. It is not as important as `completing-read' but still useful
in scenarios where multiple strings should be read via completion. I can
send a patch for the manual if there is interest.

Daniel

Message sent to bug-gnu-emacs@HIDDEN:

X-Loop: help-debbugs@HIDDEN
Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
Resent-From: Heime <heimeborgia@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 11 Feb 2025 13:41:01 +0000
Resent-Message-ID: <handler.76199.B76199.173928123822029 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 76199
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Eli Zaretskii <eliz@HIDDEN>
Cc: Daniel Mendler <mail@HIDDEN>, 76199 <at> debbugs.gnu.org
Received: via spool by 76199-submit <at> debbugs.gnu.org id=B76199.173928123822029
          (code B ref 76199); Tue, 11 Feb 2025 13:41:01 +0000
Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 13:40:38 +0000
Received: from localhost ([127.0.0.1]:55142 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thqVB-0005jE-WC
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:40:38 -0500
Received: from mail-4325.protonmail.ch ([185.70.43.25]:46095)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <heimeborgia@HIDDEN>)
 id 1thqV8-0005is-T1
 for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:40:36 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com;
 s=protonmail3; t=1739281228; x=1739540428;
 bh=l8jCQ+0ratvI8UT8Ql6q0xQjelguD6esJKc1JJ9Yn64=;
 h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References:
 Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID:
 Message-ID:BIMI-Selector:List-Unsubscribe:List-Unsubscribe-Post;
 b=VIwi+p+moS2tGAtBwpEy7bh03xHBA1DMsSPKG7wx+1m2mF02bpY98xqkLhxSxsaQt
 LKuQsS7R8UYkXAuqb2k8aBXUhqzg7N9CJ8nM0cAjd2sW/rMPiN0cW6oR1hjUm3kX43
 qY2LjN2N/x1kEruMRMtUkY5ptX4jU/0/LFEZVdq/9qtyeEit3/xbnvI3W1WFi1Wz32
 WojB10RUk3s0+uSWAEVRoXIvKzTWuKpizsddk/udcq/Po2hAR4y+H0k7atJBbyPEs0
 m/u/FvEBPKzzugHhVmpNXRwac4pr5fFwNC5/H7stwcJM/eEH2SHUVqC6ftvQLgamj6
 kJEFiWBvKoXVA==
Date: Tue, 11 Feb 2025 13:40:23 +0000
From: Heime <heimeborgia@HIDDEN>
Message-ID: <N9vdftZ6hEcIOhWxcYgRXSDbMrG7aLlzvvsEuEYjdmE4z3V7zSawmGXBtZFa7gcmL1bN6rgvoCTCYqMm7q-0h2Oo6XHwL2M7qPwFsuA-JE0=@protonmail.com>
In-Reply-To: <86tt90wqvn.fsf@HIDDEN>
References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN>
Feedback-ID: 57735886:user:proton
X-Pm-Message-ID: 1471094b25952fb9d048c0bb8fefa3c13d84a860
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.0 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)






Sent with Proton Mail secure email.

On Wednesday, February 12th, 2025 at 1:30 AM, Eli Zaretskii <eliz@HIDDEN> =
wrote:

> > Date: Tue, 11 Feb 2025 11:25:24 +0100
> > From: Daniel Mendler via "Bug reports for GNU Emacs,
> > the Swiss army knife of text editors" bug-gnu-emacs@HIDDEN
> >=20
> > Since documentation came up in bug#76028, it seems that
> > `completing-read-multiple' is not documented in the Elisp
> > manual, in particular in doc/lispref/minibuf.texi.
>=20
>=20
> We don't necessarily document every function. Is this one important
> enough to be in the manual?


I have used it, and would like it to be in the manual.

Message sent to bug-gnu-emacs@HIDDEN:

X-Loop: help-debbugs@HIDDEN
Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
Resent-From: Eli Zaretskii <eliz@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 11 Feb 2025 13:53:02 +0000
Resent-Message-ID: <handler.76199.B76199.173928193624210 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 76199
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Daniel Mendler <mail@HIDDEN>
Cc: 76199 <at> debbugs.gnu.org
Received: via spool by 76199-submit <at> debbugs.gnu.org id=B76199.173928193624210
          (code B ref 76199); Tue, 11 Feb 2025 13:53:02 +0000
Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 13:52:16 +0000
Received: from localhost ([127.0.0.1]:55205 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thqgR-0006IQ-K6
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:52:16 -0500
Received: from eggs.gnu.org ([2001:470:142:3::10]:45624)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1thqgO-0006I0-CG
 for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:52:13 -0500
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 <eliz@HIDDEN>)
 id 1thqgH-0003Xj-Iv; Tue, 11 Feb 2025 08:52:05 -0500
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=yQ2DPH9S3HeAr94xHBTRjKKo+58ltwEzQBGFTUZvJZY=; b=Jluy7usPFc2J
 sr8UYiFIu2vAfSZ5dQZBtPwXQpcyRxANIwU7ZD7JfJp9S86Z7Efou01rl2nxBPkycQjIlpJtrPgL8
 C2k1nAOfsd/qilEy+8tKo+65O9f0tk910Lcc5hEfPzOPxJfWrhckPUAgkHitqojGJ5vt0nvP0JmrW
 l7u5kSztiv+/1tTU/RJTjvPlfdo2oCSUGlchSvLdMIiPfMaApoN/roKsLjzvbzzeyjMYNAGbukvLg
 JZybpX6uiiVbcd5FmcLRmtfCqHqMzwYJh6SLI2UqJV/wYMLBTjbBSeE6cuFG0lJEgiyNDz7sj5aG7
 BC64qJkyJd0o9rUIoe2lqw==;
Date: Tue, 11 Feb 2025 15:51:47 +0200
Message-Id: <86r044wpvw.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
In-Reply-To: <87pljohaa3.fsf@HIDDEN> (message from Daniel Mendler
 on Tue, 11 Feb 2025 14:37:56 +0100)
References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN>
 <87pljohaa3.fsf@HIDDEN>
X-Spam-Score: -2.3 (--)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Daniel Mendler <mail@HIDDEN>
> Cc: 76199 <at> debbugs.gnu.org
> Date: Tue, 11 Feb 2025 14:37:56 +0100
> 
> Eli Zaretskii <eliz@HIDDEN> writes:
> 
> >> Date: Tue, 11 Feb 2025 11:25:24 +0100
> >> From:  Daniel Mendler via "Bug reports for GNU Emacs,
> >>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
> >> 
> >> Since documentation came up in bug#76028, it seems that
> >> `completing-read-multiple' is not documented in the Elisp
> >> manual, in particular in doc/lispref/minibuf.texi.
> >
> > We don't necessarily document every function.  Is this one important
> > enough to be in the manual?
> 
> I think so.

Can you tell why?

The function is documented in its doc string, so adding it to the
manual needs a reason, like extreme popularity (doesn't seem to be the
case here), or some important aspects of its use that cannot be
easily described  in the doc string.

We could also compromise: mention the function's existence in the
manual, but leave out its description (if that will just repeat what's
in the doc string, it's just redundant).

Message sent to bug-gnu-emacs@HIDDEN:

X-Loop: help-debbugs@HIDDEN
Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
Resent-From: Eli Zaretskii <eliz@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 11 Feb 2025 13:55:02 +0000
Resent-Message-ID: <handler.76199.B76199.173928206424455 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 76199
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Heime <heimeborgia@HIDDEN>
Cc: mail@HIDDEN, 76199 <at> debbugs.gnu.org
Received: via spool by 76199-submit <at> debbugs.gnu.org id=B76199.173928206424455
          (code B ref 76199); Tue, 11 Feb 2025 13:55:02 +0000
Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 13:54:24 +0000
Received: from localhost ([127.0.0.1]:55210 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thqiV-0006MN-UO
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:54:24 -0500
Received: from eggs.gnu.org ([2001:470:142:3::10]:39134)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1thqiS-0006M4-Ra
 for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 08:54:21 -0500
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 <eliz@HIDDEN>)
 id 1thqiN-00042G-9y; Tue, 11 Feb 2025 08:54:15 -0500
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=eBcAXh7bMB5bnqMwNVG7QELk8zBpMtKjW0dFODB4PBw=; b=TtyDcpK67DHU
 ntvZAKaKBkCCQxY6NKwBvVOwNzHeN6KdQ+OndXlaTa/hH3m1n/+KZ0f/u9xrgm7vqGWbspz8v+b1X
 UcmDcJ+qzpmSap2li54F+99AzUT5wuSpEQAdlUoxOQJ+6AgWr+Kl9QxdZXoZYpJ2R4YkeJ4Yp/BDJ
 XlYolK5PMA0TLDQo+myWCZPo66bWVrecaT5nassWYhRaBA4bzusOJdPjn41U5Be4g6aWYwtprStCe
 ZeYoLdRhrXNQ0cyBPduhKpdgszrgbce1pld6HHCPrpofEtzJqqMjDV/ZhYC7WJ2xN7Xwg9sMzKj6H
 FOjbg7/FOb8m13fSp96fOA==;
Date: Tue, 11 Feb 2025 15:54:12 +0200
Message-Id: <86pljowprv.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
In-Reply-To: <N9vdftZ6hEcIOhWxcYgRXSDbMrG7aLlzvvsEuEYjdmE4z3V7zSawmGXBtZFa7gcmL1bN6rgvoCTCYqMm7q-0h2Oo6XHwL2M7qPwFsuA-JE0=@protonmail.com>
 (message from Heime on Tue, 11 Feb 2025 13:40:23 +0000)
References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN>
 <N9vdftZ6hEcIOhWxcYgRXSDbMrG7aLlzvvsEuEYjdmE4z3V7zSawmGXBtZFa7gcmL1bN6rgvoCTCYqMm7q-0h2Oo6XHwL2M7qPwFsuA-JE0=@protonmail.com>
X-Spam-Score: -2.3 (--)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> Date: Tue, 11 Feb 2025 13:40:23 +0000
> From: Heime <heimeborgia@HIDDEN>
> Cc: Daniel Mendler <mail@HIDDEN>, 76199 <at> debbugs.gnu.org
> 
> > We don't necessarily document every function. Is this one important
> > enough to be in the manual?
> 
> I have used it, and would like it to be in the manual. 

That's not a sufficient reason to add it, sorry.

You need to realize that the ELisp manual is already too large: it
prints in 2 volumes, each volume weighing in at hundreds of pages.  So
we must be judicial in our decisions to add new stuff there.

Message sent to bug-gnu-emacs@HIDDEN:

X-Loop: help-debbugs@HIDDEN
Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
Resent-From: Daniel Mendler <mail@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 11 Feb 2025 14:02:01 +0000
Resent-Message-ID: <handler.76199.B76199.173928251626107 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 76199
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Eli Zaretskii <eliz@HIDDEN>
Cc: 76199 <at> debbugs.gnu.org
Received: via spool by 76199-submit <at> debbugs.gnu.org id=B76199.173928251626107
          (code B ref 76199); Tue, 11 Feb 2025 14:02:01 +0000
Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 14:01:56 +0000
Received: from localhost ([127.0.0.1]:55227 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thqpn-0006n0-Pg
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:01:56 -0500
Received: from server.qxqx.de ([2a01:4f8:c012:9177::1]:42457 helo=mail.qxqx.de)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <mail@HIDDEN>)
 id 1thqpk-0006mh-Pz
 for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:01:53 -0500
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
 d=daniel-mendler.de; s=key; h=Content-Type:MIME-Version:Message-ID:Date:
 References:In-Reply-To:Subject:Cc:To:From:Sender:Reply-To:
 Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date:
 Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:
 List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=xjS2rBZBWvSKCOhLVvQD2pwwz5e9QQ0oVtkFpYT6iPI=; b=N0DPwqt/RziYFdqSp7Dc5WAsuC
 gcqMiqVXLFNCsLbIBvUWaC6UJWwcOZ/YiNsZPrJGxCG/ikh9AwCai+9moTzVRUmC+Tq3cllM9Ig4y
 5tuUJO1XNAZgXbC6LwuieZILXsluuzIm7DwkCVNKJok4w5Clss/Lmiro/JDB7vJFZpvw=;
From: Daniel Mendler <mail@HIDDEN>
In-Reply-To: <86r044wpvw.fsf@HIDDEN> (Eli Zaretskii's message of "Tue, 11 Feb
 2025 15:51:47 +0200")
References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN>
 <87pljohaa3.fsf@HIDDEN> <86r044wpvw.fsf@HIDDEN>
Date: Tue, 11 Feb 2025 15:01:45 +0100
Message-ID: <87lduch96e.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

Eli Zaretskii <eliz@HIDDEN> writes:

>> From: Daniel Mendler <mail@HIDDEN>
>> Cc: 76199 <at> debbugs.gnu.org
>> Date: Tue, 11 Feb 2025 14:37:56 +0100
>> 
>> Eli Zaretskii <eliz@HIDDEN> writes:
>> 
>> >> Date: Tue, 11 Feb 2025 11:25:24 +0100
>> >> From:  Daniel Mendler via "Bug reports for GNU Emacs,
>> >>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
>> >> 
>> >> Since documentation came up in bug#76028, it seems that
>> >> `completing-read-multiple' is not documented in the Elisp
>> >> manual, in particular in doc/lispref/minibuf.texi.
>> >
>> > We don't necessarily document every function.  Is this one important
>> > enough to be in the manual?
>> 
>> I think so.
>
> Can you tell why?

It is sometimes useful to complete multiple strings and
`completing-read-multiple' is a good tool to do that. So it may be
helpful to tell developers about this function. Alternatively one can
use `completing-read' in a loop, which I have also seen multiple times
in the Emacs code base or external packages.

> We could also compromise: mention the function's existence in the
> manual, but leave out its description (if that will just repeat what's
> in the doc string, it's just redundant).

This sounds like a good compromise. A short notice mentioning
`completing-read-multiple' below the documentation of `completing-read'
should suffice.

Daniel

Message sent to bug-gnu-emacs@HIDDEN:

X-Loop: help-debbugs@HIDDEN
Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
Resent-From: Christopher Dimech <dimech@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 11 Feb 2025 14:08:02 +0000
Resent-Message-ID: <handler.76199.B76199.173928283627137 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 76199
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Eli Zaretskii <eliz@HIDDEN>
Cc: Daniel Mendler <mail@HIDDEN>, 76199 <at> debbugs.gnu.org
Received: via spool by 76199-submit <at> debbugs.gnu.org id=B76199.173928283627137
          (code B ref 76199); Tue, 11 Feb 2025 14:08:02 +0000
Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 14:07:16 +0000
Received: from localhost ([127.0.0.1]:55255 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thqux-00073c-HM
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:07:15 -0500
Received: from mout.gmx.net ([212.227.15.15]:45319)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <dimech@HIDDEN>) id 1thquv-00073N-85
 for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:07:14 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.com;
 s=s31663417; t=1739282805; x=1739887605; i=dimech@HIDDEN;
 bh=8Of/xAysZC3CbPI0M4My1JGWEfkQexEAdRo/o9sniug=;
 h=X-UI-Sender-Class:MIME-Version:Message-ID:From:To:Cc:Subject:
 Content-Type:Date:In-Reply-To:References:
 Content-Transfer-Encoding:cc:content-transfer-encoding:
 content-type:date:from:message-id:mime-version:reply-to:subject:
 to;
 b=QA6uT3QPly+sdhJ5FQ6WglH8d0QtdxTIJP1+lZaAaNemFvVcxRibc1NA/VrVS/LM
 Pob36praeSdDCx7nYt4vhfiOxpKsnxO7XtR6AXJ6sDj/DjzmrtzRN7b9pvm/6+3ZX
 4MliRNKHj3M033OL0hNpsmtZK6vzE8/9gelqGCVxXSaoWVz6dZEyinSsQC2WRnkNe
 4gYbBx/ERY5NIqjm3Rmvq5RAMwQRDUsONclx73mkPB4RRCuA3baBtJWnVpZ+DmZJZ
 RqodyR7J1vcXJ/p29PdUUo2u5QLE11G9a1FYjoGgLiciEBqfLIMJgTUrLTOXLHe28
 FYm5wEMXJsHQJzix3w==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from [77.71.252.27] ([77.71.252.27]) by web-mail.gmx.net
 (3c-app-mailcom-bs11.server.lan [172.19.170.179]) (via HTTP); Tue, 11 Feb
 2025 15:06:45 +0100
MIME-Version: 1.0
Message-ID: <trinity-8754233d-a709-42fc-867f-52976a2b4347-1739282805622@3c-app-mailcom-bs11>
From: Christopher Dimech <dimech@HIDDEN>
Content-Type: text/plain; charset=UTF-8
Date: Tue, 11 Feb 2025 15:06:45 +0100
Importance: normal
Sensitivity: Normal
In-Reply-To: <86r044wpvw.fsf@HIDDEN>
References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN>
 <87pljohaa3.fsf@HIDDEN> <86r044wpvw.fsf@HIDDEN>
X-UI-Message-Type: mail
X-Priority: 3
X-Provags-ID: V03:K1:g1q5WdV9zFvU2HbwtDGV4Z8OBZOMkDFzkRIYjQ8cbiWVme+Zym/szx+q+fvcEJJui+CI9
 hdnptoC2kLgyR1yja+IFP2pxJ5+AApY0likOHwI6twPdorFsPscqTybNIRh0BCIiP+HmS79JvApY
 0DCWPbDlleG8WMDRoK6W5fwKvzXnMB+7YJcVZczDRePntjh802RMDmgjNaPEqgliYwURkhRRgXvQ
 FjFmD8lfaerFjmIBKhBuzeHIMfSMKT4miUoEbZfj0JmGq3z5Bu+ellVtlXraK/LhsJWeEB1mfxqk
 54=
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:pd7tVBbE8S8=;3vjqoijMoH7WjWfmkrB3pC8kgUT
 n5Oq3V8v0RbxqUJjNulmH5w5TDnbXawtCuJ+fsqsUgmsa2BJoBBLepzS2Bws1yn3s8MyPAgvi
 w1go6L0Ttve28W5RZFtms0JVneQ+Inj3RxbPyomeOR9RQ105F6xgwKgaHuTZuiuuE9JXV4T1z
 fTYDysWffXR+s8vXdJABxNcJsO7eY4mb4w5lyweVv3D2lDVeQyND7yJtfbASTapACrj0YCGoE
 DPVJ73gi7zYlz7qVwYuv68H8vMBQB2bmk+NH/lGl2eyqjsdR68kvlGQSnzeJqbqD+GE1pFLFq
 jh8gUvEWrtb1zPwmrtmY4I97zKRxYZPydJDDulaboSfQB5Q7ZcJJz6CHfcRbTuW7tTnrBn9Qq
 3NLBcbNzqWOcvd7YGHSIz6PoGufW/99luS7lWLoJxJBFQl1/gIYBOo2z96NoekodpK50bA+g0
 I9YG+1X1Pyd7NGngXCBDMLElEnICi/kHLZ4Go6ZXHzOOEsUWKDB49kZE65pQXvcAP98Pz3RHK
 92q5KQrja3ycuyRe+5tAwzLizsuyJx+i+vzDd/UgrA2JxkpjbaaxLZgCnfGL6uNV82ldGKOWC
 FVV1+sBvBZaX5spB0zzOSGBCu1K50Jyxo7d8ms0t7tFpe88e5ZeSWY7GWPy4Vyc9kM+J6AJ+p
 Q+Q1/PKfKFZmVA3bStp98BTi3mJfk/orO2NVJwVpbobdJfARJNMFWPk7GDy9xqNlE4UFTnnqS
 Kay4la+pybmUY8eKo8EUZ7vhRcAu5kp4kjP9E8eAzo7zd7XUJJRXp9/hnPaUnoYIF72Z0y9MB
 +J9ESbA9AEdYrBgJSSF7k+G3BPNEQBAZARDkpdAWElFjBwS4VieY/ntBRRheOnw+1t+9iZQvl
 a6gV7r+CINgZwwntPl+XohX5sHtcm4quGez2ATz7fhUNJF9/fKN6j16KpqWizll5z658tfp1w
 EH/6mxH/8Lb35QDzTILb3h+QrGnH7HEVEq3S+EsdAVQzWnbMAuNhd1FXrc5yGEZgS4G/Cx/Zx
 Grqt+i6dbyRYh2D7Fb3p3UWiV2qqIHP/lBnCcoDNVPrjVF6KBcnJXjXtQFIdZJPFV9xYtgb1W
 toi+qNXb1dcuBQQ6z8Kn7F9/U1iJpQZtiqF/0gdOr/fVYldMj7D13T9vzlkdzpWsSub8dDRXE
 JptQGPCoZHqTBt00S+77yFQey5w4Z3CDr2h19a/XbMHB+FSmtrekmje6kNetQDI4n9FeTzth9
 S3NC8uX0mmdK9q6UECSSsHoEp9IjskirxA==
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)




> Sent: Wednesday, February 12, 2025 at 1:51 AM
> From: "Eli Zaretskii" <eliz@HIDDEN>
> To: "Daniel Mendler" <mail@HIDDEN>
> Cc: 76199 <at> debbugs.gnu.org
> Subject: bug#76199: 30.0.93; completing-read-multiple is not documented =
in the manual
>
> > From: Daniel Mendler <mail@HIDDEN>
> > Cc: 76199 <at> debbugs.gnu.org
> > Date: Tue, 11 Feb 2025 14:37:56 +0100
> >
> > Eli Zaretskii <eliz@HIDDEN> writes:
> >
> > >> Date: Tue, 11 Feb 2025 11:25:24 +0100
> > >> From:  Daniel Mendler via "Bug reports for GNU Emacs,
> > >>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
> > >>
> > >> Since documentation came up in bug#76028, it seems that
> > >> `completing-read-multiple' is not documented in the Elisp
> > >> manual, in particular in doc/lispref/minibuf.texi.
> > >
> > > We don't necessarily document every function.  Is this one important
> > > enough to be in the manual?
> >
> > I think so.
>
> Can you tell why?
>
> The function is documented in its doc string, so adding it to the
> manual needs a reason, like extreme popularity (doesn't seem to be the
> case here), or some important aspects of its use that cannot be
> easily described  in the doc string.
>
> We could also compromise: mention the function's existence in the
> manual, but leave out its description (if that will just repeat what's
> in the doc string, it's just redundant).

Reference to it in the manual would assist users in discovering additional
functionality than figuring them out for themselves.

Some information is better than having nothing.  Some summary of additiona=
l
things that go beyond the realm of the manual would be of assistance to us=
ers.

What do you think about something like the Introduction to Emacs Lisp,
but that discusses things that go beyond the manual like new features,
popular ways of using things, and so on.

Message sent to bug-gnu-emacs@HIDDEN:

X-Loop: help-debbugs@HIDDEN
Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
Resent-From: Christopher Dimech <dimech@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 11 Feb 2025 14:23:02 +0000
Resent-Message-ID: <handler.76199.B76199.173928374529931 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 76199
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Eli Zaretskii <eliz@HIDDEN>
Cc: mail@HIDDEN, Heime <heimeborgia@HIDDEN>, 76199 <at> debbugs.gnu.org
Received: via spool by 76199-submit <at> debbugs.gnu.org id=B76199.173928374529931
          (code B ref 76199); Tue, 11 Feb 2025 14:23:02 +0000
Received: (at 76199) by debbugs.gnu.org; 11 Feb 2025 14:22:25 +0000
Received: from localhost ([127.0.0.1]:55283 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thr9d-0007mh-61
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:22:25 -0500
Received: from mout.gmx.net ([212.227.15.18]:43971)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <dimech@HIDDEN>) id 1thr9a-0007mQ-DH
 for 76199 <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:22:23 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.com;
 s=s31663417; t=1739283716; x=1739888516; i=dimech@HIDDEN;
 bh=UHJpxMq+MoksfJHs3RiDP7456C4pAMvUhvHBVLMMNRM=;
 h=X-UI-Sender-Class:MIME-Version:Message-ID:From:To:Cc:Subject:
 Content-Type:Date:In-Reply-To:References:
 Content-Transfer-Encoding:cc:content-transfer-encoding:
 content-type:date:from:message-id:mime-version:reply-to:subject:
 to;
 b=D/jlr5Gs3w7yrfB58bUF7NOO7Liwp3hR+UpdhATAQWktgRJn3XU20FDsltKFVGoJ
 qfKb8JasG7sv6zFgkaVcZDGICsx3JonJ1eC6vBdPAcAJAuBUU9Sb5LBwFhF9XKApA
 7E7EOUlpT6G568D9LbZw+WncAaWQ+gFQ7+vVzM+X1wYeu+X08ZFbfoY1f3UPMlzjE
 vSEcL9iRw7fVsZVC17f76qQJzH4L+oWDR5ujaxZ5ncAar50HBdQ3z2Meoaie+np6g
 /K8SmfIAwCbwKMIMUCJN0nRo1yuTj08ZjbqXgPdJI6N46eenYxPr3ANiKBw6JiLYl
 w7DazkEmTUfPtPGf+g==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from [77.71.252.27] ([77.71.252.27]) by web-mail.gmx.net
 (3c-app-mailcom-bs11.server.lan [172.19.170.179]) (via HTTP); Tue, 11 Feb
 2025 15:21:55 +0100
MIME-Version: 1.0
Message-ID: <trinity-f0052c23-5534-40fc-921d-1c9cfd6d6613-1739283715807@3c-app-mailcom-bs11>
From: Christopher Dimech <dimech@HIDDEN>
Content-Type: text/plain; charset=UTF-8
Date: Tue, 11 Feb 2025 15:21:55 +0100
Importance: normal
Sensitivity: Normal
In-Reply-To: <86pljowprv.fsf@HIDDEN>
References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN>
 <N9vdftZ6hEcIOhWxcYgRXSDbMrG7aLlzvvsEuEYjdmE4z3V7zSawmGXBtZFa7gcmL1bN6rgvoCTCYqMm7q-0h2Oo6XHwL2M7qPwFsuA-JE0=@protonmail.com>
 <86pljowprv.fsf@HIDDEN>
X-UI-Message-Type: mail
X-Priority: 3
X-Provags-ID: V03:K1:eoNgbQCBD/UMZVCc0Ddg7BAhSNiMUQkZ/f8qE8kjkigkuEn51FdbU9HzRMluRd29+QW9x
 jHn3gyqTMcCu2HXMptOJrJnf4PaOOZtdJ06ADsEZEboB0Qz3sXw/ZrMfWoTYsDD8u6Gv0zyv0eHM
 aEMAhNUv0r/K2y0zvhWnljaOBr91H12aXMOZ9WZCIveYoZx/zL53jNSyzP2V5bopfSF1p0T9xaFP
 wh5wZEr39AE8XJjcIVG80ZwWDRlAI6cYOEP6rhw05wlWDXoXHRto5r8iKJGAgz8k+Wt/VjM9gLH9
 /4=
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:5jqqCP1SFxM=;6Tix5iVUmo6bcOAFAFFw15Tk9yn
 ztEJk5dVOqoE9r3Hg6TdL168k5I6W0B2bvCyMg6FGku3Fc1a3QVMgSI1KVpRQHnPSkvBiN3dx
 qYd6rKT6sUaK+7lAOLY5JjDDx/mmdajLsUuPkMAE8rwt93cffGIeMgscPfMiDg8dF9qOOCEbu
 XZwsaulp1RqZzhLxgGrgx1fm+R3b04yl1K4IolrbTRYoxacQ9XbMLP/1nZI2uZCvCqVcum8ij
 e1fWdavlhUSTt0vB9MM4bHms7iMdd1RNfTx5wPb0PUv7Kn9zSYpYsQ23rI2COEMI5epISa57w
 Ai5Ghe6QCU7I/k3b/zGfsrZgNFYOzwS/I5pdF/PoSftu+UDNczSfS0i5oBnaY9A5yEO0B7iNb
 ZyUqTVsma4EZvLlgw7Xy/WzX6dHVCKsq6ZMfB+IFwns/6mWKhVdF9Y9HPWQqbKudM0j4WMwsc
 chxRxO8cuUeMKTwZ+1l+yuRys4tYr6BP6QRcsKR6ucql2IXKOoyR28O98YQKeZUFv2Wx+MvjT
 3y8v2BBlWCVcsv8slKGNlrbj6HtasaxnXyFd9wuGVmaopxGKGaqrQNARUtElkUQ4micbhHGY2
 TfmdxSeDrng2VA/g20L51SVeUiJSsjpJz2o7yIEoqih0HF1wF5X22Pqf3Y5jUGCz1YNH+AI6V
 N30I2ZtWOupVJ4P3jBGKSfflpliUdu+qIEmtLUDhQr+K8jFi/i+LG0bNu7WvSKRyrJygkBpX4
 nkDNAdCPao/EPPl50b4174fle1qDkM4lBG4mn4gUGZXvjm2AEa49htIyptV++IVzRbrBMmd0Z
 lv+mHpyv2hcZyYJ3KKBWfVgdaaQ6jPvoc0iRAnyd2KO7BIfkqCCL5ucacIEc2J+lmlOBU4hEc
 PBuCwBOt5rELIaqKkIuwnaRIakjSiAi6efrgfxyuV2267vdHVaaI8ZC2CzmDPfmT2iGlH9Jpg
 rwncSpH3pIX0BciqFESBkmLC91Z5B/w5AhjFyf74IogXIGbUeQtetT5qLXRg5wVx/4BLoIKe3
 Ls578CAVR3b23MzZJLdJjY3OLmBMlRQuT6NUfg4NLDaO9fULXXNBQihBKyLOXs3599kIGvtjb
 zcC1B8olUOeqsMkoLBS9gnQ86wZOwDAFz+AFKkmQGJ6IUTXYE6PQWED1NWz1U6lAFOM8hVgvA
 qcs6OpA8SOL5GXPP2WI1q3KCXGxaRkCuNu+et1H62N1BFPA+q25gGfADW3CgZSqoCakcEE+/t
 S9e71HMVI3KotXVsdUCCzX4mFLobhMA0iQ==
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)


> Sent: Wednesday, February 12, 2025 at 1:54 AM
> From: "Eli Zaretskii" <eliz@HIDDEN>
> To: "Heime" <heimeborgia@HIDDEN>
> Cc: mail@HIDDEN, 76199 <at> debbugs.gnu.org
> Subject: bug#76199: 30.0.93; completing-read-multiple is not documented =
in the manual
>
> > Date: Tue, 11 Feb 2025 13:40:23 +0000
> > From: Heime <heimeborgia@HIDDEN>
> > Cc: Daniel Mendler <mail@HIDDEN>, 76199 <at> debbugs.gnu.org
> >
> > > We don't necessarily document every function. Is this one important
> > > enough to be in the manual?
> >
> > I have used it, and would like it to be in the manual.
>
> That's not a sufficient reason to add it, sorry.
>
> You need to realize that the ELisp manual is already too large: it
> prints in 2 volumes, each volume weighing in at hundreds of pages.  So
> we must be judicial in our decisions to add new stuff there.

The manual is not being read as a book but to get information about some
specific feature that makes it easier to use than  looking at docstrings.
The trend is towards a good automatic query search.  The only thing that
should happen is for the manual to increase in volume rather than reduce.

One suggestion would be to have the manual categorised, so one does not ha=
ve
to search through its entirety to look at information on same aspect.

Message sent:

MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Eli Zaretskii <eliz@HIDDEN>
Subject: bug#76199: closed (30.0.93; completing-read-multiple is not
 documented in the manual)
CC: tracker <at> debbugs.gnu.org
Message-ID: <handler.76199.D76199.17392850892331.ackdone <at> debbugs.gnu.org>
References: <86o6z8wng9.fsf@HIDDEN> <87seokhj6z.fsf@HIDDEN>
X-Gnu-PR-Message: closed 76199
X-Gnu-PR-Package: emacs
Date: Tue, 11 Feb 2025 14:45:02 +0000
Content-Type: multipart/mixed; boundary="----------=_1739285102-2362-0"

This is a multi-part message in MIME format...

------------=_1739285102-2362-0
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain; charset=utf-8

Your message dated Tue, 11 Feb 2025 16:44:22 +0200
with message-id <86o6z8wng9.fsf@HIDDEN>
and subject line Re: bug#76199: 30.0.93; completing-read-multiple is not do=
cumented in the manual
has caused the debbugs.gnu.org bug report #76199,
regarding 30.0.93; completing-read-multiple is not documented in the manual
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs@HIDDEN)


--=20
76199: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D76199
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

------------=_1739285102-2362-0
Content-Type: message/rfc822
Content-Disposition: inline
Content-Transfer-Encoding: 7bit

Received: (at submit) by debbugs.gnu.org; 11 Feb 2025 10:26:05 +0000
Received: from localhost ([127.0.0.1]:54484 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thnSv-0006ci-3a
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 05:26:05 -0500
Received: from lists.gnu.org ([2001:470:142::17]:34988)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <mail@HIDDEN>)
 id 1thnSr-0006c6-Oq
 for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 05:26:02 -0500
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 <mail@HIDDEN>)
 id 1thnSl-0003rc-6y
 for bug-gnu-emacs@HIDDEN; Tue, 11 Feb 2025 05:25:55 -0500
Received: from server.qxqx.de ([2a01:4f8:c012:9177::1] helo=mail.qxqx.de)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <mail@HIDDEN>)
 id 1thnSh-00007T-SN
 for bug-gnu-emacs@HIDDEN; Tue, 11 Feb 2025 05:25:54 -0500
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
 d=daniel-mendler.de; s=key; h=Content-Type:MIME-Version:Message-ID:Date:
 Subject:To:From:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID:
 Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc
 :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=IP7HFaISDGWLdDCbLk7PGWZmBKZdH/2mG7SqaJuizqM=; b=oWV/AhLu1IhVLf/3Bd8ckqgoyZ
 81iwCIZKXfgT5UH0dWAfoW2aUfW+Iihd9Q+b7MCCBEirj1Os+ldvZhTTSxbO3OAwdIUP9YjAyrPYq
 YWvpvwnUCpRSHwL0fT/feQPAkz54fRNMbAtPTLsqatMiJ/7GKnnktFMSHs9Oo+kK5ty8=;
From: Daniel Mendler <mail@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Subject: 30.0.93; completing-read-multiple is not documented in the manual
X-Debbugs-Cc: 
Date: Tue, 11 Feb 2025 11:25:24 +0100
Message-ID: <87seokhj6z.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
Received-SPF: pass client-ip=2a01:4f8:c012:9177::1;
 envelope-from=mail@HIDDEN; helo=mail.qxqx.de
X-Spam_score_int: -27
X-Spam_score: -2.8
X-Spam_bar: --
X-Spam_report: (-2.8 / 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,
 RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.9 (/)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.1 (/)

Since documentation came up in bug#76028, it seems that
`completing-read-multiple' is not documented in the Elisp
manual, in particular in doc/lispref/minibuf.texi.



------------=_1739285102-2362-0
Content-Type: message/rfc822
Content-Disposition: inline
Content-Transfer-Encoding: 7bit

Received: (at 76199-done) by debbugs.gnu.org; 11 Feb 2025 14:44:49 +0000
Received: from localhost ([127.0.0.1]:55423 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thrVJ-0000bX-D8
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:44:49 -0500
Received: from eggs.gnu.org ([2001:470:142:3::10]:52530)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1thrVG-0000bE-SQ
 for 76199-done <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:44:47 -0500
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 <eliz@HIDDEN>)
 id 1thrV2-0005o4-PH; Tue, 11 Feb 2025 09:44:40 -0500
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=DWPMLcJkC+ATHDoV+y4EL1K1oQtefTJwfmzi9ycJKKo=; b=Ir3vfaIDFUN0
 UC4eq/FMLMckv4Nq9Dw0igfdUv2g6j89oeYjxEFvWNTk7gdJjP6VEQf/+khQqB4jto40dsQmfdXgj
 VkI065xN7u2+K9X0C57Zj6di8N9U9cp3AZX04r2/KE0ummEH8p5tjqj4f/hqeYy6NrfrnVCwoboGJ
 5gtUQhDe8yjYSRtG6UF8o/iLanKUFl6hfEqh1uHGM1VI9NUH/J/Ye/uZZCcQenmXp9DEs86W/We5S
 q0YuMv1yVT7DJsau2tpjDsmDy6Ww/wFG8JpQj9T/a+4F6swTWZXm4rDoEPMXY4gGjWvpXkMlLxCJX
 3TGX4To1XhzzgM/eGdKO7Q==;
Date: Tue, 11 Feb 2025 16:44:22 +0200
Message-Id: <86o6z8wng9.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Daniel Mendler <mail@HIDDEN>
In-Reply-To: <87lduch96e.fsf@HIDDEN> (message from Daniel Mendler
 on Tue, 11 Feb 2025 15:01:45 +0100)
Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented
 in the manual
References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN>
 <87pljohaa3.fsf@HIDDEN> <86r044wpvw.fsf@HIDDEN>
 <87lduch96e.fsf@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 76199-done
Cc: 76199-done <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Daniel Mendler <mail@HIDDEN>
> Cc: 76199 <at> debbugs.gnu.org
> Date: Tue, 11 Feb 2025 15:01:45 +0100
> 
> Eli Zaretskii <eliz@HIDDEN> writes:
> 
> > We could also compromise: mention the function's existence in the
> > manual, but leave out its description (if that will just repeat what's
> > in the doc string, it's just redundant).
> 
> This sounds like a good compromise. A short notice mentioning
> `completing-read-multiple' below the documentation of `completing-read'
> should suffice.

Thanks, now done on the emacs-30 branch (with the wrong bug number,
sorry), and closing the bug.


------------=_1739285102-2362-0--

Message sent:

MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Daniel Mendler <mail@HIDDEN>
Subject: bug#76199: closed (Re: bug#76199: 30.0.93; completing-read-multiple
 is not documented in the manual)
Message-ID: <handler.76199.D76199.17392850892331.notifdone <at> debbugs.gnu.org>
References: <86o6z8wng9.fsf@HIDDEN> <87seokhj6z.fsf@HIDDEN>
X-Gnu-PR-Message: they-closed 76199
X-Gnu-PR-Package: emacs
Reply-To: 76199 <at> debbugs.gnu.org
Date: Tue, 11 Feb 2025 14:45:02 +0000
Content-Type: multipart/mixed; boundary="----------=_1739285102-2362-1"

This is a multi-part message in MIME format...

------------=_1739285102-2362-1
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain; charset="utf-8"

Your bug report

#76199: 30.0.93; completing-read-multiple is not documented in the manual

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 76199 <at> debbugs.gnu.org.

--=20
76199: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D76199
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

------------=_1739285102-2362-1
Content-Type: message/rfc822
Content-Disposition: inline
Content-Transfer-Encoding: 7bit

Received: (at 76199-done) by debbugs.gnu.org; 11 Feb 2025 14:44:49 +0000
Received: from localhost ([127.0.0.1]:55423 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thrVJ-0000bX-D8
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:44:49 -0500
Received: from eggs.gnu.org ([2001:470:142:3::10]:52530)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1thrVG-0000bE-SQ
 for 76199-done <at> debbugs.gnu.org; Tue, 11 Feb 2025 09:44:47 -0500
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 <eliz@HIDDEN>)
 id 1thrV2-0005o4-PH; Tue, 11 Feb 2025 09:44:40 -0500
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=DWPMLcJkC+ATHDoV+y4EL1K1oQtefTJwfmzi9ycJKKo=; b=Ir3vfaIDFUN0
 UC4eq/FMLMckv4Nq9Dw0igfdUv2g6j89oeYjxEFvWNTk7gdJjP6VEQf/+khQqB4jto40dsQmfdXgj
 VkI065xN7u2+K9X0C57Zj6di8N9U9cp3AZX04r2/KE0ummEH8p5tjqj4f/hqeYy6NrfrnVCwoboGJ
 5gtUQhDe8yjYSRtG6UF8o/iLanKUFl6hfEqh1uHGM1VI9NUH/J/Ye/uZZCcQenmXp9DEs86W/We5S
 q0YuMv1yVT7DJsau2tpjDsmDy6Ww/wFG8JpQj9T/a+4F6swTWZXm4rDoEPMXY4gGjWvpXkMlLxCJX
 3TGX4To1XhzzgM/eGdKO7Q==;
Date: Tue, 11 Feb 2025 16:44:22 +0200
Message-Id: <86o6z8wng9.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Daniel Mendler <mail@HIDDEN>
In-Reply-To: <87lduch96e.fsf@HIDDEN> (message from Daniel Mendler
 on Tue, 11 Feb 2025 15:01:45 +0100)
Subject: Re: bug#76199: 30.0.93; completing-read-multiple is not documented
 in the manual
References: <87seokhj6z.fsf@HIDDEN> <86tt90wqvn.fsf@HIDDEN>
 <87pljohaa3.fsf@HIDDEN> <86r044wpvw.fsf@HIDDEN>
 <87lduch96e.fsf@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 76199-done
Cc: 76199-done <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Daniel Mendler <mail@HIDDEN>
> Cc: 76199 <at> debbugs.gnu.org
> Date: Tue, 11 Feb 2025 15:01:45 +0100
> 
> Eli Zaretskii <eliz@HIDDEN> writes:
> 
> > We could also compromise: mention the function's existence in the
> > manual, but leave out its description (if that will just repeat what's
> > in the doc string, it's just redundant).
> 
> This sounds like a good compromise. A short notice mentioning
> `completing-read-multiple' below the documentation of `completing-read'
> should suffice.

Thanks, now done on the emacs-30 branch (with the wrong bug number,
sorry), and closing the bug.


------------=_1739285102-2362-1
Content-Type: message/rfc822
Content-Disposition: inline
Content-Transfer-Encoding: 7bit

Received: (at submit) by debbugs.gnu.org; 11 Feb 2025 10:26:05 +0000
Received: from localhost ([127.0.0.1]:54484 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1thnSv-0006ci-3a
	for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 05:26:05 -0500
Received: from lists.gnu.org ([2001:470:142::17]:34988)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <mail@HIDDEN>)
 id 1thnSr-0006c6-Oq
 for submit <at> debbugs.gnu.org; Tue, 11 Feb 2025 05:26:02 -0500
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 <mail@HIDDEN>)
 id 1thnSl-0003rc-6y
 for bug-gnu-emacs@HIDDEN; Tue, 11 Feb 2025 05:25:55 -0500
Received: from server.qxqx.de ([2a01:4f8:c012:9177::1] helo=mail.qxqx.de)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <mail@HIDDEN>)
 id 1thnSh-00007T-SN
 for bug-gnu-emacs@HIDDEN; Tue, 11 Feb 2025 05:25:54 -0500
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
 d=daniel-mendler.de; s=key; h=Content-Type:MIME-Version:Message-ID:Date:
 Subject:To:From:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID:
 Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc
 :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=IP7HFaISDGWLdDCbLk7PGWZmBKZdH/2mG7SqaJuizqM=; b=oWV/AhLu1IhVLf/3Bd8ckqgoyZ
 81iwCIZKXfgT5UH0dWAfoW2aUfW+Iihd9Q+b7MCCBEirj1Os+ldvZhTTSxbO3OAwdIUP9YjAyrPYq
 YWvpvwnUCpRSHwL0fT/feQPAkz54fRNMbAtPTLsqatMiJ/7GKnnktFMSHs9Oo+kK5ty8=;
From: Daniel Mendler <mail@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Subject: 30.0.93; completing-read-multiple is not documented in the manual
X-Debbugs-Cc: 
Date: Tue, 11 Feb 2025 11:25:24 +0100
Message-ID: <87seokhj6z.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
Received-SPF: pass client-ip=2a01:4f8:c012:9177::1;
 envelope-from=mail@HIDDEN; helo=mail.qxqx.de
X-Spam_score_int: -27
X-Spam_score: -2.8
X-Spam_bar: --
X-Spam_report: (-2.8 / 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,
 RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.9 (/)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.1 (/)

Since documentation came up in bug#76028, it seems that
`completing-read-multiple' is not documented in the Elisp
manual, in particular in doc/lispref/minibuf.texi.



------------=_1739285102-2362-1--

Last modified: Tue, 11 Feb 2025 14:45:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.