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#20419: 25.0.50; doc string of `recenter-last-op` Date: Sat, 25 Apr 2015 07:29:20 -0700 (PDT) Message-ID: <162fcb99-b1ac-4afa-8c95-e8d171f07153@default> References: <<3c528679-060f-45ce-994c-fdbaada6de9d@default>> <<83tww4y81l.fsf@gnu.org>> 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 1429972232 24340 80.91.229.3 (25 Apr 2015 14:30:32 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 25 Apr 2015 14:30:32 +0000 (UTC) Cc: 20419@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 25 16:30:17 2015 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 1Ym15z-0003NQ-Bo for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Apr 2015 16:30:15 +0200 Original-Received: from localhost ([::1]:48517 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ym15y-0003WG-MQ for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Apr 2015 10:30:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53590) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ym15u-0003Vu-KV for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2015 10:30:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ym15r-0007Ut-Cy for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2015 10:30:10 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:50109) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ym15r-0007UL-Ak for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2015 10:30:07 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Ym15p-0002tt-G5 for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2015 10:30:05 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 Apr 2015 14:30:05 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20419 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 20419-submit@debbugs.gnu.org id=B20419.142997217011083 (code B ref 20419); Sat, 25 Apr 2015 14:30:05 +0000 Original-Received: (at 20419) by debbugs.gnu.org; 25 Apr 2015 14:29:30 +0000 Original-Received: from localhost ([127.0.0.1]:39885 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ym15F-0002sh-QF for submit@debbugs.gnu.org; Sat, 25 Apr 2015 10:29:30 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:40554) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ym15D-0002sT-3H for 20419@debbugs.gnu.org; Sat, 25 Apr 2015 10:29:27 -0400 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t3PETKYW018197 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 25 Apr 2015 14:29:21 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t3PETKL4008929 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 25 Apr 2015 14:29:20 GMT Original-Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t3PETJ36015049; Sat, 25 Apr 2015 14:29:19 GMT In-Reply-To: <<83tww4y81l.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] 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:102021 Archived-At: > > The doc string says that these are the possible values: > > "`top', `middle', `bottom', integer or float numbers." > > It should also mention `nil', say what `nil' means, and > > perhaps even say that `nil' is the default value. >=20 > How do you see that nil has any meaning whatsoever? `nil' means that the next `recenter-top-bottom' starts with the first element of `recenter-positions'. It has the effect (meaning) that, as the two comments in that replace.el code take the trouble to say, it "resets recenter cycling order to initial position". With that info added to the doc string, those comments can be removed, and Lisp users will understand immediately that they can do the same thing: bind it to nil to get that effect.