From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: dieter@duenenhof-wilhelm.de (H. Dieter Wilhelm) Newsgroups: gmane.emacs.bugs Subject: bug#19129: 25.0.50; recenter-positions is missing a reference to move-to-window-line-top-bottom Date: Fri, 21 Nov 2014 00:28:42 +0100 Organization: The Church of Emacs Message-ID: <87mw7lbget.fsf@vsl28t2g.ww011> References: <87r3wxbju9.fsf@vsl28t2g.ww011> <72b27cbd-244f-467a-aba6-f4ee46519e33@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1416526229 11793 80.91.229.3 (20 Nov 2014 23:30:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 20 Nov 2014 23:30:29 +0000 (UTC) To: 19129@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 21 00:30:22 2014 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 1XrbB8-0008AD-3g for geb-bug-gnu-emacs@m.gmane.org; Fri, 21 Nov 2014 00:30:22 +0100 Original-Received: from localhost ([::1]:37778 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrbB7-0003Hy-Lc for geb-bug-gnu-emacs@m.gmane.org; Thu, 20 Nov 2014 18:30:21 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56823) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrbAy-0003Hh-OU for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 18:30:18 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XrbAq-0006BQ-Bn for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 18:30:12 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42758) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrbAq-0006Ay-9M for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 18:30:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1XrbAp-0004EK-Lr for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 18:30:03 -0500 X-Loop: help-debbugs@gnu.org In-Reply-To: <87r3wxbju9.fsf@vsl28t2g.ww011> Resent-From: dieter@duenenhof-wilhelm.de (H. Dieter Wilhelm) Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 Nov 2014 23:30:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19129 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.141652616416198 (code B ref -1); Thu, 20 Nov 2014 23:30:03 +0000 Original-Received: (at submit) by debbugs.gnu.org; 20 Nov 2014 23:29:24 +0000 Original-Received: from localhost ([127.0.0.1]:39971 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XrbAC-0004DC-4S for submit@debbugs.gnu.org; Thu, 20 Nov 2014 18:29:24 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:55032) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XrbA9-0004D3-81 for submit@debbugs.gnu.org; Thu, 20 Nov 2014 18:29:21 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XrbA2-0005pr-Et for submit@debbugs.gnu.org; Thu, 20 Nov 2014 18:29:20 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:42100) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrbA2-0005pn-Cm for submit@debbugs.gnu.org; Thu, 20 Nov 2014 18:29:14 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56737) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xrb9w-0003Al-Og for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 18:29:14 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xrb9r-0005m4-3V for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 18:29:08 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:50344) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xrb9q-0005la-So for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 18:29:03 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1Xrb9m-0007h4-D5 for bug-gnu-emacs@gnu.org; Fri, 21 Nov 2014 00:28:58 +0100 Original-Received: from p57acdb3d.dip0.t-ipconnect.de ([87.172.219.61]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 21 Nov 2014 00:28:58 +0100 Original-Received: from dieter by p57acdb3d.dip0.t-ipconnect.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 21 Nov 2014 00:28:58 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 31 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: p57acdb3d.dip0.t-ipconnect.de User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) Cancel-Lock: sha1:DHJ4NliSmjs5R14vjaTp3ytvxo0= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.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:96348 Drew Adams writes: >> in the documentation for recenter-positions was forgotten that it is >> also used in move-to-window-line-top-bottom. I added below patch as >> an illustration. > > Actually no. The doc for a function should rarely, if ever, speak > about users (callers) of that function. It should simply say what > the function does, and perhaps what it can be used for if it is > intended for users. > > But it should typically not try to list all of its callers, or even > the most important callers. > > If this is no longer just a helper for `recenter-top-bottom' > then perhaps reference to even that function can be removed > from the `recenter-positions' doc. I agree, my impulse went exactly into the opposite and wrong direction :-/ Hope you'll remove the reference from recenter-positions and please close the bug (or can I do this as well?) Thanks for your explanations Dieter -- Best wishes H. Dieter Wilhelm Darmstadt, Germany