From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Po Lu Newsgroups: gmane.emacs.devel Subject: Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72 Date: Fri, 02 Feb 2024 22:02:51 +0800 Message-ID: <87mssjm0ac.fsf@yahoo.com> References: <170687730547.552.9673193819426474611@vcs2.savannah.gnu.org> <20240202123506.0CEC7C0EFF5@vcs2.savannah.gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3180"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: Stefan Kangas To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Feb 02 15:04:01 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 1rVu9A-0000gM-Sk for ged-emacs-devel@m.gmane-mx.org; Fri, 02 Feb 2024 15:04:00 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rVu8N-0004pR-Ly; Fri, 02 Feb 2024 09:03:11 -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 1rVu8M-0004ni-9A for emacs-devel@gnu.org; Fri, 02 Feb 2024 09:03:10 -0500 Original-Received: from sonic316-20.consmr.mail.ne1.yahoo.com ([66.163.187.146]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rVu8K-0001bC-CA for emacs-devel@gnu.org; Fri, 02 Feb 2024 09:03:10 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1706882583; bh=tcoo/cz89vo5kzdcnyeVp7rhret8gJFOEHt8Bp77K64=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From:Subject:Reply-To; b=aQaHA4k9vLIuWoAPMhCGu2OK5+4NgvXZsPl1IhkP8Tc4rvtxdoxETHnGGRuihXBJFZy7b01vRRbux2LFoOu8SdG+EZT4rGkh9WMUKeOixAUsRZUsBaG6psrGr0WqfEsy8+3oiiMspjGLdl1mlwEU4v273vbSqPfLd4camVaReXNNz/1PYEOwm0A2NWbAJwVn1vGPU0XcT+Mbdv2VLZimrVzfdGX5Pz5hNc05ypck/hkHCs3KpAf3whhWW6ibmNouE5gUlzmrO2enHbRWfAETCzRNRVVcXe3UTDecfQecKdudPlYzzlRDc3JBWtLGbybqYfFku9GyL8WeBjes8WTVGA== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1706882583; bh=aqp3jV2zoltCkeKwL3oYIIjS4+jzBtupUjRx++w+Who=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=p5lM+Y8Dv2ojThtHNu9M9cwucI3+Purg3TEZWRYXnef3PAabPji0FBZf009b14NRTCZr8yEwAnw7U4WeE9DZ6d2GYWVUImxTxrdat+d5TPylWyMX6sNaPvd2+4nd74+KnHFL5jtRhF3lIyUN0PqxWVMqkGON7AUMN3rbFJIcB5Vt1RXihve0vw2V0U12YHBoUfPFTopkRI3BTdP1N+it5aFZjfa6m94YwPDjOZiPnGLvKRcVL4whi+wDTBQ3BgswNMKIoobYLZeS5E4RaRdDXN4/k4l6EZCMai4NpieJ9FeR8J5HHV9OL7WmtgM786I9WIDmFEtDM0OMrB+Xoxfwiw== X-YMail-OSG: 7OJHo4AVM1mmAyTpuJF9vCfs0igcnS6zs7I4WAD.CC3S4ZZp2LdO9ki.qNiqpxj Hg6PR.bEZaFXCGUNZAgH.8he9nun5nZ6oTGg8qiqtFLPzioBkpe19U7_OVQB3sMa911dBPvFcFG6 6zb_jsVTUBqkvAotuwZhSnmrSdp0Ed_IT4q0oa2XlaI45Vc6jU34cTPqWu7hi8M.ovyl9Pd2Mg_Q K.ZZg6O8.ajEwWO.ZXt4cDgYw5v7sMdgBTKAEGeEMj_I1A.pPaS7joFlDlBm6Roh8j8pBNcFcXCN tNUhxh817vbUrjpZHALttQyKqfRoZZWMTkH.S7eksMoxC1XZBcStL0o98NQ09CGeJW2rW2_prMz1 u3IAORqmc25l_sBSa3wH_AOWniz5aETVZqdpX4Q2o.kwd47w.oRb29eNag9ZylL.4is4uEbx4B29 TjlkdCMlvDbmM0Upf.6qnho9tef5Cz0ZM.ISBGdnPL1D41abd7MCtoICSjDSD8dF1iRJowHPBb9_ u.wyKl42VZv8OrfAs_yEDyeDMbG47zCzQVjOoV88XRApGAsk5D87l.9qCXzCMEY6YrrPPUnWss2l TkkQxNJZYFPS.vtjwx0HuEdXyl5wi3gn5uePY.XfmAMV2ExtpwuW1.zl2QWfVMzjDIBQ72CfXABL VQMLWCfsP5JVaygcVA8FdaT4DSKvRny1SW7gWEdg2sv3G8hZo0Tl8nwnpIS7_vpJfsbiJZxVgZAS pT0tNhZ5qeCqs4pWrgxWuPp_C0vMN6XaHRcO6K2Uaj_AV7XArj8VsctEqV90ezHtS2mHqxNJuxrY 0YEGbxxIfkkbvKLJW.PFXdWJIeaXAl9f4_NnlhGxka X-Sonic-MF: X-Sonic-ID: 659e7769-12ac-4ff5-b359-05efad777c64 Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic316.consmr.mail.ne1.yahoo.com with HTTP; Fri, 2 Feb 2024 14:03:03 +0000 Original-Received: by hermes--production-sg3-6dc75bc8fb-cp2ns (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID 523f7aff8ff6e6a0c9e0be109063d0f5; Fri, 02 Feb 2024 14:02:57 +0000 (UTC) In-Reply-To: <20240202123506.0CEC7C0EFF5@vcs2.savannah.gnu.org> (Stefan Kangas's message of "Fri, 2 Feb 2024 07:35:05 -0500 (EST)") X-Mailer: WebService/1.1.22046 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo Received-SPF: pass client-ip=66.163.187.146; envelope-from=luangruo@yahoo.com; helo=sonic316-20.consmr.mail.ne1.yahoo.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action 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:315746 Archived-At: Stefan Kangas writes: > Increase `emacs-lisp-docstring-fill-column` to 72 > > Monitors are wider now than when these defaults were first set, and it > is useful to take better advantage of that, to fit text on fewer lines. > Yet, it has repeatedly been shown that overly long lines reduce > readability: > "A reasonable guideline would be 55 to 75 characters per line."[1] > > We also don't want to disfavor narrow displays, like mobile phones; a > more promising direction here might be to automatically word wrap > docstrings and make their maximum width customizable. That might > require a new docstring format, however. > > Bumping it by 7 characters, from 65 to 72, seems a reasonable compromise Generally speaking, 65 columns is already excessive for mobile phone displays, but only just, and it is usually possible to infer partially obscured words while reading doc strings without scrolling lengthwise. Filling doc strings to 72 columns removes that ability, forcing readers to scroll the display back and forth to uncover obscured words, so it can't be more of a compromise between narrow and wide displays than 65 columns is. > for now. Consideration was given to increasing it to 70 or 75, but 72 > happens to be a commonly recommended maximum line width elsewhere (see > Fortran 66, Python docstrings, commit message recommendations, etc.), > and we might as well do the same. > > This change was discussed in: > https://lists.gnu.org/r/emacs-devel/2022-07/msg00217.html You'll excuse me if I've overlooked something, but judging by the referenced thread alone, the change originally proposed was barely discussed, and certainly did not generate enough debate to establish its merits and deficiencies with any degree of certainty, let alone those of imposing a new value on all Emacs users. For making decisions about a far-reaching departure from an ancient configuration, an inconclusive thread over a year in the past is not a source of sufficient input, even more so when the change which prompted that thread would only have affected ourselves.