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#50248: [External] : bug#50248: [DOC] Setting User Options in Init File Date: Sun, 29 Aug 2021 22:57:05 +0000 Message-ID: References: <87o89gbwrr.fsf@laposte.net> <874kb8f3lh.fsf@gnus.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="16169"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "21695@debbugs.gnu.org" <21695@debbugs.gnu.org>, "50248@debbugs.gnu.org" <50248@debbugs.gnu.org> To: Lars Ingebrigtsen , Kevin Vigouroux Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Aug 30 00:58:27 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 1mKTkx-000408-5h for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 30 Aug 2021 00:58:27 +0200 Original-Received: from localhost ([::1]:48766 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mKTkv-0005RR-TF for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 29 Aug 2021 18:58:25 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52130) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mKTkZ-0005RC-GF for bug-gnu-emacs@gnu.org; Sun, 29 Aug 2021 18:58:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46163) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mKTkZ-0004jt-89 for bug-gnu-emacs@gnu.org; Sun, 29 Aug 2021 18:58:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mKTkZ-00029a-5d for bug-gnu-emacs@gnu.org; Sun, 29 Aug 2021 18:58:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 29 Aug 2021 22:58:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50248 X-GNU-PR-Package: emacs Original-Received: via spool by 50248-submit@debbugs.gnu.org id=B50248.16302778308177 (code B ref 50248); Sun, 29 Aug 2021 22:58:03 +0000 Original-Received: (at 50248) by debbugs.gnu.org; 29 Aug 2021 22:57:10 +0000 Original-Received: from localhost ([127.0.0.1]:57701 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mKTjh-00027o-S4 for submit@debbugs.gnu.org; Sun, 29 Aug 2021 18:57:10 -0400 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:38246) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mKTjg-00027d-4T; Sun, 29 Aug 2021 18:57:08 -0400 Original-Received: from pps.filterd (m0246632.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 17TERvtE015301; Sun, 29 Aug 2021 22:57:07 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=3dE5NpLTBB3My0wn+kA0do1mPzzdVoRs+kfDF6xH34U=; b=Ct9xYIXOTamWIUgm61Bvaue1EwdoLvCoX9kbG09DsP9Y1Lm35c7mtS2MydZCc469iV6N A02mSZM4BOSOGrW+dUltQlnyxa3NTaFvW6aAmcx2HAMspK/XXHv6XEVc4eCcaFt7v/XO TJ0TnTDtX+IkKKUrQpmtmqK8168Bevg0bh2ZjMv8CRWQCK8g10DzXmY7N7sw1ePLXhPk FJLLp5sFU5bEhFiXLRVRyLyICCiGJbbWHfie6q2JIQOWDYQbyQ23NVflv70VNOAxf3b5 fgGTWw0lH1MyS0RDTZUbYsJTUcHTFtf2knfpob662yBkIAXo71loWrGmNyTwX5Jj0ziV sA== 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=3dE5NpLTBB3My0wn+kA0do1mPzzdVoRs+kfDF6xH34U=; b=BtOiSMZ1hdLr79H8LnMJQ1zlaOUMYQ6WMMeCEeeqH4kEExKVUX1+KDP0bb8Eh4Lt1sar x9jlU2WTT9GVoa3Bkbe0XxLmJAjkwf9XFSeK3fbTd58s7Q9eU3t3eJbcQ0AR2bRYlIEW FsmzlTEBqhaKrmGR9iQPOGTf66mwvyRLvF3rS/tdRwuKP0V9qHf53RVj2wqun4g7zUl6 DR0uzyKqPOK/SzKXrP1PkvCIiGf/mUxDcwcvbOKpUh4p/wLVLHHxUz/CNhh9DTirDDS0 jAXdujmrKd2F6mj9obPJGLlnHucShknhoP3FJZFAcYzPvsxnPZMNeli5QMdApXnqRJ1M jg== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by mx0b-00069f02.pphosted.com with ESMTP id 3arc1a08kx-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 29 Aug 2021 22:57:07 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 17TMtrXx123411; Sun, 29 Aug 2021 22:57:06 GMT Original-Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2169.outbound.protection.outlook.com [104.47.55.169]) by aserp3030.oracle.com with ESMTP id 3aqb6ayur5-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 29 Aug 2021 22:57:06 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=QPztxnPQX8qqkSl8nN3T3DTKBXUhRDmqkKoDk0/kgInpn7q3YkB62Y9M9yqEv5Ft79auh1ZWEt2o11zeXaKjLXKZZQf8iN2La9xyyMCXzhQ0VbcwujWq1YrGjX8KqhHfOXK6dDzY1T6mZm347R/pR6WkCsdX0mgB1cZ7XRdbwV1Bv6I1xHho2Vw5bvvekAbST1YqX0l/+Z/TeQ6TNAz4B2xxhOSFhAQxUNR9VY7tMzDbv5xDrUfCwXNFu3W8sNLWbXKS7dUZawK5YR32ckVVHKeIQxvC7GgZsoLSHaSflrese0+lG2YWwUnkLLpfrzqwN87IxuiWiiGwpdBnzSMvQg== 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:X-MS-Exchange-SenderADCheck; bh=3dE5NpLTBB3My0wn+kA0do1mPzzdVoRs+kfDF6xH34U=; b=Fauu886eLTu4+c3mCDjp3aHuLDhEgT3SKd+WZYyo4RczzNlsYD92ajViubcmiyOC0iMe8Lq9vZ/UERQi64zBSlF8OvecF4MHL/70YjKKV8Tirfz+me9twt6CMUrAYUr9p8QNMA30/b3t5WwRlqPik9K1G4CU78AggIn2C/t0/1zgTTJBfoqZz1cruy4wNwYkMwJY55igXWCPF+u+yF9WciwWIjezs6cK42metgR3yX6k3Cdt6DpsE+uQVJlIyr3RYBPc7gKuMAFQXKpGp1lo+DIf165/IjFp0hjh0E0md6+7RIBCg2hTQWu5zPttirJ23uGJ0DOpPwUOY+YJIqn+Sw== 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=3dE5NpLTBB3My0wn+kA0do1mPzzdVoRs+kfDF6xH34U=; b=j0rEZ38wI8aoEVDdPmVA8T+XQlMJ+5ny5kBxxuDnjf0wpsls8RMazxtce4vJyRthWXrMmb65w6AoLu66sNr+yw6BaN9+0rNBadrfGnEPBBpL1IGY2HZrf84+TKvfaaeXg0ApwNU8j/LdSSgrHgGQcoVLVFW4sgaUTJDxI+jcCa8= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by SJ0PR10MB4653.namprd10.prod.outlook.com (2603:10b6:a03:2d7::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4457.20; Sun, 29 Aug 2021 22:57:05 +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%7]) with mapi id 15.20.4457.024; Sun, 29 Aug 2021 22:57:05 +0000 Thread-Topic: [External] : bug#50248: [DOC] Setting User Options in Init File Thread-Index: AQHXnQzXNemtfaGuUkec7R7RLAwILauLBT5A In-Reply-To: <874kb8f3lh.fsf@gnus.org> Accept-Language: en-US Content-Language: en-US authentication-results: gnus.org; dkim=none (message not signed) header.d=none;gnus.org; dmarc=none action=none header.from=oracle.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 7318cb40-1a33-4771-135a-08d96b405242 x-ms-traffictypediagnostic: SJ0PR10MB4653: 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: f9ZDb9KuDZuaCSWCO0keIZujtgHCpGXJprcXSZyVMB9Sbtgi4oWsxPT00wLOIzvwuknJamurAd0jFS9gAEc3kSlXsHnHQFLkOf5A8V7ptPKf+lm9a3f0mD0XQCliA79kcBAVyw3YWF7qJWoAHqEcif2FgzU+P60zOKNtLIl7Zfi30HTg/hJrMK8S+ekbjHToEjh3L/8e7RXxjghlq0DMAf2AIrfIoZXB+uN1Zs27LV7S/bSLjPtomDHb3000gK6dKoRisCNAKkl2oqrHuXDewUlIz9PZ7pC1WfeRXslfO3vlaSTKATlay/29VD/+OrsYf0JcGF2AtivUsY3helQGO63l15dEc+/3EAekkRGuhws+vwuelIymZZId/YpphK6fqptNtZv8vbkpYnaehQj8TC7+mIR/AoMf/WE6scUpu71NlWq4v3Icxx+Petisq78wX572gNce+jJrq0zaY3g7xxa1VSi1zR9aJxPxuK11UWTjDMYUQatvpudDscsGbVuICCsSEY+/AbeSjFp21ZlKGpy5GmekubT5KPWUL6x0AwwAgKh1gAY7ZXcgMfVpld8K5V24rBHE2+Q/Hx1n9G23anB4AoZMNjIhBV83uTEupm1UDJv7GknzGsUj92TIlwClXKqcxvNEG0uZA6vkJwgVMlLbVvQjaXDNcAclYa37bKNIkazJG9JZHfc/GhSdGJ3Wpu3mJ/mOI+JHXmNrU+/xmA== 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:(366004)(52536014)(54906003)(7696005)(6506007)(5660300002)(44832011)(110136005)(83380400001)(33656002)(38070700005)(316002)(26005)(55016002)(122000001)(9686003)(8936002)(71200400001)(66476007)(66556008)(64756008)(8676002)(186003)(508600001)(4326008)(66446008)(66946007)(86362001)(38100700002)(76116006)(2906002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: hDi36IxgL/suuM1r0TMLvT7n1MN5o/nBZ7kGCOQh+aAZjgv9UZZGSiePr+uNJCntlNprbhJBkZ5Nvz0IgdHp2f9HP6YE7URhwjEEgJi2f8PqkJMT5mhKpsaPthCoJ0EkerHY4ntihxmpkTTAFt8k/mtxpBddaP+bb6Vs7Qzxkbj7zSDO11iBeoMKv+CPUareBGnM7u2ngWXyjdli/OwgWS7FEbbHqeOpbJxus26TcJJX/ennBn7OfqZHC5MfBFA4NUcKqRwA+f4Jwv9vc5Ije2lHAkwhSMA7vvjDE6RBipv554xpae97RaQqA8j2yOwZdLcoOfSbSqEeHKJ//sldX0nJDjefO+szjCYDoQbwxm/kgGouhW+3llqRHQ+TIl3DGnRDlpA2sRjtOr15+dEwsI5y55zZMIi2FN8PSBUrKAk9jwR9YVErteBdtFo15eFKvb1ydKujL1j1oJBgt7dTMkuEMjZS3CI59R8trIqAejkSMKaVxf2H5r3WucNOLqc12NEX7zjjXNvRR8avhAGZvTOsscw3c6UVNXBR00gC5TS4MLdoiq0S1UnB2VR1zPMP9a3Ks5PqHJf1w3knWc/tDIXtifGf2xCR0WPXqNElbolldgWL+s6TKdEL4WY3VBJ92cLNdaWlKPu/CnycDp33qu6VthnSgSo+qdZu2BXxnJAJh7zORI4E8M8B7iXwitB+koMAXq8fEZV6jVrWi+rbP7Z0lhEDYEADyFM8FybyEq/nMWVwDGvovx5SVU 5DLS1G/DfZ3rkTYzJbtT+vpOZckSnBK2lougt4uIecnJ/mWGtUJnU0Oo53UIgQpgU9v/7F5qJ9bdPABrL08UpDa3di6powhxQy 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: 7318cb40-1a33-4771-135a-08d96b405242 X-MS-Exchange-CrossTenant-originalarrivaltime: 29 Aug 2021 22:57:05.0801 (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: ogpensTtcA8mwqhFpsy9XZBodAS77Z2PfrzN/hOMPSphjQ4lUehBDG7LiEwk4Ij4i8NZmJuzI5kvGCsSt55dUQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR10MB4653 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10091 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 phishscore=0 suspectscore=0 adultscore=0 mlxscore=0 mlxlogscore=999 malwarescore=0 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2107140000 definitions=main-2108290150 X-Proofpoint-GUID: QzoGo-aTVf9ACc43NWppyoyR4NH9w-SF X-Proofpoint-ORIG-GUID: QzoGo-aTVf9ACc43NWppyoyR4NH9w-SF 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:212983 Archived-At: > > Informative text should be added to the following sections: 49.4.1 and > > 49.4.2. >=20 > I've now done so in Emacs 28. It was really difficult to find any > variable that you'd want to recommend anybody using `set-variable' on in > their init files, but I think I found a reasonable one. (If somebody > can come up with a better example, feel free to edit.) 1. `set-variable' is the wrong thing to recommend for an init file (for a couple of reasons). It's OK to use `customize-set-variable' and `custom-set-variables' in an init file. 2. And yet you closed #21695, saying "No, using setq for user options is fine"? Fine or not fine? Apparently, depending on the messenger, you now agree it's not always fine. 3. You found one example. So far so good. Now please DTRT: "Please (case by case) change examples that use `setq' to set an option value" ___ More generally, users shouldn't be encouraged to use `setq' to set user options, allowing as an _exception_ if they happen to have checked carefully and are sure that's a bad idea for this or that option. That's like encouraging use of list-modifying functions, allowing as an _exception_ if you happen to have checked carefully and are sure it's a bad idea in some particular case. IOW, such guidance is backward. As a _general rule_, users should be DIScouraged from using `setq' with user options. And they should be told why, so they understand and remember the guidance.