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#20419: 25.0.50; doc string of `recenter-last-op` Date: Sat, 25 Apr 2015 17:55:27 +0300 Message-ID: <83iockxnog.fsf@gnu.org> References: <162fcb99-b1ac-4afa-8c95-e8d171f07153@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1429973784 14700 80.91.229.3 (25 Apr 2015 14:56:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 25 Apr 2015 14:56:24 +0000 (UTC) Cc: 20419-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 25 16:56:11 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 1Ym1V4-00028i-G3 for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Apr 2015 16:56:10 +0200 Original-Received: from localhost ([::1]:48600 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ym1V4-00075X-0K for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Apr 2015 10:56:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59441) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ym1V0-00075P-OU for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2015 10:56:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ym1Uw-0007jC-IV for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2015 10:56:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:50140) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ym1Uw-0007j4-Fw for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2015 10:56:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Ym1Uw-0003Zi-AI for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2015 10:56:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 Apr 2015 14:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 20419 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 20419@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 20419-done@debbugs.gnu.org id=D20419.142997375213723 (code D ref 20419); Sat, 25 Apr 2015 14:56:01 +0000 Original-Received: (at 20419-done) by debbugs.gnu.org; 25 Apr 2015 14:55:52 +0000 Original-Received: from localhost ([127.0.0.1]:39915 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ym1Ul-0003ZF-5o for submit@debbugs.gnu.org; Sat, 25 Apr 2015 10:55:51 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:60365) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ym1Ui-0003Z0-KX for 20419-done@debbugs.gnu.org; Sat, 25 Apr 2015 10:55:50 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0NND00G00ADY0L00@a-mtaout22.012.net.il> for 20419-done@debbugs.gnu.org; Sat, 25 Apr 2015 17:55:42 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NND00FKZASTN570@a-mtaout22.012.net.il>; Sat, 25 Apr 2015 17:55:42 +0300 (IDT) In-reply-to: <162fcb99-b1ac-4afa-8c95-e8d171f07153@default> X-012-Sender: halo1@inter.net.il 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:102028 Archived-At: > Date: Sat, 25 Apr 2015 07:29:20 -0700 (PDT) > From: Drew Adams > Cc: 20419@debbugs.gnu.org > > > > 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. > > > > 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'. Yuck! Why not set it to the first member of recenter-positions to begin with? FWIW, I consider this, including the exposure of this variable as some kind of knob for other Lisp packages, bad style. You should be demanding cleaning this up instead of documenting it. Fixed under protest.