From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#31656: 26.1; `fill-paragraph' malformats in emacs-lisp-mode Date: Fri, 01 Jun 2018 15:52:19 +0300 Message-ID: <83lgbyfz3w.fsf@gnu.org> References: <83sh66g8wb.fsf@gnu.org> <87bmcuc0bo.fsf@gmail.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1527857470 11149 195.159.176.226 (1 Jun 2018 12:51:10 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 1 Jun 2018 12:51:10 +0000 (UTC) Cc: 31656@debbugs.gnu.org, npostavs@gmail.com To: Stefan Guath Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jun 01 14:51:05 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fOjWK-0002lg-Qa for geb-bug-gnu-emacs@m.gmane.org; Fri, 01 Jun 2018 14:51:04 +0200 Original-Received: from localhost ([::1]:55610 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fOjYR-0000ZU-Oz for geb-bug-gnu-emacs@m.gmane.org; Fri, 01 Jun 2018 08:53:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45656) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fOjYJ-0000ZD-Df for bug-gnu-emacs@gnu.org; Fri, 01 Jun 2018 08:53:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fOjYE-0002Q4-Nf for bug-gnu-emacs@gnu.org; Fri, 01 Jun 2018 08:53:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:49035) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fOjYE-0002Px-Jn for bug-gnu-emacs@gnu.org; Fri, 01 Jun 2018 08:53:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fOjYE-0007Xz-9v for bug-gnu-emacs@gnu.org; Fri, 01 Jun 2018 08:53:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 01 Jun 2018 12:53:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31656 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 31656-submit@debbugs.gnu.org id=B31656.152785755128975 (code B ref 31656); Fri, 01 Jun 2018 12:53:02 +0000 Original-Received: (at 31656) by debbugs.gnu.org; 1 Jun 2018 12:52:31 +0000 Original-Received: from localhost ([127.0.0.1]:56932 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fOjXj-0007XG-7t for submit@debbugs.gnu.org; Fri, 01 Jun 2018 08:52:31 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:54537) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fOjXh-0007X4-HY for 31656@debbugs.gnu.org; Fri, 01 Jun 2018 08:52:29 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fOjXX-0001on-J8 for 31656@debbugs.gnu.org; Fri, 01 Jun 2018 08:52:24 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:53092) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fOjXX-0001of-EM; Fri, 01 Jun 2018 08:52:19 -0400 Original-Received: from [176.228.60.248] (port=4442 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fOjXW-0004Hp-TV; Fri, 01 Jun 2018 08:52:19 -0400 In-reply-to: (message from Stefan Guath on Fri, 1 Jun 2018 12:36:00 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:146819 Archived-At: > From: Stefan Guath > Date: Fri, 1 Jun 2018 12:36:00 +0200 > Cc: eliz@gnu.org, 31656@debbugs.gnu.org > > The very idea of shadowing the global `fill-column' in the first place breaks the Principle Of Least > Astonishment If that is so, then we should have gobs of astonished users since 1995. > and introduces annoyance and extra work for the user when trying to understand why the > explicit setting of `fill-column' is not respected. Documenting the current behavior should go a long way towards helping users understand that, right? > So, I guess my basic question is what value `emacs-lisp-docstring-fill-column' tries to add? >From my POV, the answer is clear: it allows users to have different customizable defaults for fill-column in Emacs Lisp and elsewhere. E.g., in text modes, it is customary to enlarge the default to 79 or thereabouts, but in Emacs Lisp we generally say that good style is to make lines in doc strings no wider than 60 characters (see the ELisp manual). > To me this entire functionality should either be removed or fixed so that its behavior reflects its current docs. In > its current state it just malformats elisp files in unexpected ways. Or am I missing something? I'm sorry, but after so many years we had this working, removing this functionality is out of the question. I suggested to fix the docs to match the implementation; if someone has other suggestions that don't break existing behavior, or at least let users get back existing behavior, please describe those suggestions. Thanks.