Subject: bug#4723 closed by Juri Linkov <[email-masked]> (Re: bug#4723: 23.1; doc strings of `multi-isearch-next(-file)-buffer-from-list')

From: [email-masked] (Emacs bug Tracking System)
Date: Wed, 14 Oct 2009 22:05:12 +0000

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 <[email-masked]>.

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 <[email-masked]> by
replying to this email.

-- 
4723: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=4723
Emacs Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#4723: 23.1; doc strings of `multi-isearch-next(-file)-buffer-from-list'
From: Juri Linkov <[email-masked]>
To: Drew Adams <[email-masked]>
Cc: [email-masked]
Date: Thu, 15 Oct 2009 00:52:03 +0300

> 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/

Subject: 23.1; doc strings of `multi-isearch-next(-file)-buffer-from-list'
From: "Drew Adams" <[email-masked]>
To: <[email-masked]>
Date: Wed, 14 Oct 2009 13:19:48 -0700

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)'