From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 14 17:36:49 2022 Received: (at submit) by debbugs.gnu.org; 14 Jun 2022 21:36:50 +0000 Received: from localhost ([127.0.0.1]:35972 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1EDR-00039z-45 for submit@debbugs.gnu.org; Tue, 14 Jun 2022 17:36:49 -0400 Received: from lists.gnu.org ([209.51.188.17]:39024) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1EDP-00039s-GJ for submit@debbugs.gnu.org; Tue, 14 Jun 2022 17:36:48 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:49770) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o1EDP-0003fP-8w for bug-gnu-emacs@gnu.org; Tue, 14 Jun 2022 17:36:47 -0400 Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:40000) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o1EDM-0003Sk-Bl for bug-gnu-emacs@gnu.org; Tue, 14 Jun 2022 17:36:47 -0400 Received: from pps.filterd (m0246630.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 25EKSmms023491 for ; Tue, 14 Jun 2022 21:36:41 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=5B0jLsZoigMNZItliD/I2NgS5D0yIJcDYIMDlLe9I1A=; b=PM/wzENWyKqUImN/lk8vL4S3ZrHEQ5vFJj80LLvEj6k/I3kRXIReH6Qmj6+qmcXJ4mOd 7EC3B9qUR5EZ4T4Dmyz1pn7TbHCPPoyJkhwJ3tDXTEFaCv3Jy69VKN7rnqcITN/KKmIc 0VY4TupA09d0+IWZWRs6WyoNlYeVnubTvnQHW1I2PyD1UMhgYkPcoZrCk3CAm5k59jkW HRgzP1+K63a/8cZnJ9KlMQVNl/q/mZIT+A6RA9KnggzjfWpEnBTMJMb7u7ehC65kdbyf vivY5BJ+gPDBVQAAGUFp7WTQo0ekQX5UBI2Jl2GSPhVHxD+OxjFn3uQfV+2kgss4FKyC wg== Received: from phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta01.appoci.oracle.com [138.1.114.2]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3gmhfcpxhu-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 14 Jun 2022 21:36:40 +0000 Received: from pps.filterd (phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (8.16.1.2/8.16.1.2) with SMTP id 25ELQNJ7013458 for ; Tue, 14 Jun 2022 21:36:40 GMT Received: from nam04-mw2-obe.outbound.protection.outlook.com (mail-mw2nam04lp2172.outbound.protection.outlook.com [104.47.73.172]) by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com with ESMTP id 3gpqq0me8g-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 14 Jun 2022 21:36:39 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lmihpIueQM2XFA5UNL7skUmByVim0OWZtZAilyp+uWJ4O7e/T5NVjLHdK8vBN/7/C8GW6eBTSPmd95xeCmv+EF/3XdqsHyb/4PYu5GArfY7aTHHG3nB+Cc3Rrd8UVK50VcUmfGDFJuKSt+LBQUFpGcrGQhE+VFFXchCzDBj0am9OIIH8rxY3P5euHeXCxbxE58bfJA2qqCzYlKilDlhfhjAHPnkKTuJHNbtemD52S5TqO5597AFv4Kj01m65fE+djJ08iTRQQXQy2z/0cwkr+JETwNSTkISLboDJMDeDv4QXWTxXxtjnyp5EkR17mvxY3LWywbOu9KQaFvNP9cK65w== 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-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=5B0jLsZoigMNZItliD/I2NgS5D0yIJcDYIMDlLe9I1A=; b=YRdro5WEs4qQW7RWcmd4PNQJrGb99wNa1nxUgRZznTwfK+/Wxpy/38omUrc+gxhN9zcVnQYmNSrSEs1wS06zJqf4lPypwRKhPblUmoBgs+bae1u6T8IdEGZFYn74yfBV3VB86KEJQtz8hsgVDp9FjakIXy6U39FXem1XBGdLEmbR8ju75m1gwTvgOwjIO0k2arhN6spOSDfeX3rpdsSyIEMFjYyqpsrXesGw0JH+ylH8w3zYrMXgiakCvRrBZUhFmScauemfHN2CCrpbkXcG7CsO67GCia+itvvWvEP9zmqxKEWqZOm0LJd+jCCMFe+WR06eXDnwmyJLF3fnLSaWMg== 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=5B0jLsZoigMNZItliD/I2NgS5D0yIJcDYIMDlLe9I1A=; b=wbAGvj9Qo9mY0sDidNErzp6thXg3PbeTg5i4eBdgzbiDSzUmAep+Z0/ftG6ZRqu7apW4+HMQ9rJFuB3A3rDflLFX6TbCCmrQ3Ggo4sriwxHRnVHHYIKVoF0HhvbpMsmBz8LVgSdMQBKjz7b8+4zmmDsuITT8mHtGms0KOEbShPI= Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by DM4PR10MB6015.namprd10.prod.outlook.com (2603:10b6:8:ac::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5314.13; Tue, 14 Jun 2022 21:36:37 +0000 Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::818c:10bf:c1b5:e224]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::818c:10bf:c1b5:e224%4]) with mapi id 15.20.5332.022; Tue, 14 Jun 2022 21:36:37 +0000 From: Drew Adams To: "bug-gnu-emacs@gnu.org" Subject: 26.3; Doc string of `chmod' / `set-file-modes' Thread-Topic: 26.3; Doc string of `chmod' / `set-file-modes' Thread-Index: AdiANslz7EhPrioVRzGu0ssubBLU9A== Date: Tue, 14 Jun 2022 21:36:37 +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-office365-filtering-correlation-id: 6cdd757d-009f-4c04-30c5-08da4e4df5fc x-ms-traffictypediagnostic: DM4PR10MB6015:EE_ x-microsoft-antispam-prvs: x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: Hf9aQmnunvYLZiC9YRPWJOyYT+iHT5/kI0nJRqowA+243UaZ+Hl57AYuYxkRLxPH/rEyZzAJp2yfQ/LzQHvy0szc9Y3EchHXC1ycyvs2mEHwGuskIouGm5HeYHLNprB7tCoQbv50vmQljGmfRZxMxOonswP09g0V7RnIQxKS1ESjRAOGA4/ke0zMKj4OTF2PkGKaa7gn80jjHO1Alcwa6G1ukDIS4kavZPDSJssGwJPX9Od/FANM/VkPhemsztPJaX+A+HNYHwVYFK3emzbZ19SG7bIL7lr/I/7PH1+2yY39vpr08bLJph/7Tc7NDeN0tF7SGToDjhIOk/CDTWFK2FhetjcQBHfsJR94gnnZ254iCme46PyN87+FnjmBJNaBa4vQUNAxy+LaYkm99XVOXConqTpejuqgQ9ZfXSuzuvVB5rZdm7VZcpQkjFrwUg+V1aTJGmAYXq+wBFWqRyuheXVNBWUOoQr521/xBPSbrM13aO4Zsue/sAgmTwp0xaV6kMHBGoIxX43iSgXBthnyS+cIXTY651KNlIVhOCnUACFZW4C1+ui+WnzG5Gv0ZF1B/WMqLgnmeBBYmDCrC6Cbw+dVAj8CpMBX8/vVjBjGFdmOb00ivfc97DG2BFM/8ELbZhbZ8HgBmvomCX1h02FBEHKrWPKrpMeD0Or7FBEinsJiDVJYg6o9aOvS8S2qZcyjIxn+rpl6auTjAkPXVKYpGMD/xt3e3Tcc3WxVydsr2Ns= 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:(13230016)(366004)(33656002)(44832011)(508600001)(5660300002)(45080400002)(66446008)(6916009)(52536014)(9686003)(66476007)(71200400001)(4744005)(38100700002)(26005)(2906002)(122000001)(76116006)(8936002)(316002)(186003)(8676002)(64756008)(66946007)(6506007)(7696005)(38070700005)(86362001)(55016003)(66556008)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?3t+5sDX3Fhirqcge8xIFjDacDxYAw2B6TZreyw+IjVIxLXNDoX4qlqAlr8TD?= =?us-ascii?Q?ro4Ff8LZq6R6qSriPInsQ/aVzY8AueqyWit0PvMYxPYbjkgZJaEJuWK/JQUT?= =?us-ascii?Q?28+MdoGFQQouO7YT0VHleY5psOFCPV2AcOgQ7DL/773fN4ZKeq989HCovNpd?= =?us-ascii?Q?i2h/uhYRVqqfEPqtF/Ez5jm+aKOHC6ipErty26xgrQ0BFCkD6ZlGPOkAngwQ?= =?us-ascii?Q?N8s0i6aCi169oUPfmdDm66YQ+oZsGaatNFvr6hxY3V9E6u+HuQo47befFPKJ?= =?us-ascii?Q?fYw793mWeNaDkT1VHx2u7IiiMMzyF/ix8IVz3ANAIlorwPWf7nmkSRva947m?= =?us-ascii?Q?GtZLVbfUdD6diHW/eaNmTSon1unelFfho+xcIWpQW5YhhT8XTOOBvb+ZBPZ9?= =?us-ascii?Q?D3mhxhe/9f1r3Vu+C04h2xmh5Qfz35XfCSRz/hnSRCThGKg939F7E2DDtpFT?= =?us-ascii?Q?Y8OHFR7k5JunU8+piiEzeKjJS0eHULEWeg7XCSisQS6viTolfMBVrQgtjox3?= =?us-ascii?Q?6MPUS1WtbqwPtI9DnGrDnFwlg/mlLx7yWbpBborQxeU4Y8iORD7B56oUd4U4?= =?us-ascii?Q?c6F/AsaUPWVRtPzfOdY7Zj8LVx7Wb99unqL00gX26TXNHBVaukhDgJJdvu64?= =?us-ascii?Q?9bNAUOYy0qtRV5WyLUkVlJBA4gMZEKbta5vZE8zbpVhMX26sW7O/f4WWIn1K?= =?us-ascii?Q?4wb1IAo0mSSq5g3PpngNfytQZtkW0bvzjDLfITfz85WUBS7H6BDlE172JFH9?= =?us-ascii?Q?WPhZluwn3XnKBDcpg6dPPodPYQ6aGf/JeTDvEK76s23Z/GmmCF+6q8cJabHC?= =?us-ascii?Q?slSeFi8brV0Sr1tZPnlTRg+xmAYtPhTeENJkFvc+cwWyHI1QsZNAVpbPE8E5?= =?us-ascii?Q?pH3lT7yKd5JV8GOQMdGX33XrkGjILzTX2fLoCl1KaxFDkjzWGGKRpwPJeY1G?= =?us-ascii?Q?/aNcgybdmEjRQZexKl/VRBvKCn+oHK5sJUnwi2dztehTWKw7eYbvioNbiWmn?= =?us-ascii?Q?Xh0P4a8Oo8b0jXP5pj4d+CbaiCg+k6pqvN5SScPcl9ZdND7nMUDJFdjesnp+?= =?us-ascii?Q?U6MsvJixuFg4cBv1KREd7PgCzhHhNG4sKKB6RuV3P+sTGFU/qCmvjeVGiPkE?= =?us-ascii?Q?EtiDr1io2YPN199lGTaCCWY1XBEgDEsi+6XTfvXDkslPrMTcKG6kZxmW6lTx?= =?us-ascii?Q?tnT0ZZwuSsh8gQ7RmzXneP/D7fYTUMihuqARTYiCTi5HQ531ZXiS+NgGXtyB?= =?us-ascii?Q?Vj+tD/v0rUWq97A7Js79V+D5Q6BgKY0wA3laM7iq8Mgx1JFtz+bkFgGhQyx3?= =?us-ascii?Q?rxwD8bVfRkUOe5K3HMrabnHcMqmShZd15LJUUVWnI6tDe7aGDnJS0R7vzb1c?= =?us-ascii?Q?jMnNwaOhoH61gVFCSlAi6Xqt/RZvXt/QbC+V2c3kNG9XFHE0omL7yHxTSO3B?= =?us-ascii?Q?Ar27HBv1NQ+UJAhRkxjuF+R3GpqCw3rnrX3PMIZN0qkNttlBDv2i6r7vyfzU?= =?us-ascii?Q?dVt9cUEyfiPgVLgNcoiuCkQTHIyZ5yCRD+7CPi786ZThYOd/EpzkfkzFT9jZ?= =?us-ascii?Q?obCxgwWIQcRmMmzq5MbH7d6nPA5qIHi++lOq8dLAMy2IjB/poUlOuD/Bx84c?= =?us-ascii?Q?C2yWblR6FXEOMkvlPmTlbULn3CoBNMBBx+NH8frqMMk5zf5StDrYrExM+FND?= =?us-ascii?Q?eIVTs2wdRDFFG/MflgMXaBRfI5z3H2Yexo7zVhrT4iYbz0WK+ZOrWkSEytgR?= =?us-ascii?Q?K9Emvtoplg=3D=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 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: 6cdd757d-009f-4c04-30c5-08da4e4df5fc X-MS-Exchange-CrossTenant-originalarrivaltime: 14 Jun 2022 21:36:37.2271 (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: ufmk6NWIX9kjHFb1uxZNPmqMl5hBpQ8OF3NKOz4R5GF+OpZ0fe0NgIffewpMPCI5BvVZfBm9pJhhHIhBxazTdQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR10MB6015 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.517, 18.0.874 definitions=2022-06-14_09:2022-06-13, 2022-06-14 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 mlxlogscore=965 bulkscore=0 spamscore=0 phishscore=0 adultscore=0 suspectscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2204290000 definitions=main-2206140076 X-Proofpoint-ORIG-GUID: 0Ax4cde9hHsAYGJkjWERSFVCQKbS6-TW X-Proofpoint-GUID: 0Ax4cde9hHsAYGJkjWERSFVCQKbS6-TW 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_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit 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: -2.3 (--) Please consider mentioning in the doc string that the command prompts for the file name and (then for) the modes. The doc currently says how the modes are read, but it doesn't say that the command reads the file name. In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.19044 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 15 05:03:45 2022 Received: (at 55984) by debbugs.gnu.org; 15 Jun 2022 09:03:45 +0000 Received: from localhost ([127.0.0.1]:36481 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1OwD-0006Sx-8d for submit@debbugs.gnu.org; Wed, 15 Jun 2022 05:03:45 -0400 Received: from mail-wr1-f46.google.com ([209.85.221.46]:41899) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1Ow8-0006Sf-Lt for 55984@debbugs.gnu.org; Wed, 15 Jun 2022 05:03:44 -0400 Received: by mail-wr1-f46.google.com with SMTP id k19so14413514wrd.8 for <55984@debbugs.gnu.org>; Wed, 15 Jun 2022 02:03:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:date:in-reply-to:message-id :mime-version; bh=o0Gx3nDkKgnctC/PuCIGaFhvrpeqQYWUIPdHMhzUCnI=; b=etWEqJGExrMPi2X5PKC20bWr3vr9rWF31db6YzXnzFTOZsa1ZYNz6BIuCL3dDWCep7 L01tdSoSEM8DGnGtkfRSCZkZ+Cs0XxRKSAITIiry4k2HQmtbN8W/36oSE8SShwJ7VFnB AuqT3u+puWumedojbbluT2CJjIVqSQZGaecwwuEpL+eG3mVSmGHp2HE2HsthSwizmEa0 3CbcVKSvdEEOmaLb3/4PYjLtYorHGoVyU667xjNhnWrqdrhFPVAjGp0kbOBcArGuXV7Y +4y6aCS+mcCWwKsPlwJ+LDjGyajo9ik32PHIgQUA4kf3fPiADz+i/Ly9w0DdPqDEaNfN 9kbw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:mime-version; bh=o0Gx3nDkKgnctC/PuCIGaFhvrpeqQYWUIPdHMhzUCnI=; b=kmQzMeUEkC8oOtBVGchPtlLsojE5gmKmLko5HeDujTWIgiB3GWb1sXSfaVSivMhsLF WDbJNOyq5fBbM1kaDx9GbL+5/b7z4jxuAOG5pKOkV3+Pt30DBRmqdQ24/qgPW68hIuTB DxGtPSKIsseIyTr5QLUimCLDJxVrVu4/P8WjfFREFq1ImDKu21ric1G/XfMum/7bvAdx SclYh0xNs/Pj0lV92dH9tYyU/DBa0/069WXDBp0AsnTDxwfmYNOpEECWSLnrFjUBhkGo qerPULUyBwm/y/pO1LoD6sojsZnc3UBAApVlS1YtucAjhNMCtQLfRxjKCQ07qloir5CP I1WA== X-Gm-Message-State: AJIora/cX5qR4Be7guhGX5i9n3bCOpuGlgFpZosR1lRwwz35vsAnItOE Y9owMhMCm3NuLW4qfOMZO/BbY3Ke/es= X-Google-Smtp-Source: AGRyM1uSr9+GikCgcx/y8D2vynjIGnlUysuacA1+Ntw5GLTsU8clz3F+vW+PW+3OetH2+7pLw2fj7w== X-Received: by 2002:a5d:638b:0:b0:218:54a2:71cf with SMTP id p11-20020a5d638b000000b0021854a271cfmr8791209wru.491.1655283814289; Wed, 15 Jun 2022 02:03:34 -0700 (PDT) Received: from rltb ([2a01:e0a:3f3:fb50:d98:f501:96ca:7200]) by smtp.gmail.com with ESMTPSA id g13-20020adffc8d000000b002102f2fac37sm16276297wrr.51.2022.06.15.02.03.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 15 Jun 2022 02:03:33 -0700 (PDT) From: Robert Pluim To: Drew Adams Subject: Re: bug#55984: 26.3; Doc string of `chmod' / `set-file-modes' References: Date: Wed, 15 Jun 2022 11:03:32 +0200 In-Reply-To: (Drew Adams's message of "Tue, 14 Jun 2022 21:36:37 +0000") Message-ID: <87r13qz4bf.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 55984 Cc: 55984@debbugs.gnu.org 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: -1.0 (-) >>>>> On Tue, 14 Jun 2022 21:36:37 +0000, Drew Adams said: Drew> Please consider mentioning in the doc string that the command prompts Drew> for the file name and (then for) the modes. The doc currently says how Drew> the modes are read, but it doesn't say that the command reads the file Drew> name. Passive voice as well. How about the following for emacs-28 diff --git a/src/fileio.c b/src/fileio.c index 7d392e0de7..a240216dea 100644 --- a/src/fileio.c +++ b/src/fileio.c @@ -3510,8 +3510,9 @@ DEFUN ("set-file-modes", Fset_file_modes, Sset_file_modes, 2, 3, Only the 12 low bits of MODE are used. If optional FLAG is `nofollow', do not follow FILENAME if it is a symbolic link. -Interactively, mode bits are read by `read-file-modes', which accepts -symbolic notation, like the `chmod' command from GNU Coreutils. */) +Interactively, prompts for FILENAME, and reads MODE with +`read-file-modes', which accepts symbolic notation, like the `chmod' +command from GNU Coreutils. */) (Lisp_Object filename, Lisp_Object mode, Lisp_Object flag) { CHECK_FIXNUM (mode); Robert -- From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 15 08:20:17 2022 Received: (at 55984) by debbugs.gnu.org; 15 Jun 2022 12:20:17 +0000 Received: from localhost ([127.0.0.1]:36744 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1S0P-0007ez-B0 for submit@debbugs.gnu.org; Wed, 15 Jun 2022 08:20:17 -0400 Received: from quimby.gnus.org ([95.216.78.240]:60438) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1S0H-0007eY-8f for 55984@debbugs.gnu.org; Wed, 15 Jun 2022 08:20:15 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=c8yNZWWXlCAQYuS6MpPB72qTSc9MF/tFthjYfVMWsBA=; b=VSMuYv6tMq3BJHJpY+cvE/iNRT GVzIAZd6fj0yCQsjDfvPwVbW/cvscell/xF4lSslUXNg8UlmcI2dbeyQE3RhPG6yJsNaH7lXd+UUG NkE5l7WtnT6tyECoVlsomiYXVNM9o7OOR9GtzAiuDd5PuHPVtW8zxPkcBJHCTWqCGrF0=; Received: from [84.212.220.105] (helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1o1S07-0002Pz-UL; Wed, 15 Jun 2022 14:20:02 +0200 From: Lars Ingebrigtsen To: Robert Pluim Subject: Re: bug#55984: 26.3; Doc string of `chmod' / `set-file-modes' References: <87r13qz4bf.fsf@gmail.com> X-Now-Playing: Neil Young's _Comes a Time_: "Already One" Date: Wed, 15 Jun 2022 14:19:59 +0200 In-Reply-To: <87r13qz4bf.fsf@gmail.com> (Robert Pluim's message of "Wed, 15 Jun 2022 11:03:32 +0200") Message-ID: <87mteei0eo.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Robert Pluim writes: > Passive voice as well. How about the following for emacs-28 Looks good to me. Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 55984 Cc: 55984@debbugs.gnu.org, Drew Adams 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: -3.3 (---) Robert Pluim writes: > Passive voice as well. How about the following for emacs-28 Looks good to me. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 15 08:33:06 2022 Received: (at 55984) by debbugs.gnu.org; 15 Jun 2022 12:33:06 +0000 Received: from localhost ([127.0.0.1]:36826 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1SCo-0001nh-AG for submit@debbugs.gnu.org; Wed, 15 Jun 2022 08:33:06 -0400 Received: from mail-wr1-f53.google.com ([209.85.221.53]:37821) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1SCZ-0001mv-EE; Wed, 15 Jun 2022 08:33:02 -0400 Received: by mail-wr1-f53.google.com with SMTP id o16so15186541wra.4; Wed, 15 Jun 2022 05:32:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:date:in-reply-to:message-id :mime-version; bh=3Ldxj4Jnfsea89JIo72SgEh9E3FoZSPhb0FSZgq0cNE=; b=D+f8BrlTJATAzmJYfY++Ih4Eh0EtNXaYgQzsy2B31J+4eo47uhdIqoM6v/m37aRMg+ pPkJZEzBCdjEb33CSgWw7wjZVFomg7pnv3EF5OKHsHW1LWyZiT0x8BAwdH/r6rEKEYAx i/vtcbLWMBrrTjZSJtJSxGSRyAlnowk8T00vTXqme+xeFiRmv+yp9oHPUwRxL1fjnjZd I901V1Gxkn6FsiRxzKKVLuwfjUWnXLbVwvLH+GDaGh06XY48Jv7Y45BpFJF5pRquujmi 2C/5FnvWXg3mxMecnbVAjNa74eXgKHQwh2/15CyUuHOc8MUAwdOLmO4lTEHjaoAesFOW pmDg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:mime-version; bh=3Ldxj4Jnfsea89JIo72SgEh9E3FoZSPhb0FSZgq0cNE=; b=s97Derr+wsceWKH7Y0cSe+uGzJjO9xtEiCknt2oetsrvzMjp94tR7+tOq7ALXUUTRt n5a6yQ5Ory1JIp9TdBKAw4O0Aj4oGoQSIsidLqu+OFBM0+Bork0PScLIwXpeGz1pkQYh xkJRO45MiUErKnwk7Wxhtvv73/gFrEXUeXfB9t4MTx8zB6mM4o4WaD++N2zZVWj0/x5L TdZ2Z4XkPdZEYj+P2JYKhu8BNx4evs/XvaRLcF8uVWs/Tio1cqWjz9WC6ABU2eXiVc68 gogHtmCWNyBcpFUwzBIdSeK6uWbqAOLixWk/IUjBOSqv5TLUIV1k+BNTGOitfBOfZPCI T0sQ== X-Gm-Message-State: AJIora98PwxKlSnvrDpetlNBuoj89UZmTUxeN5MBf+QvT13EQ8a19wCL VbNU+8Pn+IiBcQwP3Slfxrve1zvANyI= X-Google-Smtp-Source: AGRyM1tyWk+rNjLzqYa+uD2U989SfT9xcqtzJlI1IaXGPUt0ggu8PdwaeHqSxe6SfWtPHpzBDnTuPw== X-Received: by 2002:adf:d1ed:0:b0:215:98d7:2a93 with SMTP id g13-20020adfd1ed000000b0021598d72a93mr9904835wrd.637.1655296365265; Wed, 15 Jun 2022 05:32:45 -0700 (PDT) Received: from rltb ([2a01:e0a:3f3:fb50:d98:f501:96ca:7200]) by smtp.gmail.com with ESMTPSA id i18-20020a7bc952000000b0039c96b97359sm2325201wml.37.2022.06.15.05.32.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 15 Jun 2022 05:32:44 -0700 (PDT) From: Robert Pluim To: Lars Ingebrigtsen Subject: Re: bug#55984: 26.3; Doc string of `chmod' / `set-file-modes' References: <87r13qz4bf.fsf@gmail.com> <87mteei0eo.fsf@gnus.org> Date: Wed, 15 Jun 2022 14:32:43 +0200 In-Reply-To: <87mteei0eo.fsf@gnus.org> (Lars Ingebrigtsen's message of "Wed, 15 Jun 2022 14:19:59 +0200") Message-ID: <87ilp2yums.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 55984 Cc: 55984@debbugs.gnu.org, Drew Adams 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: -1.0 (-) tags 55984 fixed close 55984 28.2 quit >>>>> On Wed, 15 Jun 2022 14:19:59 +0200, Lars Ingebrigtsen said: Lars> Robert Pluim writes: >> Passive voice as well. How about the following for emacs-28 Lars> Looks good to me. Closing. Committed as 32cff740e2 From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 15 09:08:57 2022 Received: (at 55984) by debbugs.gnu.org; 15 Jun 2022 13:08:57 +0000 Received: from localhost ([127.0.0.1]:36912 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1SlV-0004xB-K3 for submit@debbugs.gnu.org; Wed, 15 Jun 2022 09:08:57 -0400 Received: from eggs.gnu.org ([209.51.188.92]:33332) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1SlT-0004wu-1b for 55984@debbugs.gnu.org; Wed, 15 Jun 2022 09:08:56 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:33162) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o1SlM-0007QI-S1; Wed, 15 Jun 2022 09:08:49 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=h7/5dw317qxqHa3YZds8XaTSaBF0ICeHSr1Cj4FIBt0=; b=hW9NJR4tbO20 zqQPe1a9iznCKjeDpMktqiq5j7yLJmC8wF3mkayIiWS/+nZ425qhhLR2cZQaGA0j7KMEJaTPFr8r4 +gtXzlPxCkGX882qqhd+c9THETi3yp16VW3LhvQGjPo3+aG2hfZMP68QPaZl8IaGd643//6VGduKx vhjbKoHXgTVjd/JV0vWKw4BNGkagftKtwHxTxNAoHOe8o7sVTbg77M+QwL4rYsAjpioW1mt+ikWKi uI2/76awjFhbK9N5s4767qOlQ1fw5WMyvE+XexUEncPig4NJO7eL1u6TDxXRCsbyK7M3gsO6XFW+7 ERifGfo8tUvMdGXAkxOQtQ==; Received: from [87.69.77.57] (port=2161 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o1SlL-000516-MF; Wed, 15 Jun 2022 09:08:48 -0400 Date: Wed, 15 Jun 2022 16:08:38 +0300 Message-Id: <837d5irs4p.fsf@gnu.org> From: Eli Zaretskii To: Robert Pluim In-Reply-To: <87r13qz4bf.fsf@gmail.com> (message from Robert Pluim on Wed, 15 Jun 2022 11:03:32 +0200) Subject: Re: bug#55984: 26.3; Doc string of `chmod' / `set-file-modes' References: <87r13qz4bf.fsf@gmail.com> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 55984 Cc: 55984@debbugs.gnu.org, drew.adams@oracle.com 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: -3.3 (---) > Cc: 55984@debbugs.gnu.org > From: Robert Pluim > Date: Wed, 15 Jun 2022 11:03:32 +0200 > > Passive voice as well. How about the following for emacs-28 > > > diff --git a/src/fileio.c b/src/fileio.c > index 7d392e0de7..a240216dea 100644 > --- a/src/fileio.c > +++ b/src/fileio.c > @@ -3510,8 +3510,9 @@ DEFUN ("set-file-modes", Fset_file_modes, Sset_file_modes, 2, 3, > Only the 12 low bits of MODE are used. If optional FLAG is `nofollow', > do not follow FILENAME if it is a symbolic link. > > -Interactively, mode bits are read by `read-file-modes', which accepts > -symbolic notation, like the `chmod' command from GNU Coreutils. */) > +Interactively, prompts for FILENAME, and reads MODE with > +`read-file-modes', which accepts symbolic notation, like the `chmod' > +command from GNU Coreutils. */) "prompt" and "read", please, to be consistent with our preferred style. Otherwise OK, thanks. From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 15 09:19:43 2022 Received: (at 55984) by debbugs.gnu.org; 15 Jun 2022 13:19:43 +0000 Received: from localhost ([127.0.0.1]:36930 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1Svv-0005Ds-Gr for submit@debbugs.gnu.org; Wed, 15 Jun 2022 09:19:43 -0400 Received: from mail-wr1-f50.google.com ([209.85.221.50]:43851) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o1Svr-0005Dc-EE for 55984@debbugs.gnu.org; Wed, 15 Jun 2022 09:19:42 -0400 Received: by mail-wr1-f50.google.com with SMTP id m24so15316440wrb.10 for <55984@debbugs.gnu.org>; Wed, 15 Jun 2022 06:19:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:date:in-reply-to:message-id :mime-version:content-transfer-encoding; bh=24mgxZvJIH4R+6AaroONf1ALujWe4x3llMqivwIpRNk=; b=BvMwHx7d/AnTYF42y/SoU7tbrwDjcTsGwNN/SB2uS89l7V4uRGtnNUcCjMgHtzE9/V g6rR5/RdKxOF7TmcCSh7OS8KcWQf8JtCGx4wg2M1bKUQsO2F6oUqfkyPvuUEbxHDRA2F Zw0eb0AXoaq6MdRS5qPn/zu05dNRxDqKjn0e6jhSRUViWJ8ICrhTQi87DxeUgy3CiUNl +IGihfWpQZEMfCNLE7lcrcH7M9CoY4OfLn9BFx+Amyqnhfa2Wk/aqsGixb7QzalPu6Jl 5WSbyVovoYKsTipCg6rB4NaZd5X7U0DBUY9RyUTAyMsTHYCMOcP84kJaXUxj1E1ltjwc cHlw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:mime-version:content-transfer-encoding; bh=24mgxZvJIH4R+6AaroONf1ALujWe4x3llMqivwIpRNk=; b=pt58XGltkIghhkRo1kcfOJHlxxiTlKhk0FylxSxVPhUPq8ZxBFnq29U8g9Nq2jW7FO 69GQnViAwUENlFE4yIciSnDLs0ZWgrzoPrpal5UwYf3EdMn7AsiqfK2zBPP2A4B35eQ8 IweNJOX3f8sajt2Ho/yb3gF55UA5FoT+Hvwh25Dx3GUJ3NqfmbpnxwMpfzrBsZoT8GxM +HwwLmtvma6+h4vG+a6YUOhEwpf8r6uDCivdHYSWB5A03bkTiELxkJh9aRui1TXiVwbD +y3FkPQFMwzeZO4F4s8UAFsU1o9MUHpgE7j2KrhKq3mWi4pgmSKK8HbOxRDsndkgieZP j+Hw== X-Gm-Message-State: AJIora9kfI/TE9HdG9iZoa1HoNqqirb/XMk+veJKVYNJ/1l0I7UjJ9qd XOLbBnOgYTBi0SanP23kyayUAFtZZ/g= X-Google-Smtp-Source: AGRyM1vIMj31w+tnnx7KgGMA3MCzEapldZVy4h9rgBsxc1cNxrsQs3HeEEqNSFKW89ICsto7/QMZKw== X-Received: by 2002:a5d:620f:0:b0:20c:c1ba:cf8e with SMTP id y15-20020a5d620f000000b0020cc1bacf8emr9890172wru.426.1655299173053; Wed, 15 Jun 2022 06:19:33 -0700 (PDT) Received: from rltb ([2a01:e0a:3f3:fb50:d98:f501:96ca:7200]) by smtp.gmail.com with ESMTPSA id g7-20020a5d4887000000b002184a3a3641sm14609339wrq.100.2022.06.15.06.19.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 15 Jun 2022 06:19:32 -0700 (PDT) From: Robert Pluim To: Eli Zaretskii Subject: Re: bug#55984: 26.3; Doc string of `chmod' / `set-file-modes' References: <87r13qz4bf.fsf@gmail.com> <837d5irs4p.fsf@gnu.org> Date: Wed, 15 Jun 2022 15:19:31 +0200 In-Reply-To: <837d5irs4p.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 15 Jun 2022 16:08:38 +0300") Message-ID: <87a6aeysgs.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 55984 Cc: 55984@debbugs.gnu.org, drew.adams@oracle.com 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: -1.0 (-) >>>>> On Wed, 15 Jun 2022 16:08:38 +0300, Eli Zaretskii said: >> Cc: 55984@debbugs.gnu.org >> From: Robert Pluim >> Date: Wed, 15 Jun 2022 11:03:32 +0200 >>=20 >> Passive voice as well. How about the following for emacs-28 >>=20 >>=20 >> diff --git a/src/fileio.c b/src/fileio.c >> index 7d392e0de7..a240216dea 100644 >> --- a/src/fileio.c >> +++ b/src/fileio.c >> @@ -3510,8 +3510,9 @@ DEFUN ("set-file-modes", Fset_file_modes, Sset= _file_modes, 2, 3, >> Only the 12 low bits of MODE are used. If optional FLAG is `nofollo= w', >> do not follow FILENAME if it is a symbolic link. >>=20 >> -Interactively, mode bits are read by `read-file-modes', which accep= ts >> -symbolic notation, like the `chmod' command from GNU Coreutils. */) >> +Interactively, prompts for FILENAME, and reads MODE with >> +`read-file-modes', which accepts symbolic notation, like the `chmod' >> +command from GNU Coreutils. */) Eli> "prompt" and "read", please, to be consistent with our preferred Eli> style. I said "prompts" because it=CA=BCs describing what it does, but OK, fixed. Robert --=20 From unknown Wed Jun 18 00:26:11 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 14 Jul 2022 11:24:11 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator