From unknown Fri Sep 05 11:01:06 2025 X-Loop: help-debbugs@gnu.org Subject: bug#78062: 30.1; Doc string of `add-function' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 25 Apr 2025 16:44:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 78062 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 78062@debbugs.gnu.org X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Received: via spool by submit@debbugs.gnu.org id=B.174559942122151 (code B ref -1); Fri, 25 Apr 2025 16:44:02 +0000 Received: (at submit) by debbugs.gnu.org; 25 Apr 2025 16:43:41 +0000 Received: from localhost ([127.0.0.1]:52090 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u8M9M-0005lC-FR for submit@debbugs.gnu.org; Fri, 25 Apr 2025 12:43:41 -0400 Received: from lists.gnu.org ([2001:470:142::17]:40562) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u8M9K-0005kp-07 for submit@debbugs.gnu.org; Fri, 25 Apr 2025 12:43:38 -0400 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 1u8M9E-0002Ai-7U for bug-gnu-emacs@gnu.org; Fri, 25 Apr 2025 12:43:32 -0400 Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1u8M9C-00061m-K3 for bug-gnu-emacs@gnu.org; Fri, 25 Apr 2025 12:43:31 -0400 Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 53PFqVux008392 for ; Fri, 25 Apr 2025 16:43:29 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=LrNhDoOzmUl6jrul 9PKIQ+8mJfdYDflnEiUnE+jD4PM=; b=GKD9qZk2mX58QIVNjfyK+cwRnk7dvSnT Zi7pAZ2iuP5kzlISoo5AWoB6lHMMqRKPLDb09lkbd+L6Ot7xvqzvkfKXlTJ7Xlxi cWpAzAm5ixqNTPjTu093+plam+q1d8cuKvUDDZKw366hr0W6lO2/AnkLpsNtrbY7 bgksLlQIZUsajteGoZH5MoYiBGtSmTA/dy26ikYg6jLJA/H2tbYt1k6ccJXYirGc HtiRTj54LUyJvM/oxjupvUb73D8GsHeCIflLXJDulDtqaZtN8KX0RqMtdis8L5yv wV4Z293Av/kJzpFTndacF9WePD6/ID/fLoqYxqTy6/vZd5z3zQmHsw== Received: from iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta03.appoci.oracle.com [130.35.103.27]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 468d45r96k-10 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 25 Apr 2025 16:43:29 +0000 (GMT) Received: from pps.filterd (iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (8.18.1.2/8.18.1.2) with ESMTP id 53PFmUA0017375 for ; Fri, 25 Apr 2025 16:27:14 GMT Received: from nam11-bn8-obe.outbound.protection.outlook.com (mail-bn8nam11lp2176.outbound.protection.outlook.com [104.47.58.176]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 466jvj3sb2-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 25 Apr 2025 16:27:14 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=L2u+T/inKcr8WUMyAFUJ5rMztukNDb6pYYVi2HJpI+60spOSSkct/1TlY5sdYjzeA4LJK2nPsa44dhMeC9Ofn7B9rYGtTBWVkzBI9sUVYtE6CMzWbUw+XXhqokO6fR3aIZC3ZMtfQT2G1JqgC/3AuGsMhkH5ladXXm+bCnBQCeNU6xZHX2yT6DXajf7fjWOWVI3H+hj0jaEYnvYGJiTG+PQTW+HlhNjm8fBzwrImwQHTPCkOuHrzOd6umYXEgcv58dBllXaVXFj/TWf0D0nXJUQyIRwO5bZhFuFe4trgis97sU/vNFlRV4Vu0RJFX2EvPts8LbhFcxBuebhVSPSvsA== 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=LrNhDoOzmUl6jrul9PKIQ+8mJfdYDflnEiUnE+jD4PM=; b=QmDqLKGR0yKr7sqhCNELHA7gDwwe0zK8kzXHJPFCA6+lJ5f4uZ+tE0oUpew6+C/zXyXUjhI0cts7uf55Ckx2nceab08ins2iLlyGaScZDtyEIOaqOfU4dPe4s+VMmDzf7iTjbzawq2fhyY03vi/+TK8jpwu8m4RquRALMUpbCB7Cr9KhowipGUeodrQ5p30ef7Mkzd2oALCDISH6MDQkAmM9v5J4R+oejSNz2v7rqEwE1BkUm9vejfpqO30IiUVG4HxZwTuJOnuNthq+5W8kevqeyo9fenE8jaYF0WCJOznOqPlV9f6Z6onCC/rOQvTxJyqBkW+sL1JUrLki7aKUPQ== 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=LrNhDoOzmUl6jrul9PKIQ+8mJfdYDflnEiUnE+jD4PM=; b=mtmpWN33F3mhu2fArNqgMyA3DeNJbCnoU+/m9bKlSMKxGBx7o/F3ikDWU3qpmSSIhT1DJjwL/rTzu8a3qAJyrppFUdrpSwQpOwzCAv5WllVKC+f1GfnCps9q0pp1vVp2W1vWfZ1mVu5tiCAV9l6Y2WNVkFf2dRP9Ngh7pYLswsY= Received: from DS7PR10MB5232.namprd10.prod.outlook.com (2603:10b6:5:3aa::24) by DS7PR10MB4864.namprd10.prod.outlook.com (2603:10b6:5:3a2::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8678.27; Fri, 25 Apr 2025 16:27:11 +0000 Received: from DS7PR10MB5232.namprd10.prod.outlook.com ([fe80::8303:658f:14f8:2324]) by DS7PR10MB5232.namprd10.prod.outlook.com ([fe80::8303:658f:14f8:2324%5]) with mapi id 15.20.8655.031; Fri, 25 Apr 2025 16:27:11 +0000 From: Drew Adams Thread-Topic: 30.1; Doc string of `add-function' Thread-Index: Adu1/spBy3+T2YcQTP+VClh8PZAWYQ== Date: Fri, 25 Apr 2025 16:27:11 +0000 Message-ID: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-traffictypediagnostic: DS7PR10MB5232:EE_|DS7PR10MB4864:EE_ x-ms-office365-filtering-correlation-id: b859d765-f5a7-4736-2bf0-08dd8416083b x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; ARA:13230040|366016|376014|1800799024|38070700018; x-microsoft-antispam-message-info: 7sTnmgY0ICezF1K+snvgENYgqO/iZd8yVEcGWEUsp5IHOjrPlQAXBsxsmcNvldx0j83wbtdvWGkSNc9FlPsGBXLCaBCgoCsEcznIQVyYV6izev7QCMCtuzivGD6Zfi9Y0qfNfb+CgW9WimxIOR0hPSvqJAcYrUbZQRLhqQaDTOIBQzIIJwfzYWMQljsKKe8G+DHKQbfCQdU2UTmlueO85g84oyv9Bbd2OeLdxCjGiLyuWwWNCjjzmsqSlJcrxF6ZGUX0snxdH9YrmydB3AXQuICiKXUfZj9xQTYu4FMTxBEmhgYXQ7oq6jqlnQ/KXLd8JM+7R2MOOgmetzA8BCehi1iuFfuX33UbTf6N/l6fvLNHXP1S6+V6WNrltQvzOxBgYnwHesi9YygXcddPdDN7uqOO3ciUS8JjEhLZKsv9gtvPtirR5U+7o94FSa14kHtks5EogedHcy1YnNISG5c+2zVk3ZmsjdpZOCAcLdyGfq/UP078GGaLnLT+S/wc53Kg67kIZajrhLj6mOd1Nt9BBISXfl8O2wL4w/1lv2uIVNWRXi4jAtQJv5mbplq4RWQMLCzO733FKxS6g5NKpjWoa8YL6aJy8aCrv2wR0XlMf2LLvKXEdmjrUxPm4Ksb6iszZYNKgJ0nrZjoSIYyqV7mSxoW2TSnWp2GH1YyChntGuY/3n/qPopiAzf+/TxMeYchU+/tMc/YIXm8Uzqyu/7zZCis/7prWzlHNRbqR9mAe2KqLoQ1PKqGPToJ+/U3lHu5voR6QjjXCF7zmPFVGAnhhp04u1nrRxjK+xriMxwGVtYhYarBrpqiRdPhOITLb7884BclGz0/kx0PNSfpyIunNI0TcHENI0ZcPGqQFlA3wEQCMTPbhOsWlV7E0cUhNzowNFigXq5pZc8JxZ8lnmmsUVuw6QpduWytuZuuczCUDEp3XSnSGnItgosZZs+r//4m5i0GbXqMl2kK3pxY9lV2uRxbFTV/DgKoeL2IYiKtpl+R3fbe5oWCX2NPWxKrRT69Tcu72Ng9HxMS69T480u3njKyEnMyOiG4bItsKb2WN9edSWU2I52NmPz0g4RIeyA+oXGtlFAx0j/f1drimOiZ9FLWjj/LKWp1XSAOlBF/U35CgOGRrjK06E0tEkmdbdAACd/LX11QKazRz0vAMRY3MnTHj5AxBbJMfcFcXq+1iwJh1yPokbAjLAbpD1+EGLt+cCrzhY5mbIKyc1quJyFcWusPhKjPxvf6UPH+97P2kzyCQkbRhmzkYoxUE8lNNdhr6XAkYJzJN/6WI0OzCVyOBDwzEjlpXKz4sRQn5FVFumjf8yDVGqAkZkxhM2jQE/kxI3Y9VnuyWlsv1DvAjSc0+c1F0VFndK06enDKl6tkzNQauIWQ2LAfnzrfvzO6K0gIXLoiHvsVMU3aqqZf7/5r4Go8JEmeixUrlWJX27+456gpSYdVzU+g5Y3hAoPY6KQ5622PJfGmRkcaoK7OjaxZFg== 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)(366016)(376014)(1800799024)(38070700018); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: Py6BMjw48NpkJS8s5Xv5AHUKOfhDvxZfdkRPEDa/mvsxdJzyE8ON4AqgCnVQZCa/sr+HnowYpUFkzDwGWBw2NW1HV+FXoK/wp2DLiFsJ0yUeTCHatmxzjeGuSulhmQwib7olYlyLtruOzSUfkpQ30eA2ys4bj5tH+kjaP+YoJVmIUuipsTn3ZAM1Po04QPSe7eY+7N36CcF2hHwkExf7+Gn8Tcn9orOsNVeSBxyTd5Ea2+JAn26ok/AA6Q9oRzkYrRvT0shGlqJG96XqABFntRVDR6ctcEbITO0MQapsdUD6wRIVSf03AKM67E4rdpE/TFr/9EOTmv3aR/ketW1z60Yo9rPt63PdIrRQ1CDF3Hvzw7zEZGax9RTcgtpQXF7zeLzdjw/dC/P5AkSwrp3jfFpuY902uJSb7Ymnnmbq6UTHdocy4NGRA2se/2c8tZUe1zH+FLqWfaPTo2vB7bb7s3725Jldo/NDufzhalZcDpSxOWrVWl4h9a5CeIOiTCE/t7mHBiGwo1NiBBH5+2dDPeY//LwLfb88qd8w510+ce+xu4bEBiHuwN5UVbEI9YMVsB9zRAQ4BvsqrxQX8kBvIxOI9IgIyGYb3F42OCqMCcTicia48v1ISl/jcwFr3h5dm0HeGZrPHyykCAfWZXQtf7l4f7JGZWqhj+CZIJJTJD1Qz9am6M66+1XTHWDCGd4PPD8GRudC/tKucliVXqfREFZL4GvZ/N7jsSWpTZm+35uJZvrEkYh8ZeaJF3JkbYGBEnqoJABjD8Wlmizi5GHs6VapurVjAPaXhe1M5ZSE7l8huX8FjIQ4Nyuq/KkYFY5IDj9Skj64ABMG7kmf8EgLaWNXEsjgkylAqZZYITS9yjYpH0brnI7uQyzHOvsJlTCUNWYPRlWJ99kiZKSRxEADNkgdrxOOX5F4hFVzxxr9qa5tWpejXgAFAZTuUno/9l0ICLd8NywalbrE5ysMjmI8UuKSGvrPK6Blti0dkYPHZ2usIt72G41UhQtc1AHRwjYqti5YzlK1vr1SeQZsvD+0wPwt4WHZ1HAgUZroQO9npbyN1HgnDLCz22xTLAExZNiRAy8ft0MwFhPfS3zVW0sEmwK/4DHNkqCaXBVnhqdicdsBG6CuPYyV/FPHAnG2djmyKn+i22PZe9Pcbox/nE7CtDzqM6h7uoIlpbJTXkNm1xWUrtzNf96rxzXgENyfXHRIUlgKVHG9KCJ+KxCxVyi2q5UTojuYpbpLlD6aiS2KzBO4uE5pHLK1DQPwewefEHJBE+sly7MfTEcLOlKM0cmYLXcfvQqSj/nyCEymGoYynFtP/FGetGZPTj3IV5Z+B6CYtMVJm6XiTshrnSgMIiPqZ2AnYkiGjg4NafMaHMHb6h+Ob/mOeqL0S5TmhG8qWer/v5eDQ4UKp0ztGqM+m4BnTvTXquUwXcsAOYAnsyoFhx45+ifRA0HES1R5BznQdMo3cdMiyles+hVONYccPcVyq6zqrJ0R/kpErG2aVXUfrqKJeJjFG08HZcKKQFQ9QGV6B1pza/AmvOOd/FDYe/H3/db2lvbucRMl6QOMx2XFboH2r70g8JR98xZBtq2dHSbB Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: 4wZQO2j3IM2OD7i1eUGmM3HPoJDx8dmIs4JGwIO/0Eohbs98jiIBP45TJv99kN0N13BgvRaoh/kcQElFC6O3/yXL1ugWEvHMIIs6tN9nz6U1YdlSIiop8dK6rUNGrd3mnLsqZB7yC8wg2NeQ3GSJWYDFJlegZvZOqIZix5XJPlHBNi3uowcFYMZd5SSkMInguS2brIOxRv09VFEoH/P9KNuDoIYk+l1K6MHdIW237cVDQuogoJVl3QHmQre+nVeAyKmTng/sFKxBpv2KoR9m6oSR113v8Rf5INEh1ZF3+y/+GPx/aP2g94YYgASrpyDQi6jAywaCIqyhJjHfU/+l61MvEKdgbJd4ElSR8oV7I0L/KuDIU++G/w7Ps5WhS2l8KAPFs9sFSFEhd0AiPMAE3NaXFj2w5bUG+d8iYuFNV1ZBgB28Ra28c2NiCrV7UL6Jlsnrn+tGGd5l5a0vgHS5u0mCRcNliL/ltF3mGMzHWzkdzPzKuqyRV1e754mdW7BDrUoPMfZxONNH3AcO6ThGIusF5kLHahGEM8bgPlAum6jnha6TcTBpGKvpfn6heDoJoz7geibkhWdVQp+22zG/pekaEf5dVg4XTDPjvP0T1/k= 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: b859d765-f5a7-4736-2bf0-08dd8416083b X-MS-Exchange-CrossTenant-originalarrivaltime: 25 Apr 2025 16:27:11.8196 (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: 4yiCNjFmP1Eg+0hdQAMx8+h89gFVElTuGyrhvnm/xAnRKXuwQh+zuOEqHRkCFAeos/3xkW+Sgl3ZUfYqAd66NQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS7PR10MB4864 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.0.736,FMLib:17.12.80.40 definitions=2025-04-25_04,2025-04-24_02,2025-02-21_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 malwarescore=0 mlxlogscore=880 adultscore=0 spamscore=0 suspectscore=0 bulkscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2504070000 definitions=main-2504250116 X-Proofpoint-GUID: gDdGbUPYlxzvweTrjMyr5mUOWH6I6jYZ X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNDI1MDExOCBTYWx0ZWRfXyfyqIu7gFh7l 26OgbYwEsuEU9CCGnaWb4E+W1AqdHUnUl3AXn4bc9lyHy6nir4VX/e41/10KxWxM0TeAD7FH9gy P61YKAMGZWdU4MWPH0w6F1LHo5gIx3kAhwj3t3naDMLooYR/rov3FwdKd99mEMVAhFITNEHnkj8 FJ8ud8saInjv4Eybx3/h5FVjU7G6GOM/GcGd9P5puNr2FbGgfahAcwpG6QPr49pQMSr8WWWGsL+ BhTLuwdCfo1FfzokyQ9pL3UqaiD9e2DK8fdr1TgyIa1ZbDnOk9fK1pMHHGoVAkfld8SMR6wrPrn DfFrY7kfkXxaeKhaI3LhIV+c77dLJsXE6uWvs/QrIoe1Di4qDThucS6IquEMBBoF7nseWFn93xg 6XO58XVr X-Proofpoint-ORIG-GUID: gDdGbUPYlxzvweTrjMyr5mUOWH6I6jYZ Received-SPF: pass client-ip=205.220.177.32; envelope-from=drew.adams@oracle.com; helo=mx0b-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_H5=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-Spam-Score: 1.0 (+) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) The doc should make more clear what PLACE can be. It should say that SYMBOL is a variable whose value is a function. That's missing, so far. (The Elisp manual even mentions that the variable name usually ends in `-function', which is helpful.) (The doc string could, like the manual, say that more generally it can be a generalized variable.) VAR should be spelled out as VARIABLE, as the manual does; as it is now it's not clear. (Better might be to call it LEX-VAR and make clear that it's a lexically bound variable.) In GNU Emacs 30.1 (build 2, x86_64-w64-mingw32) of 2025-02-23 built on AVALON Windowing system distributor 'Microsoft Corp.', version 10.0.26100 System Description: Microsoft Windows 10 Pro (v10.0.2009.26100.3775) Configured using: 'configure --with-modules --without-dbus --with-native-compilation=3Daot --without-compress-install --with-tree-sitter CFLAGS=3D-O2 prefix=3D/g/rel/install/emacs-30.1' Configured features: ACL GIF GMP GNUTLS HARFBUZZ JPEG 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)