From unknown Sat Aug 16 18:42:15 2025 X-Loop: owner@emacsbugs.donarmstrong.com Subject: bug#4723: 23.1; doc strings of `multi-isearch-next(-file)-buffer-from-list' Reply-To: "Drew Adams" , 4723@debbugs.gnu.org Resent-From: "Drew Adams" Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Wed, 14 Oct 2009 20:25:06 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-Emacs-PR-Message: report 4723 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.125555160328421 (code B ref -1); Wed, 14 Oct 2009 20:25:06 +0000 Received: (at submit) by emacsbugs.donarmstrong.com; 14 Oct 2009 20:20:03 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.3 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9EKK1oX028378 for ; Wed, 14 Oct 2009 13:20:02 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MyAKG-0002Lu-CY for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:20:00 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MyAKA-0002Kz-At for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:19:58 -0400 Received: from [199.232.76.173] (port=41230 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyAKA-0002Kw-4F for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:19:54 -0400 Received: from acsinet11.oracle.com ([141.146.126.233]:43830) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MyAK9-0003Eo-Lo for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:19:53 -0400 Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9EKK9P9004632 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 14 Oct 2009 20:20:10 GMT Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9EDGi33017190 for ; Wed, 14 Oct 2009 20:19:49 GMT Received: from abhmt004.oracle.com by acsmt354.oracle.com with ESMTP id 20407795401255551583; Wed, 14 Oct 2009 13:19:43 -0700 Received: from dradamslap1 (/141.144.160.48) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 14 Oct 2009 13:19:42 -0700 From: "Drew Adams" To: Date: Wed, 14 Oct 2009 13:19:48 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcpNC62UhMFk6vj/SpWwOfHqppZ4iA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: acsmt353.oracle.com [141.146.40.153] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090204.4AD63264.00E6:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) The doc strings of these two functions speak a lot about ChangeLog buffers. However, there is absolutely nothing in the definitions of these functions that is particular to ChangeLog buffers. The doc strings should describe these functions (only). Please move the ChangeLog-relevant info to the appropriate functions that involve change logs. Presumably, they are consumers of these two functions, and _for those consumers_, what is said now in these doc strings is relevant. (It is not relevant to these functions themselves.) Secondly, these two doc strings are currently identical. At least one of them is therefore not as good as it could be. ;-) In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)' From unknown Sat Aug 16 18:42:15 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.427 (Entity 5.427) X-Loop: owner@emacsbugs.donarmstrong.com From: help-debbugs@gnu.org (Emacs bug Tracking System) To: "Drew Adams" Subject: bug#4723 closed by Juri Linkov (Re: bug#4723: 23.1; doc strings of `multi-isearch-next(-file)-buffer-from-list') Message-ID: References: <87bpk9ve2k.fsf@mail.jurta.org> X-Emacs-PR-Message: they-closed 4723 X-Emacs-PR-Package: emacs Reply-To: 4723@debbugs.gnu.org Date: Wed, 14 Oct 2009 22:05:12 +0000 Content-Type: multipart/mixed; boundary="----------=_1255557912-12179-1" This is a multi-part message in MIME format... ------------=_1255557912-12179-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This is an automatic notification regarding your bug report which was filed against the emacs package: #4723: 23.1; doc strings of `multi-isearch-next(-file)-buffer-from-list' It has been closed by Juri Linkov . Their explanation is attached below along with your original report. If this explanation is unsatisfactory and you have not received a better one in a separate message then please contact Juri Linkov by replying to this email. --=20 4723: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D4723 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1255557912-12179-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 4723-done) by emacsbugs.donarmstrong.com; 14 Oct 2009 21:58:47 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.6 required=4.0 tests=AWL,HAS_BUG_NUMBER autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from mx1.starman.ee (smtp-out1.starman.ee [85.253.0.3]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9ELwjIi010933 for <4723-done@emacsbugs.donarmstrong.com>; Wed, 14 Oct 2009 14:58:46 -0700 X-Virus-Scanned: by Amavisd-New at mx1.starman.ee Received: from mail.starman.ee (82.131.99.144.cable.starman.ee [82.131.99.144]) by mx1.starman.ee (Postfix) with ESMTP id 035023F41AD; Thu, 15 Oct 2009 00:58:38 +0300 (EEST) From: Juri Linkov To: Drew Adams Cc: 4723-done@debbugs.gnu.org Subject: Re: bug#4723: 23.1; doc strings of `multi-isearch-next(-file)-buffer-from-list' Organization: JURTA References: Date: Thu, 15 Oct 2009 00:52:03 +0300 In-Reply-To: (Drew Adams's message of "Wed, 14 Oct 2009 13:19:48 -0700") Message-ID: <87bpk9ve2k.fsf@mail.jurta.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii > The doc strings of these two functions speak a lot about ChangeLog > buffers. However, there is absolutely nothing in the definitions of > these functions that is particular to ChangeLog buffers. > > The doc strings should describe these functions (only). Please move > the ChangeLog-relevant info to the appropriate functions that involve > change logs. Presumably, they are consumers of these two functions, > and _for those consumers_, what is said now in these doc strings is > relevant. (It is not relevant to these functions themselves.) > > Secondly, these two doc strings are currently identical. At least one > of them is therefore not as good as it could be. ;-) Thanks. This was a copy&paste error. Fixed. -- Juri Linkov http://www.jurta.org/emacs/ ------------=_1255557912-12179-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 14 Oct 2009 20:20:03 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.3 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9EKK1oX028378 for ; Wed, 14 Oct 2009 13:20:02 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MyAKG-0002Lu-CY for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:20:00 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MyAKA-0002Kz-At for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:19:58 -0400 Received: from [199.232.76.173] (port=41230 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyAKA-0002Kw-4F for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:19:54 -0400 Received: from acsinet11.oracle.com ([141.146.126.233]:43830) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MyAK9-0003Eo-Lo for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:19:53 -0400 Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9EKK9P9004632 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 14 Oct 2009 20:20:10 GMT Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9EDGi33017190 for ; Wed, 14 Oct 2009 20:19:49 GMT Received: from abhmt004.oracle.com by acsmt354.oracle.com with ESMTP id 20407795401255551583; Wed, 14 Oct 2009 13:19:43 -0700 Received: from dradamslap1 (/141.144.160.48) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 14 Oct 2009 13:19:42 -0700 From: "Drew Adams" To: Subject: 23.1; doc strings of `multi-isearch-next(-file)-buffer-from-list' Date: Wed, 14 Oct 2009 13:19:48 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcpNC62UhMFk6vj/SpWwOfHqppZ4iA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: acsmt353.oracle.com [141.146.40.153] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090204.4AD63264.00E6:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) The doc strings of these two functions speak a lot about ChangeLog buffers. However, there is absolutely nothing in the definitions of these functions that is particular to ChangeLog buffers. The doc strings should describe these functions (only). Please move the ChangeLog-relevant info to the appropriate functions that involve change logs. Presumably, they are consumers of these two functions, and _for those consumers_, what is said now in these doc strings is relevant. (It is not relevant to these functions themselves.) Secondly, these two doc strings are currently identical. At least one of them is therefore not as good as it could be. ;-) In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)' ------------=_1255557912-12179-1--