From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Robert Pluim Newsgroups: gmane.emacs.bugs Subject: bug#55984: 26.3; Doc string of `chmod' / `set-file-modes' Date: Wed, 15 Jun 2022 15:19:31 +0200 Message-ID: <87a6aeysgs.fsf@gmail.com> References: <87r13qz4bf.fsf@gmail.com> <837d5irs4p.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="35796"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 55984@debbugs.gnu.org, drew.adams@oracle.com To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Jun 15 15:34:37 2022 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 1o1TAK-00091s-IT for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 15 Jun 2022 15:34:36 +0200 Original-Received: from localhost ([::1]:39722 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o1TAJ-0006P7-E0 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 15 Jun 2022 09:34:35 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50174) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o1SwF-0004A2-6c for bug-gnu-emacs@gnu.org; Wed, 15 Jun 2022 09:20:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43033) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o1SwE-0001cm-Ql for bug-gnu-emacs@gnu.org; Wed, 15 Jun 2022 09:20:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1o1SwE-0005EX-Gb for bug-gnu-emacs@gnu.org; Wed, 15 Jun 2022 09:20:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Robert Pluim Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 15 Jun 2022 13:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55984 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 55984-submit@debbugs.gnu.org id=B55984.165529918320084 (code B ref 55984); Wed, 15 Jun 2022 13:20:02 +0000 Original-Received: (at 55984) by debbugs.gnu.org; 15 Jun 2022 13:19:43 +0000 Original-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 Original-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 Original-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) Original-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) In-Reply-To: <837d5irs4p.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 15 Jun 2022 16:08:38 +0300") 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:234582 Archived-At: >>>>> 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