From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#74267: 29.4; Doc string of `add-file-local-variable` Date: Fri, 8 Nov 2024 21:25:01 +0000 Message-ID: Reply-To: Drew Adams Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25647"; mail-complaints-to="usenet@ciao.gmane.io" To: 74267@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Nov 08 22:26:59 2024 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 1t9WVO-0006WO-7Z for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 08 Nov 2024 22:26:58 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1t9WV1-0001Uo-EK; Fri, 08 Nov 2024 16:26:35 -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 1t9WUW-0001TV-CJ for bug-gnu-emacs@gnu.org; Fri, 08 Nov 2024 16:26:07 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1t9WUV-0007sd-7g for bug-gnu-emacs@gnu.org; Fri, 08 Nov 2024 16:26:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:From:To:Subject; bh=kB3NJDaqocDk7ayCroG8Jxt/xW3/+XtYepEa6gDSfFI=; b=rC35KqFeoLMaYpySW4tYCkevOBNtVIJ/m4odhj6/7pcu8VC2NYiCPDVA3ia+sWJ312mdlKIEFv30IF/qDaWdHgryPO/CrTnm1B0r8tqC5L6c9R5tawTIeASwM17S+k/Js4fICqlzjreqQ/qy8w+Ic8RNO6DLCwPqdQbQDBbKZs9f8vPCE+3xtisMNkJwdj4mM14NYqWDUKCEyScqEdiGW13bSs4dFidJEwin5y00RXEBpFUrdM2W8DFS+dr+/LJytONjwhvmQOC1BbifLU+t0/LSo+G4ohqIs4+We3JxFPgW/geVk9t5AEp0Rk955nMWn48hxR2CAZPko/urxb2S2w==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1t9WUU-0003ZB-Om for bug-gnu-emacs@gnu.org; Fri, 08 Nov 2024 16:26:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 08 Nov 2024 21:26:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 74267 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.173110112813650 (code B ref -1); Fri, 08 Nov 2024 21:26:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 8 Nov 2024 21:25:28 +0000 Original-Received: from localhost ([127.0.0.1]:52348 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t9WTv-0003Y5-P7 for submit@debbugs.gnu.org; Fri, 08 Nov 2024 16:25:28 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:35582) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t9WTs-0003Xw-9i for submit@debbugs.gnu.org; Fri, 08 Nov 2024 16:25:25 -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 1t9WTp-0001R4-Tb for bug-gnu-emacs@gnu.org; Fri, 08 Nov 2024 16:25:22 -0500 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1t9WTe-0007q3-Ps for bug-gnu-emacs@gnu.org; Fri, 08 Nov 2024 16:25:13 -0500 Original-Received: from pps.filterd (m0246629.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 4A8FtZKj010132 for ; Fri, 8 Nov 2024 21:25:05 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h= content-transfer-encoding:content-type:date:from:message-id :mime-version:subject:to; s=corp-2023-11-20; bh=kB3NJDaqocDk7ayC roG8Jxt/xW3/+XtYepEa6gDSfFI=; b=AMW42T+B40YnYA/hHYzI6vYQipF5ebE0 duenljIhRDhLO71T0EEhgtcb3dEUJpG5AcEVklx9cb/+LYhdxnOp0TCPfblJM7jB C+hp04ewaKq2NuERw9p8bj72G5Fx4aT/frtJPIbdK0GuSmy8E+gUiX7G+gKyIgmH 37AQoMl9jBDr6ohNJX3sF+Rjhgn8uxgRpZRsic7WWo/FtHFDEYH7rUTjvKCoUGwu 3aI2j7fVNGJxC07VAKXoryLUQmVGTUaijMMaHEsqfcl/wJnNhENKGlbesN02287c uhYduQ20q11c3iM4NVBTmUkM6CtBIZwEhu7CbHJSxuHRP/1LJJ/DEg== Original-Received: from phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta02.appoci.oracle.com [147.154.114.232]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 42s6gn2e6k-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 08 Nov 2024 21:25:05 +0000 (GMT) Original-Received: from pps.filterd (phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (8.18.1.2/8.18.1.2) with ESMTP id 4A8KtIRI028736 for ; Fri, 8 Nov 2024 21:25:04 GMT Original-Received: from nam12-dm6-obe.outbound.protection.outlook.com (mail-dm6nam12lp2174.outbound.protection.outlook.com [104.47.59.174]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 42nahbwek9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 08 Nov 2024 21:25:04 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=gF4Ir4Ww9JIh1c9ktjERuGQjDLyo+amf0x2qprknY5cenTO8fiL6tSA4DcvQUfpjdw+s+Y2aJeodm+XTygnyOLRC0DryNb9PIWEiIzlum40MuL+BdICbl0xBpUjdujIe19gTyf0ATpZx/xXdRjESLPqZhdFFw/Csh81P5T6FRCThUXtT9IybERbiAHODkfBWEne0CTyRN7lCA6XJDVmT3dnPLXysNt3tVi1uf1RbWQiIfrjx3htALw+HLy8E/H56tMPYL3C+bRMu/i1zfcdCqy1t35loB0VzJ17YoeGZES88onTuPH2P444ti4dPiw4iFPtXswQdc4qOwvWFGpwQAw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=kB3NJDaqocDk7ayCroG8Jxt/xW3/+XtYepEa6gDSfFI=; b=yHLKUVCd5md8B+YbJJdUDuMds7YgctloSycKsS6AyRFUtJ5/tmPMikhVZbL3zzRhYitwtMjT4gvgKMgo2Wj05RMa5LBtO1B7SzuWEBJ8gZPRpYBaejS4/dA7XkrnWw7qBwOHZp6AywTDoPezr+qJ1qS5UbZ7kbjyzVs7pkUawfxU+onykCwfoayBg+9WyA+9FFGD15u41jlnZUHUtKebe4vLPxVuRn+hNBmRwI0T5636KDDIg7fbgIxKH9+KWLZI786CQyi2LaTyZkbW9ko9UZYZaYPSA+CEfB6xge2CxA7SCLG0WfkKbiBlH/k0/IKb+COCg2pcXkf93LaQGw80rA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=kB3NJDaqocDk7ayCroG8Jxt/xW3/+XtYepEa6gDSfFI=; b=QIhflyQnqUsuL+dWpuDvOXXeEHE6QfBfFHSQgNB3hasW/V8GOAzLlfpEowfnjiHFNTsutgiULHTWDvR0mn7Ktph1h0OtMPdxfBgmS9G3YXWEQBHj17wE92Udi/zYMhWZ8SRNirRO3RDsc0YyA7fDK3wgYLIYImNBSky8Ce+DtLg= Original-Received: from DS7PR10MB5232.namprd10.prod.outlook.com (2603:10b6:5:3aa::24) by PH7PR10MB6252.namprd10.prod.outlook.com (2603:10b6:510:210::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8137.19; Fri, 8 Nov 2024 21:25:01 +0000 Original-Received: from DS7PR10MB5232.namprd10.prod.outlook.com ([fe80::8303:658f:14f8:2324]) by DS7PR10MB5232.namprd10.prod.outlook.com ([fe80::8303:658f:14f8:2324%4]) with mapi id 15.20.8137.021; Fri, 8 Nov 2024 21:25:01 +0000 Thread-Topic: 29.4; Doc string of `add-file-local-variable` Thread-Index: AdsyJKL2mRjoIvXtQ3ujfQ6JYkFGGw== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: DS7PR10MB5232:EE_|PH7PR10MB6252:EE_ x-ms-office365-filtering-correlation-id: ed0b294a-eb94-49ab-4a67-08dd003bce0e x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; ARA:13230040|1800799024|376014|366016|38070700018; x-microsoft-antispam-message-info: ZgYR+0ALT1RXtcfO5WIHfwkDmmwZrBsKT8qbTgZGoJ97O80gASyMjlv5nEPB28n2usKaI8G8GoPhD7m5G1H03qkB0upj6w3CFA0kCvI338K1j2XIuMrWIeS39p8ZT3H++I8hGLdFYsUINGyj6+zeCASsLN4olErs1tEYjRmoRY5+1Ncia87SSBWEW8kzour03m8Ri4BqJ7Zo3Qhmsx1ULHiglEUtHNDvbxIu6JkODYmmKz29+iCi/DWRgtCX8OL+uRzBPlR5hpRCcpvJlk0MxxDuPLv4TvYOYqn/+8lnRtRZz0NjFw6Eh6DWi3vp8Fpo7juHuy9WXwLogR3+9GdBxpDupuGEVIqYvb3zyFzi2E06+qykglhprsUyOujVAFj1YirfPo/vXhPU1/bVWmPqF4v2hQiWg19A4Clc7erm5ORyIq7KFQBPgJ6qz87t0DMFHWR/jifVc/iC+CK3bdeVOXUrlQYvpzJ2YeCvkeHJwbHECoxB1tKGBt5fOkmxjuhI6Mx4e10N0imlg1/E+EATG8Yv/qJvEQBBXwAcFSDEb2wR+ZtGFTRcWeVr8ykJgjTO6bsu2+8r0fQCQ/rWlAqDJil4erlCoFxbvZIlY4UuRJjGnbK51gFshmaJOXDolZYlHInyp+V3bccqKRnF8nlBH7Rv0DlgtshDK+M153MlMUbuaJ29RR7tQKUsiSYc1F3ip6mzqcEYb5bkbqwB3OJvEi2PsckdYHeySa6o1q0WlIijYuzH/al7i8jqfgmpP XWA4HtOvUICoobgD3hXitHuSSQ6vbNWChrBdEjkW6vk3wdMlu+svPNKaSpZUOq3bskxNJCws3gCY1AkTxXJfhTg7j2GN+b12Nq x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DS7PR10MB5232.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230040)(1800799024)(376014)(366016)(38070700018); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: 6eZ2jf0zQLjV+fbLQB5P4YZVV4OUPf7Oi0Pbf0dknrsM2cwVZfx17aTKdGA4KukKF8CjubtMkJCgc0LdUEMLN4HxZ8fXSx7j6ZZG+eRJlN6SbZzgAtDvoyjh4JW98JOY/vIQiokl5+o0MStQm7w4Ra8xBPy66Bk44FfEJkyCl5+T8aRag0/CtEw6cEwh2S9E9vpUpNWnoZZlUv5d9akTDhnVoGW4mSeKiw7/CUWTnge2VSuaQ66v6AHtK5H1EHPaXEpRFWNOkjwDNB6NqyLW7VDvnPABGfnRO8A0IinNwOfiZtkdx9Y68ykhKrA2Dr8/YJkNx22bg+j886UBcRsPbzSxYPmwRhWxSP9s3HclGQ2KdAw5jlcovQHTicP2rOLN6hcIVjIIcUyFys0onIzeDMqa/yuoJqMO470MHwgig9eGsqAIxrtL0U7VXT2GS8Gg8ej/6Scm8w9wqRSpWtZmJ6CWW53yCs8vFL0f6BPC1ryMZ+7b004j+aaFWuyla8WuTWaiPLkZzv1e/OculRQnfzHmhuKuNGDU7SgVcGeHkBMtny+GrtL0ZC/NXCGPvSgk+9GlR2bj0+kjX26kQwKRQpwOaJG/sjuuh1KgzAVB9bY68TGxjCPVavd6jv8tTkIAC1MNEOWg3LcI6W9uV7wZegXSFLzbzYLoehJmic/84bn1N8CKjiS4Rd31SBbLGrnEAHDEp4V5sSv+UM3ITh4+V1feOQiavt7S67dtvxyv+zS7w7M3aLoNsi8mze SlpLRtORm7m7kOXKiABn3ktFqrZHWhUHEpcHssH32o5d8fM4lUScLWfRwwjgdVA4QVriJOnILmSnpign5JVjoIyLhouqH235a6 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: OTxmb3w+q9/Cufow117NIjJH1J+vjl6vIFJyt/ygLsMXARsphVQoNG6QhLU9FP/3MJoSrLnP+YPM/XuK+/qY46p+yfYm/NXZDkzLzvijzumr7BZdJxFMrRnAVGu/DKlmSYRLst2/KcI0tEs5ch+rQobRXv/c9iQOZN4fPqtTbgaXDYIQEOvJgPw8a8Jraa8gywPwtf3Hum9cW8H62K7qyo5ES9ptN4YZ8xJBEdijLtyawwvgBBdd4LWAA30ajA5j1T4lVT12L5WrLVsY31OZ91xlpsdURi1812vcwrFIvLsMMzDXydnJuU4Yox1zlC5KVGFdG+IY0JlsMf7d/PdbpYIv+NzcSmE7tFVX96sMaVZ2yBDWBc20z/CBE5jQWnijcwVgobnCz3HulClvbvtKzn9iDyvkMrYLW7PTIvy+Fw6Ur1tk9viIuXmvnediqRuK0YHa2RnT9q1kDzMXw2jk/i263KLYtWR6iMoC57XVEF93BOTkFJQNmwqoxeAF7vKyyHu2iCXnwYFznzR6wrUE93ZpwYFIsKJ4UQBPC/xqr7pqxzuf1iqw/6wpa38gtBA37PdHSwWbdN/gYT4IV4vRVBBRpsV+9HynkMpcceFXHys= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DS7PR10MB5232.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: ed0b294a-eb94-49ab-4a67-08dd003bce0e X-MS-Exchange-CrossTenant-originalarrivaltime: 08 Nov 2024 21:25:01.6418 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: wcC7GWyvMD2oYwVn9NQVCJPw7XiLxVJoKf170/ywoV86Mvk+zFv8jtVZbYaBrD6X+vHOKFQBNm8hVkZmJ9dmhw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR10MB6252 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1057,Hydra:6.0.680,FMLib:17.12.62.30 definitions=2024-11-08_18,2024-11-08_01,2024-09-30_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=897 bulkscore=0 spamscore=0 adultscore=0 phishscore=0 suspectscore=0 malwarescore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2409260000 definitions=main-2411080176 X-Proofpoint-ORIG-GUID: JDSKf1UhzxlpJs3_hSFMpnl29tNyu9DI X-Proofpoint-GUID: JDSKf1UhzxlpJs3_hSFMpnl29tNyu9DI Received-SPF: pass client-ip=205.220.165.32; envelope-from=drew.adams@oracle.com; helo=mx0a-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:295088 Archived-At: The doc string doesn't make clear that it adds the variable at the end of the file, and not on the first line (as a cookie). This is important in the case of a variable, such as `lexical-binding', that must be added to the first line. See, for example, this question: https://emacs.stackexchange.com/q/82549/105 The user tried `M-x add-file-local-variable' and didn't understand the error message, especially because point was at bob: user-error: The 'lexical-binding' variable must be set at the start of the = file The Emacs manual, node Specifying File Variables makes everything clear. But please clarify the doc string of `add-file-local-variable'. In GNU Emacs 29.4 (build 2, x86_64-w64-mingw32) of 2024-07-05 built on AVALON Windowing system distributor 'Microsoft Corp.', version 10.0.19045 System Description: Microsoft Windows 10 Pro (v10.0.2009.19045.5011) Configured using: 'configure --with-modules --without-dbus --with-native-compilation=3Daot --without-compress-install --with-sqlite3 --with-tree-sitter CFLAGS=3D-O2' Configured features: ACL GIF GMP GNUTLS HARFBUZZ JPEG JSON LCMS2 LIBXML2 MODULES NATIVE_COMP NOTIFY W32NOTIFY PDUMPER PNG RSVG SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS TREE_SITTER WEBP XPM ZLIB (NATIVE_COMP present but libgccjit not available)