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#63875: 26.3; Doc of `dired-guess-shell-alist-user' Date: Sat, 3 Jun 2023 19:29:35 +0000 Message-ID: References: <83zg5g7c7j.fsf@gnu.org> <83v8g47bmd.fsf@gnu.org> <83sfb87542.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="2263"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "63875@debbugs.gnu.org" <63875@debbugs.gnu.org> To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jun 03 21:30:27 2023 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 1q5WxH-0000OL-3y for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 03 Jun 2023 21:30:27 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q5Wwu-0003a3-Kd; Sat, 03 Jun 2023 15:30:04 -0400 Original-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 1q5Wws-0003ZR-MM for bug-gnu-emacs@gnu.org; Sat, 03 Jun 2023 15:30:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1q5Wws-0005rz-CA for bug-gnu-emacs@gnu.org; Sat, 03 Jun 2023 15:30:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1q5Wws-0003Mu-7c for bug-gnu-emacs@gnu.org; Sat, 03 Jun 2023 15:30:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 03 Jun 2023 19:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 63875 X-GNU-PR-Package: emacs Original-Received: via spool by 63875-submit@debbugs.gnu.org id=B63875.168582058512896 (code B ref 63875); Sat, 03 Jun 2023 19:30:02 +0000 Original-Received: (at 63875) by debbugs.gnu.org; 3 Jun 2023 19:29:45 +0000 Original-Received: from localhost ([127.0.0.1]:44333 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q5Wwa-0003Lv-TM for submit@debbugs.gnu.org; Sat, 03 Jun 2023 15:29:45 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:36044) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q5WwV-0003Lk-RF for 63875@debbugs.gnu.org; Sat, 03 Jun 2023 15:29:42 -0400 Original-Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 353BZ8ZH005108; Sat, 3 Jun 2023 19:29:38 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-2023-03-30; bh=pTEh3TNKisj17f8f6lEPN57mtctWRd6q8UfoWMBZIH4=; b=zvuOud9SORnFIGOr+RQ68TxPTqrajubXA9at6h/1OtqU3e5mY4WL4hD7eDslUAotUbNK I0sqtp/zVfoKPgiISmjKCEDJumgFGkW2Dn3uoorhmkz/SMw7wIADv7LdcZ2IwlNphAYI I9n5vH0cKjY/UcEc0yJpXbyyu+Cq2WokxCexMWVaf/vchQkmEa4L7Wfpc0puhxjpZBlo 2ChYrOeQ61dNFt0zqzCkfQ9OmPtnewzXNTiojEE+w/v3KyKw204Sa6dX6pJn/EATogBj s/xnXs1bOmqNgOtkjvt8yEBMNCXeNDr4PutMHeiKLZa0Ome7Di/Mf0TBcLdiWekPgWgI Ng== Original-Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3qyx43rqb0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 03 Jun 2023 19:29:37 +0000 Original-Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 353FTxHY025780; Sat, 3 Jun 2023 19:29:37 GMT Original-Received: from nam04-dm6-obe.outbound.protection.outlook.com (mail-dm6nam04lp2047.outbound.protection.outlook.com [104.47.73.47]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3qyuy27vay-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 03 Jun 2023 19:29:37 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=mv7jW8qSX6mX1pxoien+OfxP+zMJRKGOqlmYbIbM59QORoXj7JWKBW3WqZMPJVbS376OhTPKVfTJKNVfVXLC3jtbPdrx6HgQuy5k/KtEpVY8RhbA+XD50JQKImncYAG/UZO+/qGhCtmPFevxOZQOgFwPzhjFyC9YyJPlJBcj/6iwZ5qG653YEIDBwmXMyE0HrxWIa1X/mJspTVMMR6uguewKN+nQ3paBOAq8kAiLOKHUrJVtUBLdyQXoocLYHpoew7NhZGAD8U+DMrrL84WKBMapGt7j9x4fjOgu7AehRITeoIREYj9041pPihuC9GUq4/gtV7Uw5+QFL/Uywa4iMQ== 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=pTEh3TNKisj17f8f6lEPN57mtctWRd6q8UfoWMBZIH4=; b=KsEXlcUyZPcV7AiqUwq433UkRVucGl6BroCOx4/AoAM54R4wgQUVquF5lQhCElAbjvCOs+lk/1GS+ZlUOu4gogScr94buJAgZBP+1AwGYK1LEEHvjAdKBVdtGPD7fLrxunwCVtj+GK+R9q4DUdoCn38Gdn/rJpOSKEUBX9fPGf5A1XdmxAHz38VCJjtpmg9je5EVSngD8O87kVJYyr1vngHuv0nv+kEeSoLj5QzPLU6kZ0Zv9Y4q0UUWvqfUph7QpBfE91XMp2pyg+Rr8YN29VxdTg4/8OyFkBZK8xrPSP5oZej+/kwC3O0nHIohin/TKyLKLDhYCuacYp413Osaqg== 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=pTEh3TNKisj17f8f6lEPN57mtctWRd6q8UfoWMBZIH4=; b=PP7DZIe/CJUDpMDKyCEzWSCyY80h7dcrhDHbqrfg5MjNQK40hvagrWFqa4uWWcR6pMd93d6JNaPdrXRdRvFMqAl1RbGT0hzeBfNDoEU6lAZFUzlZ+FhpovqsTsGHdU5Inu5UlQRol96v7wFKMsXU7ggu61msYocR/5ee+UQMFy8= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by PH7PR10MB6202.namprd10.prod.outlook.com (2603:10b6:510:1f2::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6455.28; Sat, 3 Jun 2023 19:29:35 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::a995:2ae5:2745:24ff]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::a995:2ae5:2745:24ff%6]) with mapi id 15.20.6455.027; Sat, 3 Jun 2023 19:29:35 +0000 Thread-Topic: [External] : bug#63875: 26.3; Doc of `dired-guess-shell-alist-user' Thread-Index: AdmWNY+dxb5wBdnXSBqE4C10rz9qGAAFovpVAAEinnA= In-Reply-To: <83sfb87542.fsf@gnu.org> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|PH7PR10MB6202:EE_ x-ms-office365-filtering-correlation-id: c6e22673-b540-44c6-269e-08db6468dd0a x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 3Wx+kUlljsXnHDtFJ7/CEZlTam+Z95IgPKIu11K2+kZNz3TuyvOOm/cK633d+ZxA4hE0XMs0iEmIcdQhGzZMNXPGHcaLYALBt2JeNTBsh4R0Hk44vUZAnqKWI+uew6eiUaQR/xuFXUM62ZjI0qBE/Uvu10meTcRhl/Bml2xHkdyGGn16J0mLAXnSm6QQInwuTYILxZL3RFve8RfPPe48GJG2csRTtGRKc3BvDpBSGF31lA+RPS7DEn3QvL2JXSjZMcN/rytWwUI4G04iyS698tkz1FW6MbVYqQyovZbpOjcNbR1e2vgzo6AAwUAapFm+KUIWWw85gzLE8pjq3B0QyXloPrz7wpZJ00yANeUzIFZ40TtaWs2VAlfFn+vc5in45tX7JTBKaW2Rq2vn36H8O8XA76V6P/Fb9jEEmRKqt8MhvpjzZL4p6Pv1uXpjFiEd4fsn7B/aB7uDQYzZqZr/bij7OM6Z8foHOQOTQGLli9VrbomhtJ5v2Tz/9gZ/gouuCjgcKpZIoYswAuOcv+rVtRKPI6yrHnj1Fg/kvJmJrUfC67Smv28lP0aUryWlBbSnIvKqlqwYvzN6DmVT+vgXcmFAdXMWZd5FAgZ4xu0ACOYWf/iM8DPR04nhFpGoVxP/afHI6dRBtwcLfHbQsqY/uw== 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:(13230028)(346002)(366004)(39860400002)(136003)(376002)(396003)(451199021)(2906002)(33656002)(86362001)(38070700005)(122000001)(38100700002)(9686003)(55016003)(7696005)(41300700001)(316002)(52536014)(5660300002)(8676002)(8936002)(478600001)(66946007)(71200400001)(66556008)(66446008)(66476007)(6916009)(4326008)(76116006)(6506007)(64756008)(26005)(186003)(44832011)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: YV6RFdG91Y0/8mmuamQZEb5PKJhrpQ/0MKrKHydI4HAuJnQ7NOEkB49lYErkbAn1Ctzuvqkfv0dJx4ik4iTmYTlx7bAjslUsEt6gBjq68Fm5AlMyF3RA9bS9skA/ZZ24PJzCkPv0M+7RVt+KD4hW4J/Ycb6OXLUMUmCZzl8ZUWYcDIRpvzG7wuLN0p1DPw1y6muUQ1bMR+nmr0BRTREqMUb5QSbpy2+SLsg2rb5gy0IarGehRdRWkHgB4jJtfFdiaiyicH2lYJelisv8L+sP9wvHcVzfMS5dlkU8aKeKgOviyKcj5BrHGw6r93ezsE+TBd+5xddnxJkhjXlahPsZkWOWw5cuoFxXjhi5Pqdu1aOLH1bbYcvMY3J3+UQNqgFpVV4vjbHE+jy/QtXrdWnCUkTlKxskvedbsiztf5n6FZmm1Ux3naQcpIH6pqobwfYXnICE3PmrUjDzPRIhVj06MQlKmM7ypAgoctZ0NO8Ytvvr/bd+SeBAe7I33+275celswNxpR726VKB1D8Z2RFLPHwTXl+USSUoQFz6a2+03bQ1h2haLlF7Hp7hfItdN5kSNXsmu85MUYBjFlcYePor3PmRCMHo0VEUGUsoISZ2qVptAAojru6zP9MftCZ8lHRmFciewZynDsbNhHvJqKHzO/PQ73rTKZXbgm4nCdXXxs1QghCGT8YZxtyb8Bu1mGja83AZnHEZNOU30RtHpNsvxTlP3NBS0oNTw9doMOe6UeNi2aJQvtBmeucOqn MM+ZUPTfyYCl9pQCgYHheQK6rreZh8/RYyM3GZcfFCGI2+4D3Gc8NxKX+VCMu/TGc+Jo7IwYokMFHeoHSG5GcGvL3jQpZjzzMF X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: /gu1UGJQMmPVtZ94optBnTcyrwMpyqDthYqz5OzOE8xVCr/0cWx75ehmjEjIIwTf0v8l0UAjbUHceU1TOjGqwbjI5T5OanlVw1NR9TDiZ63K0AJDD824xJeGap24f0G56F4/oyUORZjZaeCXJZnT+kqdAzfYFO5aqKHxmH3yPdt5QDj8pY3j+W517OAydoDBFP2j4XYU9mSKlsodYrqIoUzrbIcJnnWZ7CXRzj7rHFmyQcuzzVdIFu80gU4cOTJx2fGzFVKeuYpTXt0g5qD/I6oaNMnb+ZKHjAN5x3oBBJNYvO/yJvcws0hUETuuN5OAT8uAOh6ugWfu5t2ca7Aw2Cf1ZTHZkDkEwzG803FM1EEEBnshOQhzOTNgA365ZPF0QLS+KkkEpaGTH7mGZ0rrkAfpuiMH6H8tZFTwGalwr1oyZE9t4MEu4gkVOIbFvEgPCT8UAUHZWDrXco/zcS3415sTzOLJ3bbEWLO8Bo0Ymp7PeKiP+A2TwW1elAMXeWVWwRYzKnr9Qokdgi1xq7mZy6u3bLHwLxPeduCGQWbGrVAil0ylTwce242LLxY8UyInEOekqnkQdydMGwxp5ZAbe16OofAkPg0T/ClpWieZpYROQB7wFItbStnottmtGDHI8QBbnnKyVQ/BrpZXPEG4zYS8MEG5v8XonzavDQrCXwKMFdzFpyEgZWN5D7ehMVi1VysJO12lH9HSq1VYR6lgq4cW6DmnS8M1H5byeVrt0I4B/h whNE6i/9TJuOtg8Ip0wV8mPhI2rYsSXtRAE0Ip0Q== 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: c6e22673-b540-44c6-269e-08db6468dd0a X-MS-Exchange-CrossTenant-originalarrivaltime: 03 Jun 2023 19:29:35.0625 (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: QupK0hoEzjGb19Go3g14PrjsbS3Xhq6wrF/t+KYQfllm62gIv+E4yOp59oJnwycHZen+v6aEauHbVMhIDym/aw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR10MB6202 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.254,Aquarius:18.0.957,Hydra:6.0.573,FMLib:17.11.176.26 definitions=2023-06-03_08,2023-06-02_02,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 spamscore=0 suspectscore=0 bulkscore=0 adultscore=0 mlxlogscore=901 malwarescore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2304280000 definitions=main-2306030180 X-Proofpoint-ORIG-GUID: _nkf_UHZ22uMgWfwT-PI5qn--laRMERG X-Proofpoint-GUID: _nkf_UHZ22uMgWfwT-PI5qn--laRMERG 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:262881 Archived-At: > > > > But it would be good, I think, to add that it's > > > > not just about shell commands. Some users will > > > > not recognize that they can invoke executable > > > > programs this way. > > > > > > Shell commands are a super-set of executable programs, so I see no > > > reason to change anything here. The variable is used to invoke > > > commands via a shell, so "shell command" is exactly right. > > > > Yes, but many Emacs users won't know that. >=20 > Why wouldn't they? we have a chapter named "Running Shell Commands > from Emacs" in the Emacs manual. Typing "i shell commands RET" in > Info brings you there. >=20 > I think you see a problem where there is none. Is that Emacs manual node linked from the Dired-x manual page that describes the option? Is it linked from the *Help* output for the option? Else it's unlikely that most users reading the doc for the option will search for "shell commands" in the Emacs manual. Most users have likely heard of shell commands, but it's not at all obvious that nonprogrammers etc. will realize that mention of shell commands in a description of this option will likely be of use to them for associating files with apps. That's the purpose of this option. It would be far clearer, and far easier for doc maintainers and users of the doc, to simply add a brief sentence or phrase to indicate that "shell commands" here covers programs in general. I've said enough to get the point across. If you don't want to fix this because a user has the ability to go to the Emacs manual from the doc string or from the Dired-X manual, and look up "shell command" in the Emacs manual, fine.