From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#21695: [External] : bug#21695: 25.0.50; Change most occurrences of `setq' in Emacs manual to `customize-set-variable'? Really? Date: Thu, 2 Sep 2021 17:08:01 +0000 Message-ID: References: <97d3ff2c-9e72-4004-88a9-08130ac99a74@default> <838s0fpixr.fsf@gnu.org> 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="26282"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "21695@debbugs.gnu.org" <21695@debbugs.gnu.org>, "hmelman@gmail.com" To: Eli Zaretskii , "rms@gnu.org" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Sep 02 19:09:29 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 1mLqDQ-0006bC-LI for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 02 Sep 2021 19:09:28 +0200 Original-Received: from localhost ([::1]:52392 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mLqDP-00021u-4t for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 02 Sep 2021 13:09:27 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55312) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mLqD0-00021T-9t for bug-gnu-emacs@gnu.org; Thu, 02 Sep 2021 13:09:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:58643) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mLqD0-0007gZ-1v for bug-gnu-emacs@gnu.org; Thu, 02 Sep 2021 13:09:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mLqCz-0006Lu-To for bug-gnu-emacs@gnu.org; Thu, 02 Sep 2021 13:09:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 02 Sep 2021 17:09:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21695 X-GNU-PR-Package: emacs Original-Received: via spool by 21695-submit@debbugs.gnu.org id=B21695.163060248824323 (code B ref 21695); Thu, 02 Sep 2021 17:09:01 +0000 Original-Received: (at 21695) by debbugs.gnu.org; 2 Sep 2021 17:08:08 +0000 Original-Received: from localhost ([127.0.0.1]:41946 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mLqC8-0006KF-DK for submit@debbugs.gnu.org; Thu, 02 Sep 2021 13:08:08 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:19638) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mLqC5-0006K6-O7 for 21695@debbugs.gnu.org; Thu, 02 Sep 2021 13:08:07 -0400 Original-Received: from pps.filterd (m0246617.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 182GxisX012285; Thu, 2 Sep 2021 17:08:05 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=11zQcSm7y+1H1LS3dok0K+/eI1zYKKf+zs3vOmRdrGY=; b=JsPt3hgi0gHiWYNFsU0gaQ+giJxGUBy1onpQ5FoEPbg7VrW+5xbF6gucbeYdSeOwK7bJ fQI4lotMz0O7pL+1LDQGxJ9ELfeG97z+PH6W6Hhe8rN6Yv9NmCeKes6+jWAvZNX3ccV3 GXtU9MvCbhi4ZvWox4Mm43wAc1aq3giN3QXuqQslTMXqxA0exQWt6gt9oIKDqpGm6CNs ZL9AW+RsJSOEO9utoKwpZQnGlm0qNMqRcNbVcHHkleQj/WB8NdGddNNyZWm4C5qrMTZm yRhxlEXdILChjs/CW8+Wu65ZQGUloi5OA2mY5EqmxFlEOPfQwYKnOOg+OwrLzfit48U+ dw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2020-01-29; bh=11zQcSm7y+1H1LS3dok0K+/eI1zYKKf+zs3vOmRdrGY=; b=VsTX3pfNM0JNY4k08s9n5hh8X21LcLD9tMlz9F5cq+IlGVjKpow/l5xRRj1VI0G9IMIF 3rr9JstnPETFSn+VZYgCKY21dXhC78Uj/ZYwCXcEYtYCuQdjg75Avfx6Em25tvPhkqrl AQTSCgMLO2kZsRO2MRWHBrY8/gd5IOmIMViA7R3wt+dgenES4vC7Z8kkIR9kJXh1QlFk 3G1Jir/hRKigc38TnUJ65GMQKu4O/SL196ss3lm1xKkoAM1diBVZvZwh8ntqTfxqwRAg jAuzqlx2Jky/jk3/PIR5mDVKIJcZO2iD+wdFLavx13f2KIK/E2sM5MbA3ULC7euEr0hN ow== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by mx0b-00069f02.pphosted.com with ESMTP id 3atdvykp4g-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 02 Sep 2021 17:08:05 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 182GxwxS089095; Thu, 2 Sep 2021 17:08:03 GMT Original-Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2105.outbound.protection.outlook.com [104.47.58.105]) by userp3020.oracle.com with ESMTP id 3ate0061r2-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 02 Sep 2021 17:08:03 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=PLCFWjZ4jmCGDplK9W7Y9iz6o/S22Kc+rMCWVzXE74o5b0C/38TRASFXjfaC45QIgdznjr4flQcL/OjW5VNoIP5xlDidYsMLBSCuTxh6aXK0wt4SI/NZo+LKieVGqlk4WDpHCgall8Buoq3eLy7VoBbgsEDfRUI9TXfqnrnauDcpRWnDeqtYG1BwYk61r0MrZLWB1SFhhWAk3znCT/bulNKR0W4nAVWADjiRPD43vJIFI7PlC0u8CauXy2h5Uhq7L33+8ZhwyaKy0+TonTc7bZoj04Nf+Mcf9O3y6apJzVerttESoj9xCaeFxQnE535O50uk4fJtWBU2iEIb2WPEMw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=11zQcSm7y+1H1LS3dok0K+/eI1zYKKf+zs3vOmRdrGY=; b=RHmkX+4d988yLCX+w1t8dZ3LHRgJeopf882a5o4AG4sElkPLQVQD1HqjHygnZMOypBSCxL2nleDy5JR48HDlYgd24Olx0dqeakmQl/loGficgiIDhZFLbyNtbu8CayRw6SrZCB/T+L0rysQ9YXWtBSpn4d1QOrmkP7NaUrz6rSvvzFUd2WDtaS8jvzItbplDhfC2RZUm37U5v4Fn1FS1NVKPUu1YaOgVJ4YYGWXSTVGEDXfkfsLZYml0PiegvrvqjE27rukdo3dGOKh08Eu1EprGu7A1df25T831NzUmjon569XoqJUxepa4ip5DvVr4HfA4CuEasoBo/Lvpf7wOVw== 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=11zQcSm7y+1H1LS3dok0K+/eI1zYKKf+zs3vOmRdrGY=; b=eXACzDx6+tzoHLpXHMpyaT1DZI10LpjVZGqyjyG/DjFgVmg4S7OlmETJhkWrD4rXqK7xrsO6IOwRH4BFL22BSfKlBhH8nPx0fL5XmL1V50ch9LenUL8GtEBcRS4TAEdvpK8WtnQintSsQSIvEcNdZRNj2BNnguzjUCbb/hNrE1I= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by SJ0PR10MB5565.namprd10.prod.outlook.com (2603:10b6:a03:3d8::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4478.21; Thu, 2 Sep 2021 17:08:02 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::c0bc:7c3a:292f:8a82]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::c0bc:7c3a:292f:8a82%8]) with mapi id 15.20.4478.022; Thu, 2 Sep 2021 17:08:01 +0000 Thread-Topic: [External] : bug#21695: 25.0.50; Change most occurrences of `setq' in Emacs manual to `customize-set-variable'? Really? Thread-Index: AQHXoB0Vpa2ta2OHyEim9YmkTNXzQQ== In-Reply-To: <838s0fpixr.fsf@gnu.org> Accept-Language: en-US Content-Language: en-US authentication-results: gnu.org; dkim=none (message not signed) header.d=none;gnu.org; dmarc=none action=none header.from=oracle.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 5d4691d5-26ee-4187-eec1-08d96e3438c6 x-ms-traffictypediagnostic: SJ0PR10MB5565: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:10000; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 2GBYfTLSDYrfzKlAXwZ8N5dDvlWtJnWMtexdX0FROUpLhVw6izgqpxlo4E7ZpNgNztRx6PZ1SP0PTWZUV+wMDK2xsr1l90PFGRgwoAFIjWJXKjVpTo8RbRXqsnQllG6X1u/ehX+aQnRiGglbtqo6GvvkgUb+BtsWxZa9perXzreRfCUbkCtfJ/nDW5JU2BT3VyL89gPhotk8nH/h5JA5OnApfm0vTE+1YgSkp0o2T+vlhmKYcyvUqdqHP4bT1Wf19cAJ+YVhSchG6RA7JScd7ndvmRTmic1whkrwf7HEWVwCKREH6fEWk0VVVwDObopwfVh6H3ItjYFrEXxIV3b+OXnh3Qgx+cdQaOWIjoNVlGs7oDzZdYUKCvK+1Z8vn/Sy105PVbeF28eAWG+FXz6TApCHbXMgRhg7ZjuWR8oI2EwPJBby+JocfDQyvSl8YLSiGZID+tkaZbLPpoWfQdz6emJwLDWIPs/FKCrVCvP80J0T5klc4aRgV1wpAhn7ztoMZ475a3hoYmgnS3oxtls1XMLcsqzUfRaOk55hIQu3cTnLXHukNNiz3FR9ZIaQT050aqHFK8rdxs3SGWDpJ3RVGkPnfNX+qRA/EovA2QRg2eLvkqdE3E1L8J3vE8FfkvV6/oW1fYZU1vhNS1Stsj1ehDpGGY3BaN+W2Adf/sAOl5c/9vuYbWerVCN16/YAWFRO41OBK2Wl5tfPrPxnp+nvGsBAI94b6oG4qHCuSMPXH70= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(39860400002)(136003)(366004)(376002)(346002)(396003)(55016002)(8676002)(44832011)(8936002)(4326008)(86362001)(316002)(9686003)(52536014)(5660300002)(478600001)(71200400001)(110136005)(54906003)(38070700005)(38100700002)(26005)(186003)(2906002)(122000001)(7696005)(33656002)(76116006)(66556008)(6506007)(64756008)(66476007)(66946007)(66446008)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: pJ4l4C/JexAHlxOKPLk8nLRmJ244agH6ZKFDhpM2l6Qea6MbW628QCkpq/O+2yYePQCcg7X0aSE+TLaskJHVH1Sv/L1ipz2mlGjJp/xjAUozp/SKwLNI4mcca4G24GEVONJB71whrNrqpvvGZ7O6CwUUdv3tHFZHLzajq9MAjx9d/wUY8Hb+GSW7VXOqmY95FWWSZsz/0esnog3owyDcf4jBRNqcenJiIzvHQ2oXFdMW+Jc6lnA2KYS3IV8NR0F0BwDRoYdeqgOIJ3N5kKGMj8VFhIjYgd1Kwf9/io6qGpf1GevJmvYY1z52OTu7pVHpWmYkMnrAgwZvs6yrGamgHeNc98a5Gz5HHFwfxUVmwvxIf/Z3n9Hrdg2arx9npmQDjJxoErkzXg+ShoStBaae14d2KubWpyKJrNELzs7ayBUk/M9TS6MXOQ3g5qoLx3J7r4fxGDEKcMQjKmCn8gRRaiKgPFpw90JmfvqFs6fK+gFX6nQN/KzAeYgE5sHvCuQoH4yYIdDFH6sEXsYytthiMPz2vDk4vWt7VaiN8cHS32ao9lrNxkiNeq4+bU1O/otjrGH0fmJyaijtDxPSYMnJZ5pyQqxZJlF0owAdGCvmorD+NSR0VwKLfyKz9DVcNiIqWpc0Fj20dTDH0DewyPth/WnQoLN8fbyItP04UvbxQeiaL8V0QQb2x2Ie+z9do1cLGsQwkwVLFijHIljfLx3jIV2tuxHMeUu5n+bHHSBEse0OnIEVvy53Gj1r8b Au+thm/AvPQrHa9LNz2at3cmYLhH9ryAY3yFvluwilBuMk3pcxATfPOjRiDg7UQhSMRVMPqPMZwHvH7E3LBxe0XTtQ1l9R6s/r x-ms-exchange-transport-forked: True X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 5d4691d5-26ee-4187-eec1-08d96e3438c6 X-MS-Exchange-CrossTenant-originalarrivaltime: 02 Sep 2021 17:08:01.8655 (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: Ez1av5VZyRpKMecwXJchhxsEWKZ66D1OgzqOXrEV0LNEHpeI/7u8VuNfvnkOgB50ezAFm0XuY2Vt2kQRvZ/oRQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR10MB5565 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10095 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 bulkscore=0 mlxlogscore=999 mlxscore=0 suspectscore=0 spamscore=0 phishscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2108310000 definitions=main-2109020099 X-Proofpoint-GUID: hBez5MYD_CvmQsTvaESOaHC7f94fndc- X-Proofpoint-ORIG-GUID: hBez5MYD_CvmQsTvaESOaHC7f94fndc- 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:213293 Archived-At: > > Telling people to use customize-set-variable for all 8000 of them > > feels like the tail wagging the dog. >=20 > Yes. But I don't see why the numbers matter here. I agree. > An option which cannot be usefully change via setq > mentions that in its doc string (or at least it > should; if it doesn't, that's a documentation bug), Yes, but what about 3rd-party code that doesn't bother saying that in doc strings? Sure, it's wrong; but does that recommendation solve the problem? > so all we need to say in the manual is that such > options exist, and they announce the need to use > customize-set-variable in their doc string by > such-and-such text. Then the users will have > enough information to figure out which variable > needs what method. See above, about 3rd-party code. And that approach requires users to be on the lookout for this. That's a bit like not having stop signs and just telling people to always look both ways before going through an intersection. Sure, they've been warned. But they then need to check every intersection, even if there are few cars on the crossroads. And it's little comfort after an incident to be say "Told you to watch out." > > I have a feeling that most of those 462 with :set actually require > > that people use customize-set-variable to set them in the init file. > > I suspect that, for most of them, :set is meant to handle the case > > where you change the setting once the feature is already in use. >=20 > That's an orthogonal issue, I think. The issue at hand is how to > prevent users from mistakenly using setq where doing that is > insufficient. We could independently see to it that the number of > options that actually need this is kept at a minimum. Agreed.