From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.bugs Subject: bug#57009: Obscure doc string of new variable syntax-wholeline-max Date: Fri, 5 Aug 2022 21:35:59 +0000 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="15566"; mail-complaints-to="usenet@ciao.gmane.io" To: 57009@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Aug 05 23:37:11 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1oK50I-0003py-Mq for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 05 Aug 2022 23:37:10 +0200 Original-Received: from localhost ([::1]:48868 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oK50H-0007zw-0k for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 05 Aug 2022 17:37:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51100) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oK50A-0007zn-Mx for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 17:37:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42682) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oK50A-0001Ty-Eg for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 17:37:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oK50A-0002ot-95 for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 17:37:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Alan Mackenzie Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 05 Aug 2022 21:37:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 57009 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.165973536910776 (code B ref -1); Fri, 05 Aug 2022 21:37:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 5 Aug 2022 21:36:09 +0000 Original-Received: from localhost ([127.0.0.1]:60664 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oK4zJ-0002nj-4t for submit@debbugs.gnu.org; Fri, 05 Aug 2022 17:36:09 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:36176) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oK4zF-0002nY-Ax for submit@debbugs.gnu.org; Fri, 05 Aug 2022 17:36:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51000) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oK4zF-0007wu-5Z for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 17:36:05 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:21471 helo=mail.muc.de) by eggs.gnu.org with smtp (Exim 4.90_1) (envelope-from ) id 1oK4zD-0001M3-47 for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 17:36:04 -0400 Original-Received: (qmail 24203 invoked by uid 3782); 5 Aug 2022 21:36:00 -0000 Original-Received: from acm.muc.de (p4fe1574c.dip0.t-ipconnect.de [79.225.87.76]) (using STARTTLS) by colin.muc.de (tmda-ofmipd) with ESMTP; Fri, 05 Aug 2022 23:35:59 +0200 Original-Received: (qmail 21456 invoked by uid 1000); 5 Aug 2022 21:35:59 -0000 Content-Disposition: inline X-Submission-Agent: TMDA/1.3.x (Ph3nix) X-Primary-Address: acm@muc.de Received-SPF: pass client-ip=193.149.48.1; envelope-from=acm@muc.de; helo=mail.muc.de X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, 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: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:238943 Archived-At: Hello, Emacs. I came across the variable syntax-wholeline-max in reading a new bug archive. Its doc string, in full, is: syntax-wholeline-max is a variable defined in `syntax.el'. Its value is 10000 Maximum line length for syntax operations. If lines are longer than that, syntax operations will treat them as chunks of this size. Misfontification may then occur. This is a tradeoff between correctly applying the syntax rules, and avoiding major slowdown on pathologically long lines. Probably introduced at or before Emacs version 29.1. .. There are several bugs here: (i) It is not clear what is meant by "syntax operations". These should be listed and if necessary, explained. (ii) It is not clear what it means for a "syntax operation" to treat a line "as a chunk". This should be explained. (iii) "Misfontification" may well occur, but what about other bad effects of ignoring correct syntax? Don't they deserve a mention? (iv) There is no mention of a mechanism to disable this "chunking" effect, whatever it might be. If there is one, it should be documented, if there's not, this should be stated. I'm not asking for an explanation of these things. I can look up the source code and work it out. I'm asking them to be fixed so that other people don't also have to read the source code. -- Alan Mackenzie (Nuremberg, Germany).