From unknown Tue Aug 19 05:10:10 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#53720 <53720@debbugs.gnu.org> To: bug#53720 <53720@debbugs.gnu.org> Subject: Status: Documentation for emacs-version Reply-To: bug#53720 <53720@debbugs.gnu.org> Date: Tue, 19 Aug 2025 12:10:10 +0000 retitle 53720 Documentation for emacs-version reassign 53720 emacs submitter 53720 goncholden severity 53720 wishlist thanks From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 02 07:18:49 2022 Received: (at submit) by debbugs.gnu.org; 2 Feb 2022 12:18:50 +0000 Received: from localhost ([127.0.0.1]:51737 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nFEb2-0003v6-Nv for submit@debbugs.gnu.org; Wed, 02 Feb 2022 07:18:49 -0500 Received: from lists.gnu.org ([209.51.188.17]:48366) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nFCUX-0008M3-4O for submit@debbugs.gnu.org; Wed, 02 Feb 2022 05:04:00 -0500 Received: from eggs.gnu.org ([209.51.188.92]:44146) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nFCUW-0003mL-Ue for bug-gnu-emacs@gnu.org; Wed, 02 Feb 2022 05:03:56 -0500 Received: from mail-40130.protonmail.ch ([185.70.40.130]:39654) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nFCUS-0008G4-95 for bug-gnu-emacs@gnu.org; Wed, 02 Feb 2022 05:03:56 -0500 Date: Wed, 02 Feb 2022 10:03:29 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail2; t=1643796211; bh=tnri5uie2eJoNEpa9/XnkPzprU6CzzED48W6gzyBsKM=; h=Date:To:From:Reply-To:Subject:Message-ID:From:To:Cc; b=m4xauhMo9fOcPv2qybZC6zuyaXgUr2YbrJO8h5EBKaqQBMUhhv5SPV0LBHKWbalta dPKm40TfcLv0f/q1pkQREMuGBgvZvRahHq8PalHLk4JMJ5E0GngMESPDPED4lZcMEB MLXVM6uNPkOi4PC2StyljwCfvs+ecOTtket1qCfNefWlKC8JQ90hOD6NCnVpDbfUem 80Adi4+jJd3S5Sk3tTQHN+dTAi4wJJQNeNl6k3U+re0Z1dl+zKOdDheHP579cKy4PC EdYN+arYwGfoT498rsHFPDjjT8AQwpHiSO6G1/dec1UJqhr4asI0vEASgkHB6XSNfu g89R8ryI7v/WA== To: Drew Adams , "bug-gnu-emacs@gnu.org" From: goncholden Subject: Documentation for emacs-version Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-1.2 required=10.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, T_SCC_BODY_TEXT_LINE shortcircuit=no autolearn=disabled version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on mailout.protonmail.ch Received-SPF: pass client-ip=185.70.40.130; envelope-from=goncholden@protonmail.com; helo=mail-40130.protonmail.ch 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.2 (/) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Wed, 02 Feb 2022 07:18:47 -0500 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: goncholden Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) =E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90 Original Me= ssage =E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90 On Tuesday, February 1st, 2022 at 5:49 PM, Drew Adams wrote: > I am looking up documentation for emacs-version. But cannot understand th= e > > meaning of > > If optional argument HERE is non-nil, insert string at point. > > Doc: > > (emacs-version &optional HERE) > > Probably introduced at or before Emacs version 19.20. > > Return string describing the version of Emacs that is running. > > If optional argument HERE is non-nil, insert string at point. This is the doc string for Emacs 27.2 (the latest release): Return string describing the version of Emacs that is running. If optional argument HERE is non-nil, insert string at point. Don=E2=80=99t use this function in programs to choose actions according to the system configuration; look at =E2=80=98system-configuration=E2=80= =99 instead. But it's still a poor doc string. It should, first of all, describe the interactive use. It should say: With a prefix argument, insert string at point. ^^^^^^^^^^^^^^^^^^^^^^ Only after that interactive description should it give the Emacs-Lisp description of argument HERE: When called from Lisp, optional argument HERE corresponds to the prefix argument. Consider filing a (doc) bug report for this: `M-x report-emacs-bug'. From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 02 12:41:54 2022 Received: (at 53720-done) by debbugs.gnu.org; 2 Feb 2022 17:41:54 +0000 Received: from localhost ([127.0.0.1]:53377 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nFJdh-0003OJ-Rn for submit@debbugs.gnu.org; Wed, 02 Feb 2022 12:41:54 -0500 Received: from eggs.gnu.org ([209.51.188.92]:50532) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nFJdc-0003O0-DV for 53720-done@debbugs.gnu.org; Wed, 02 Feb 2022 12:41:52 -0500 Received: from [2001:470:142:3::e] (port=40066 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nFJdT-0001et-J6; Wed, 02 Feb 2022 12:41:41 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=3OS8/vXYHZECKlmajzLZ1Wr1k3U/kn4QlpWpBOAZYds=; b=Vdg9rM/V1qyrXsVje8VU d3KtI8uaonwzI3UCdPyALhuIqslrUW16lJYr4jJvCbSbAbJZ3OhLdv2tcj1Xv6GBtpHCaLD6m4qmW LGQ+Rn93e6n6rO2j2Q5sjckdfgc9DN042JNgHftl6jP55Di7dUmJv222v5OGYKKV4jk6t5aBL793O iDpBmmfVyop2oRy53+19ESnSBoYm+55kcFAKjxC9j9pfDiMiLnTE2s0yUiCMER4QcoSSG3My46vWi s4P5JlggckzCv08SbVVG2qzxymKaFDILBTPBEG2ql+M661sQib95i66vw1vjKNDPj16aL4iULJODq ljnOLG7WVsXmTA==; Received: from [87.69.77.57] (port=2746 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nFJby-0007e7-Ah; Wed, 02 Feb 2022 12:41:16 -0500 Date: Wed, 02 Feb 2022 19:40:08 +0200 Message-Id: <83v8xx5frb.fsf@gnu.org> From: Eli Zaretskii To: goncholden In-Reply-To: (bug-gnu-emacs@gnu.org) Subject: Re: bug#53720: Documentation for emacs-version References: MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: 2.0 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: > Date: Wed, 02 Feb 2022 10:03:29 +0000 > From: goncholden via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > > (emacs-version &optional HERE) > > Prob [...] Content analysis details: (2.0 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_HELO_PASS SPF: HELO matches SPF record -0.0 SPF_PASS SPF: sender matches SPF record 2.0 PDS_TONAME_EQ_TOLOCAL_HDRS_LCASE To: name matches everything in local email - LCASE headers -0.0 T_SCC_BODY_TEXT_LINE No description available. X-Debbugs-Envelope-To: 53720-done Cc: 53720-done@debbugs.gnu.org, drew.adams@oracle.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.3 (-) > Date: Wed, 02 Feb 2022 10:03:29 +0000 > From: goncholden via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > > (emacs-version &optional HERE) > > Probably introduced at or before Emacs version 19.20. > > Return string describing the version of Emacs that is running. > > If optional argument HERE is non-nil, insert string at point. > > This is the doc string for Emacs 27.2 (the latest release): > > Return string describing the version of Emacs that is running. > If optional argument HERE is non-nil, insert string at point. > Don’t use this function in programs to choose actions according > to the system configuration; look at ‘system-configuration’ instead. > But it's still a poor doc string. It should, first > of all, describe the interactive use. It should say: > With a prefix argument, insert string at point. > ^^^^^^^^^^^^^^^^^^^^^^ > Only after that interactive description should it > give the Emacs-Lisp description of argument HERE: > When called from Lisp, optional argument HERE > corresponds to the prefix argument. > Consider filing a (doc) bug report for this: > `M-x report-emacs-bug'. Thanks, I fixed the wording of the doc string. From unknown Tue Aug 19 05:10:10 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 03 Mar 2022 12:24:06 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator