From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Emanuel Berg Newsgroups: gmane.emacs.devel Subject: Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72 Date: Sun, 04 Feb 2024 02:25:02 +0100 Message-ID: <87v87558cx.fsf@dataswamp.org> References: <170687730547.552.9673193819426474611@vcs2.savannah.gnu.org> <20240202123506.0CEC7C0EFF5@vcs2.savannah.gnu.org> <87mssjm0ac.fsf@yahoo.com> <87il36mevf.fsf@yahoo.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="36344"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) To: emacs-devel@gnu.org Cancel-Lock: sha1:JOxeTj1L3vcS2uyimsgQ7JfoVVk= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Feb 04 06:59:26 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 1rWVXK-0009FW-39 for ged-emacs-devel@m.gmane-mx.org; Sun, 04 Feb 2024 06:59:26 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rWVWW-0006jG-Et; Sun, 04 Feb 2024 00:58:37 -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 1rWRG3-0008Ga-Kq for emacs-devel@gnu.org; Sat, 03 Feb 2024 20:25:19 -0500 Original-Received: from ciao.gmane.io ([116.202.254.214]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rWRG2-0004S7-0g for emacs-devel@gnu.org; Sat, 03 Feb 2024 20:25:19 -0500 Original-Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1rWRFx-0001wD-Sq for emacs-devel@gnu.org; Sun, 04 Feb 2024 02:25:13 +0100 X-Injected-Via-Gmane: http://gmane.org/ Mail-Followup-To: emacs-devel@gnu.org Mail-Copies-To: never Received-SPF: pass client-ip=116.202.254.214; envelope-from=ged-emacs-devel@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.249, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sun, 04 Feb 2024 00:58:32 -0500 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:315853 Archived-At: Stefan Kangas wrote: > The claim that wrapping docstrings to 65 characters in any > way solves that problem is just wrong. It is the same as > ignoring the problem, perhaps simply because it happened to > work on the one screen we bothered to test with (using some > font and font size, letter spacing, etc.). Yes, as long as it is hard coded it's gonna be a problem across platforms. But there are also advantages with having it hard-coded, e.g. ascii art, tables and other formatting - that is all put there manually, so offers complete freedom and precision, to those that are into such perfectionist/pleasant documentation work. A solution could be, keep it hard-coded by default. But introduce an option, "help-wrap-lines" or something like that, when set, lines will be wrapped automatically when displayed by the help. In the docstring to the option, it will say explicitely, "note that this method may not display docstrings exactly as intended by the docstring writer." So whenever 80 chars won't work, for example on smartphones if that is the case right now, one would use that option if desired. In general, I like the help system in its simplicity. Re-writing it from scratch I disencourage from but sure, add new features to make it more interactive, intuitive and powerful. Here are my configuration and extensions, 90 LoC: https://dataswamp.org/~incal/emacs-init/help-incal.el -- underground experts united https://dataswamp.org/~incal