From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Arash Esbati Newsgroups: gmane.emacs.devel Subject: Re: Doc of deprecated INITIAL-INPUT arg of completing-read Date: Wed, 29 Jun 2022 11:15:42 +0200 Message-ID: <86czeresox.fsf_-_@gnu.org> References: <87v8smt9lp.fsf@web.de> <87mtdw4v6h.fsf@web.de> 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="8521"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 Cc: emacs-devel@gnu.org To: Michael Heerdegen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Jun 29 11:33:25 2022 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 1o6U4a-00021k-SY for ged-emacs-devel@m.gmane-mx.org; Wed, 29 Jun 2022 11:33:25 +0200 Original-Received: from localhost ([::1]:58122 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o6U4Z-0005DX-F2 for ged-emacs-devel@m.gmane-mx.org; Wed, 29 Jun 2022 05:33:23 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:36734) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o6Tnn-0002EV-F3 for emacs-devel@gnu.org; Wed, 29 Jun 2022 05:16:03 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:53328) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o6Tnn-0005Ef-64; Wed, 29 Jun 2022 05:16:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:In-Reply-To:Date:References:Subject:To: From; bh=u1Gdt5Ka2pnaDXAQCqXiqqb1cz4HQHAH/s0h0uHZY3Q=; b=NyiDzc9BXx/toG+I9h+r bW/tYkgHzkdllGcrZ6SQph1lGyqfmqFJfK7okeWGhn9qNFgvOISZoXevlMJ5xwqqhFbvPnp4/g0Fs 6tesiTWcRXQt2OJY+/nGgknwQEmsqZ2OV7QiOgjP20F+cJUNGhmMVR8arbvAzVu0iJCPduesf4FqO WO2gB3MfLh0T+pzjAIQaGrYKkxGfqx1YWiBS5STdxY6Y1xeGYIZ625X0ByL3IoJMOtaFZwYtYvJny um2TGFHbS3htI/GZK4/db3vDjMDa5rHUaIZJ/PbJkqQyjvMEm+h6zO3NvRZWpeKCEuAyiOustMLLY vSLKFRICiPSzlQ==; Original-Received: from p4fe3ee56.dip0.t-ipconnect.de ([79.227.238.86]:51839 helo=MUTANT) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o6Tnm-0006XX-R3; Wed, 29 Jun 2022 05:16:02 -0400 In-Reply-To: <87mtdw4v6h.fsf@web.de> (Michael Heerdegen's message of "Tue, 28 Jun 2022 18:19:50 +0200") 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" Xref: news.gmane.io gmane.emacs.devel:291709 Archived-At: Michael Heerdegen writes: > Mostly agreed. But as I said, I only intend to describe the current > coding recommendations better, and these don't regard INITIAL-INPUT and > DEF as equivalent alternatives. > > As a compromise, here is a reworded version: Thanks for working on this. In order to make this change complete, I think there are other areas to be touched/considered as well: =E2=80=A2 docstrings of `read-string' and `read-from-minibuffer' =E2=80=A2 Emacs Lisp reference the text/descriptions in @node Text from Minibuffer @section Reading Text Strings with the Minibuffer @node Initial Input @section Initial Input @node Minibuffer Completion @subsection Completion and the Minibuffer > For wishes, discussions and feature requests maybe use another > (sub-)thread or bug report. I think it is best to file a bug report with a complete change suggestion, get it approved by the maintainer team and then turn the page. Are you willing to take this? Best, Arash