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#19129: 25.0.50; recenter-positions is missing a reference to move-to-window-line-top-bottom Date: Thu, 20 Nov 2014 14:42:49 -0800 (PST) Message-ID: <72b27cbd-244f-467a-aba6-f4ee46519e33@default> References: <87r3wxbju9.fsf@vsl28t2g.ww011> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1416523412 1254 80.91.229.3 (20 Nov 2014 22:43:32 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 20 Nov 2014 22:43:32 +0000 (UTC) To: dieter@duenenhof-wilhelm.de, 19129@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Nov 20 23:43:24 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 1XraRg-00073V-Jm for geb-bug-gnu-emacs@m.gmane.org; Thu, 20 Nov 2014 23:43:24 +0100 Original-Received: from localhost ([::1]:37636 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XraRf-00039Z-U7 for geb-bug-gnu-emacs@m.gmane.org; Thu, 20 Nov 2014 17:43:23 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48722) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XraRU-00036c-71 for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 17:43:20 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XraRL-00074x-0E for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 17:43:12 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42729) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XraRK-00074n-Tk for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 17:43:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1XraRK-00035s-18 for bug-gnu-emacs@gnu.org; Thu, 20 Nov 2014 17:43:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 Nov 2014 22:43:01 +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: Original-Received: via spool by 19129-submit@debbugs.gnu.org id=B19129.141652337711881 (code B ref 19129); Thu, 20 Nov 2014 22:43:01 +0000 Original-Received: (at 19129) by debbugs.gnu.org; 20 Nov 2014 22:42:57 +0000 Original-Received: from localhost ([127.0.0.1]:39942 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XraRE-00035Z-Gh for submit@debbugs.gnu.org; Thu, 20 Nov 2014 17:42:56 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:32924) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XraRB-00035N-H6 for 19129@debbugs.gnu.org; Thu, 20 Nov 2014 17:42:54 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id sAKMgqnu017126 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 20 Nov 2014 22:42:52 GMT Original-Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id sAKMgpPJ016897 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 20 Nov 2014 22:42:51 GMT Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by userz7022.oracle.com (8.14.5+Sun/8.14.4) with ESMTP id sAKMgoqS011088; Thu, 20 Nov 2014 22:42:50 GMT In-Reply-To: <87r3wxbju9.fsf@vsl28t2g.ww011> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] X-Source-IP: acsinet21.oracle.com [141.146.126.237] 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:96343 > 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.