From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "Alfred M. Szmidt" Newsgroups: gmane.emacs.devel Subject: Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72 Date: Sat, 03 Feb 2024 05:16:18 -0500 Message-ID: References: <170687730547.552.9673193819426474611@vcs2.savannah.gnu.org> <20240202123506.0CEC7C0EFF5@vcs2.savannah.gnu.org> <87mssjm0ac.fsf@yahoo.com> <87il36mevf.fsf@yahoo.com> <86frya3q4r.fsf@gnu.org> <87ttmplvar.fsf@yahoo.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="32223"; mail-complaints-to="usenet@ciao.gmane.io" Cc: eliz@gnu.org, stefankangas@gmail.com, emacs-devel@gnu.org To: Po Lu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Feb 03 11:17:04 2024 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1rWD56-0008AR-2c for ged-emacs-devel@m.gmane-mx.org; Sat, 03 Feb 2024 11:17:04 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rWD4P-0002o9-7c; Sat, 03 Feb 2024 05:16:21 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rWD4N-0002nw-Ad for emacs-devel@gnu.org; Sat, 03 Feb 2024 05:16:19 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rWD4M-0007jo-V8; Sat, 03 Feb 2024 05:16:18 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=e3SccZXwHqhhWNUh42uRd51VuOyqzSu+6aHCXoOW8vI=; b=jMJo7mOUB7w0 2+p9rkIB9SHD26zVbh1KV8IXRzVwrObE94v480r8zQsq+BCv+5zYe1GKuLc6gSpG00wjwvCX7m2pO lRZJhSufkx0wNuucOJlMI+e9vQ3X6xoNWM9D5yIQoCAAn41BQfIcIwljBNpm/f1B2DJkMgyF542OY 5eUIUvyD4AmsZMYa3qOdjS6JD3G7uCnM6NuTSPUZOqG5JmeF8kmvK4g+M7zSBqbOz5jhnaZEWHiaM HO4yBbZmDHsHk6s/2x820rbtWghwjqIvyNWNOtH5ACb6ohH4WkX03pdXC5MPwy0yuje75QKceFW9k De4W+2G7/vx9Hcl+dl4+Zg==; Original-Received: from ams by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1rWD4M-0006ET-My; Sat, 03 Feb 2024 05:16:18 -0500 In-Reply-To: <87ttmplvar.fsf@yahoo.com> (message from Po Lu on Sat, 03 Feb 2024 18:02:52 +0800) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:315803 Archived-At: Before responding, I tried to measure the impact of this change by running: (mapatoms (lambda (atom) (when (functionp atom) (and (documentation atom) (insert (documentation atom) "\n"))))) in a buffer, with the fill column set to 72, and typing C-x h M-q. Upon restoring the fill column to 64 and enabling the fill column indicator, the number of lines and words beyond it increased visibly. So this is not so insignificant a detail. That is I think not a good comparison, nobody is suggesting to re-fill all docstrings to 72 (or even 64!) columns. Many docstrings are manually filled, so refilling everything would be far worse than raising the fill-column to 72 (though, I think maybe setting it to just fill-column might make more sense ... but whatever). So this seems to be making a mountain out of a molehill, the current fill-column makes docstrings in general "cramped" to read -- even on 80x25 terminals. And seeing that there is no consitency in how docstrings are filled, the minor raise in the limit is negligible -- you would only re-fill after modifying a docstring in some manner, and in that case the text will get jumbled anyway.