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: Fri, 21 Nov 2014 07:14:15 -0800 (PST) Message-ID: <06151e7f-aaa2-4c36-886b-9754e980a31f@default> References: <87r3wxbju9.fsf@vsl28t2g.ww011> <831tox5692.fsf@gnu.org> <87wq6p9br6.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 1416582933 4609 80.91.229.3 (21 Nov 2014 15:15:33 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 21 Nov 2014 15:15:33 +0000 (UTC) Cc: 19129@debbugs.gnu.org To: dieter@duenenhof-wilhelm.de, Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 21 16:15:25 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 1Xrpvh-0003i5-0V for geb-bug-gnu-emacs@m.gmane.org; Fri, 21 Nov 2014 16:15:25 +0100 Original-Received: from localhost ([::1]:41086 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xrpvg-0004Qy-Gy for geb-bug-gnu-emacs@m.gmane.org; Fri, 21 Nov 2014 10:15:24 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60447) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrpvU-0004Pj-CL for bug-gnu-emacs@gnu.org; Fri, 21 Nov 2014 10:15:21 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XrpvL-0000hQ-MG for bug-gnu-emacs@gnu.org; Fri, 21 Nov 2014 10:15:12 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:43814) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrpvL-0000h5-Jb for bug-gnu-emacs@gnu.org; Fri, 21 Nov 2014 10:15:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1XrpvL-0005kt-7F for bug-gnu-emacs@gnu.org; Fri, 21 Nov 2014 10:15:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 21 Nov 2014 15:15: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: Original-Received: via spool by 19129-submit@debbugs.gnu.org id=B19129.141658286322057 (code B ref 19129); Fri, 21 Nov 2014 15:15:03 +0000 Original-Received: (at 19129) by debbugs.gnu.org; 21 Nov 2014 15:14:23 +0000 Original-Received: from localhost ([127.0.0.1]:41027 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Xrpug-0005jg-TI for submit@debbugs.gnu.org; Fri, 21 Nov 2014 10:14:23 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:22120) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Xrpue-0005jX-Kr for 19129@debbugs.gnu.org; Fri, 21 Nov 2014 10:14:21 -0500 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id sALFEIs9032668 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Nov 2014 15:14:18 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id sALFEF8Z013342 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Nov 2014 15:14:16 GMT Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id sALFEFfm010105; Fri, 21 Nov 2014 15:14:15 GMT In-Reply-To: <87wq6p9br6.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: ucsinet22.oracle.com [156.151.31.94] 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:96376 > > In the case in point, I'm guessing you've filled the paragraphs of > > the doc string, which wasn't really necessary, since the lines were > > of reasonable length. >=20 > Yes, that's right, but I did it mistakenly because I thought it was > forgotten and that filling a paragraph would be necessary to be in > accordance to Elisp coding conventions. >=20 > Now I learned that even though emacs-lisp-docstring-fill-column is > 65 an 80 column filling might be acceptable! Uh, not really, IMHO. 80-column filling violates the spirit, if not completely the letter, of the GNU Emacs coding conventions. What you did, it sounds like (to me), is fix an additional bug: a doc-string line that was too long. I would say thank you (while still letting you know what Eli said about gratuitous changes). But I don't speak for Emacs Dev. >From (elisp) `Documentation Tips': * Format the documentation string so that it fits in an Emacs window on an 80-column screen. It is a good idea for most lines to be ^^^^^^ no wider than 60 characters. The first line should not be wider ^^^^^^^^^^^^^^^^^^^^^^^^^^^ than 67 characters or it will look bad in the output of `apropos'. You can fill the text if that looks good. Emacs Lisp mode fills documentation strings to the width specified by `emacs-lisp-docstring-fill-column'. However, you can sometimes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ make a documentation string much more readable by adjusting its line breaks with care. Use blank lines between sections if the documentation string is long. The default value of `emacs-lisp-docstring-fill-column' is 65. 80 is the absolute maximum for a line. Anything longer than 60 is to be avoided. Longer than 65 (`emacs-lisp-docstring-fill-column') should be justified with good reasons, specific to the particular case at hand. The part about filling by default but possibly manually adjusting line breaks to make things more readable should, IMO, explicitly call out that what is meant is that you can introduce line breaks at columns **less** than `emacs-lisp-docstring-fill-column'.