From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#23067: 25.0.92; A detail in the doc of query-replace Date: Fri, 25 Mar 2016 17:23:59 +0300 Message-ID: <837fgq1vr4.fsf@gnu.org> References: <<87oaa9vrdz.fsf@web.de>> <<83k2kq27j0.fsf@gnu.org>> <42d06a78-824b-4661-aa84-845def8ca855@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1458916236 2185 80.91.229.3 (25 Mar 2016 14:30:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 25 Mar 2016 14:30:36 +0000 (UTC) Cc: michael_heerdegen@web.de, 23067@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Mar 25 15:30:24 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ajSfo-0003dR-Cs for geb-bug-gnu-emacs@m.gmane.org; Fri, 25 Mar 2016 15:25:12 +0100 Original-Received: from localhost ([::1]:56478 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ajSfm-0002xP-T7 for geb-bug-gnu-emacs@m.gmane.org; Fri, 25 Mar 2016 10:25:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47010) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ajSfi-0002w8-DM for bug-gnu-emacs@gnu.org; Fri, 25 Mar 2016 10:25:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ajSfe-0002tf-DH for bug-gnu-emacs@gnu.org; Fri, 25 Mar 2016 10:25:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:40839) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ajSfe-0002ta-Ac for bug-gnu-emacs@gnu.org; Fri, 25 Mar 2016 10:25:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ajSfe-0005Ko-4C for bug-gnu-emacs@gnu.org; Fri, 25 Mar 2016 10:25:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 25 Mar 2016 14:25:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 23067 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 23067-submit@debbugs.gnu.org id=B23067.145891586520456 (code B ref 23067); Fri, 25 Mar 2016 14:25:02 +0000 Original-Received: (at 23067) by debbugs.gnu.org; 25 Mar 2016 14:24:25 +0000 Original-Received: from localhost ([127.0.0.1]:37966 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ajSf3-0005Js-IA for submit@debbugs.gnu.org; Fri, 25 Mar 2016 10:24:25 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:55934) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ajSf1-0005Jf-SI for 23067@debbugs.gnu.org; Fri, 25 Mar 2016 10:24:24 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ajSes-0002p3-Sg for 23067@debbugs.gnu.org; Fri, 25 Mar 2016 10:24:18 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:57138) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ajSes-0002oz-P4; Fri, 25 Mar 2016 10:24:14 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4877 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1ajSer-0008L0-Sc; Fri, 25 Mar 2016 10:24:14 -0400 In-reply-to: <42d06a78-824b-4661-aa84-845def8ca855@default> (message from Drew Adams on Fri, 25 Mar 2016 07:13:48 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:115480 Archived-At: > Date: Fri, 25 Mar 2016 07:13:48 -0700 (PDT) > From: Drew Adams > Cc: 23067-done@debbugs.gnu.org > > > However, I must say that it makes very little sense to me to make such > > corrections only in a couple of functions, when we have gobs of them > > with the same problem in the doc strings, so much so that I wonder > > whether "end of buffer" isn't already a widely accepted synonym of > > "end of the buffer's accessible portion", and we shouldn't bother, > > certainly not with fixing that one function at a time. I won't be > > surprised if the same issue has crept in the manuals as well. > > > > Please, let's not start another prolonged dispute that leads nowhere. > > Instead, if someone really thinks this stuff should be spelled out in > > documentation, that someone is kindly requested to submit a patch that > > fixes _all_ of the instances where we don't say that explicitly. TIA. > > There's another way to look at this that occurs to me. It is also > perhaps not without some ambiguity, but it might nevertheless help. > > "End of buffer" can be regarded as `point-max'. What do you mean "can be"? I was saying that it already is regarded as such. > This is what we say in the doc string of the predicate (`eobp') that > determines (tests for) end-of-buffer-ness: > > Return t if point is at the end of the buffer. > ^^^^^^^^^^^^^^^^^^^^^ > If the buffer is narrowed, this means the end of the narrowed part. > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Are you saying we should change all the similar doc strings to say the same? If so, how is this different from what I said above, about the need to change all of them?