From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#4723: 23.1; doc strings of `multi-isearch-next(-file)-buffer-from-list' Date: Wed, 14 Oct 2009 13:19:48 -0700 Message-ID: Reply-To: Drew Adams , 4723@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1255552056 15891 80.91.229.12 (14 Oct 2009 20:27:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 14 Oct 2009 20:27:36 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Oct 14 22:27:26 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MyARR-0004U4-55 for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Oct 2009 22:27:25 +0200 Original-Received: from localhost ([127.0.0.1]:46002 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyARQ-00050T-HD for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Oct 2009 16:27:24 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MyARL-0004zA-Lf for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:27:19 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MyARH-0004vZ-JG for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:27:19 -0400 Original-Received: from [199.232.76.173] (port=35012 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MyARH-0004vQ-Fv for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:27:15 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:60166) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MyARG-0004Ca-Sc for bug-gnu-emacs@gnu.org; Wed, 14 Oct 2009 16:27:15 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9EKRAbw029659; Wed, 14 Oct 2009 13:27:11 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n9EKP6Za029207; Wed, 14 Oct 2009 13:25:06 -0700 Resent-Date: Wed, 14 Oct 2009 13:25:06 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Wed, 14 Oct 2009 20:25:06 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 4723 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.125555160328421 (code B ref -1); Wed, 14 Oct 2009 20:25:06 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 14 Oct 2009 20:20:03 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-Received: from abhmt004.oracle.com by acsmt354.oracle.com with ESMTP id 20407795401255551583; Wed, 14 Oct 2009 13:19:43 -0700 Original-Received: from dradamslap1 (/141.144.160.48) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 14 Oct 2009 13:19:42 -0700 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) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Wed, 14 Oct 2009 16:27:19 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:31934 Archived-At: 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)'