From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Daniel =?UTF-8?Q?Mart=C3=ADn?= via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#50801: 28.0.50; Emacs manual about file variables doesn't mention that major modes shouldn't end in "-mode" Date: Sat, 25 Sep 2021 15:39:45 +0200 Message-ID: References: Reply-To: Daniel =?UTF-8?Q?Mart=C3=ADn?= Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="21709"; mail-complaints-to="usenet@ciao.gmane.io" To: 50801@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Sep 25 15:40:11 2021 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 1mU7uV-0005Tk-Oo for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 25 Sep 2021 15:40:11 +0200 Original-Received: from localhost ([::1]:44730 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mU7uU-0004Ck-6P for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 25 Sep 2021 09:40:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33416) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mU7uM-0004CY-0K for bug-gnu-emacs@gnu.org; Sat, 25 Sep 2021 09:40:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:48910) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mU7uL-00055Z-N8 for bug-gnu-emacs@gnu.org; Sat, 25 Sep 2021 09:40:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mU7uL-0004hc-LX for bug-gnu-emacs@gnu.org; Sat, 25 Sep 2021 09:40:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Daniel =?UTF-8?Q?Mart=C3=ADn?= Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 Sep 2021 13:40:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 50801 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.163257719618059 (code B ref -1); Sat, 25 Sep 2021 13:40:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 25 Sep 2021 13:39:56 +0000 Original-Received: from localhost ([127.0.0.1]:60456 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mU7uG-0004hD-80 for submit@debbugs.gnu.org; Sat, 25 Sep 2021 09:39:56 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:48136) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mU7uE-0004h5-M0 for submit@debbugs.gnu.org; Sat, 25 Sep 2021 09:39:55 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33414) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mU7uE-0004CL-FB for bug-gnu-emacs@gnu.org; Sat, 25 Sep 2021 09:39:54 -0400 Original-Received: from sonic313-20.consmr.mail.ir2.yahoo.com ([77.238.179.187]:43305) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mU7uB-0004uc-Ov for bug-gnu-emacs@gnu.org; Sat, 25 Sep 2021 09:39:54 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.es; s=s2048; t=1632577188; bh=+6mwVwj0kGttBfeC8FqWmAleSP8ONG8JJTw231IGnbY=; h=From:To:Subject:Date:References:From:Subject:Reply-To; b=k29rC6g1SHcEC5FcfUPRa037oJsrqcNNy3b+zvfoAlb5eYYlE3CmYVolLxqj9cHLwv2BSfvxRlioprlSExcyGqIRY3oiLOwCHolUU/iCoo/59wt0rfAQoZ0FxA4R7kdgEpMWbfN+bCaJopttzOpF99XlMCLW8LHCJqMlzJZYNcLzqpuQFJ1AfA//Sc7VcsVXCuDn4rhz0CwFspP+R748F4WSlYDT0CM38oFkav2O9SZnsNkxH7iZhKBxeYJUb2wD3kXR570RtYwiA9sxqALrEJ7H89hz61qyZgomQUzvlstQk6as0/MJKVrDh4QeUzYGRib3yO+gV+/hL8WuG9ENgA== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1632577188; bh=1GYrm4ruviWNaEQUpcPXClh1uBXq5Yyg0+IFKcqvZEo=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=hBLLt3c8Hilooq7NwiK0CuvK6KGn2zPyayApkIc/RaZCztz04pge8G4AHU/NTEGpLlRvjJPZJiIFGt53XwQy3hkIKWYm1a06MR1JphbTwUKH4ww4lXOSjq+APER254A/aBhN5roruBr1lXGbOa+DALz1mSVv8obhJfA3NmyQaImlDE9srHYHOErm45YoSE6H1q8cItahC07FnFu04W992p/IZ2zW3mt4UpIqMIGM7oEHLemRX9t4Gr02wlY1MZH+uljplepBo9eZFcVHCOrIfQPe6KcGdUfAMT2WZJ5DfjxNrp1D+GvHuh7f0H2hwBirDyU0KGFyhtjUed5e0QmThA== X-YMail-OSG: H.wDfyIVM1lQ0jWD2x1DLjSDf1OrhyjXvps7ix5.BDgFq9Pj347WTGTGV7f7E8r DtUjOi0hk220_TmbX4ulZGHDRBV4zw_GRxVnZVBjv_GRwhuR7C6KfYFUjSlmnPz6UUpWcK2KVW7y NMWC0rYUUqt1_LquQzHKDexZ7ZyF9XDqCafrjP6iiecoEXsnwA.wn1vKbp1VED_Vay9w4N7OIlEy oXb8LDqAClNQk39HeP.tCOGkyVdEoH0Nkp1iszYuQ_aqamq5zogEiQhILNwkLy0SikVApzwvlARg x8NKismIKDDhMq.ygoyyIvlzvDeVNca_AWayXu493aN3swo2jNOC4eA6BAJlYJ.IyWVwhqHUEODX N69y.W8vTWYNJfi2wl.pKgHtl7CGOGMdiFu78Whh1Y0NuZx1_vzcIDrxGhy4Vm2T7RvhwIj1QegZ KrO5DZlY6YZlppjELuo3D.MuCAXTIKikNBQnBpX5m0ZuYO0LqrfYO5jojLiqPufMElw901Rl6GKa vOqXA5oEs4DMbj1lY3S5gZMJm6al2m48X1Y0ngv9bwJUCE3bIpLkp5qw3wu0dSOTj6VqmcrjTHLj 6ev.jJMgNCHQkGqmA.CxuUOSf3EB39267Ue_Il4G0PunV6sgHEs56LNhawPTVYT6LpCqSVUAOQh. z2HXYwdmObKwZJx7_pGjhK8j1aoyV7YPBzpyXYH0l2ovVdm1XhcTUowfaPXpL1R4aey3f.64Ywnd 4bBRN8ICk3PJwvrGZ7kNU30uEPuDTJypE8eJWim_1T0czVnGFWgrbKfKmB4PFUB_03_FSAf0SJhj Oqn1yBqtN92CsabrdzZi9HYYE6o7koGM5exDRJhoi0 X-Sonic-MF: Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic313.consmr.mail.ir2.yahoo.com with HTTP; Sat, 25 Sep 2021 13:39:48 +0000 Original-Received: by kubenode530.mail-prod1.omega.ir2.yahoo.com (VZM Hermes SMTP Server) with ESMTPA ID fd6894ed26e6ed6eacb8f126524721d1; Sat, 25 Sep 2021 13:39:46 +0000 (UTC) X-Mailer: WebService/1.1.19043 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo Received-SPF: pass client-ip=77.238.179.187; envelope-from=mardani29@yahoo.es; helo=sonic313-20.consmr.mail.ir2.yahoo.com X-Spam_score_int: -4 X-Spam_score: -0.5 X-Spam_bar: / X-Spam_report: (-0.5 / 5.0 requ) BAYES_05=-0.5, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, 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 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:215443 Archived-At: I'm reviewing the manuals for the upcoming Emacs 28 and I have a couple of minor suggestions for node "49.2.4.1 Specifying File Variables": The node doesn't explictly mention the crucial information that in 'mode: MODENAME' 'MODENAME' must not end in "-mode". It's true that there's an example down there that says "mode: Lisp", so users may infer that you don't need to spell the major mode with "-mode", but I thought it may be better to be explicit about in the manual. Another suggestion I have is that the manual doesn't mention that something like "-*- C++ -*-" (that is, omitting the "mode" keyword) is also supported. Many free software projects have traditionally been using "-* C++ -*" in their C++ header files to make Emacs distinguish them from plain C files. See also src/epaths.in in the Emacs repository, among others. I see this used by Jim Blandy since 1992 at least, but I don't really know if a) it's really a stable way to declare a file-local mode, and we may lack the historical info to answer that, and b) it's worth mentioning it in the manual. Thanks.