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 16:08:11 +0000 Message-ID: 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="26578"; mail-complaints-to="usenet@ciao.gmane.io" To: 63875@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jun 03 18:09:16 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 1q5ToZ-0006hl-Sx for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 03 Jun 2023 18:09:16 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q5ToO-00040P-CW; Sat, 03 Jun 2023 12:09: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 1q5ToM-000408-Ku for bug-gnu-emacs@gnu.org; Sat, 03 Jun 2023 12:09:02 -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 1q5ToM-0006Ll-Co for bug-gnu-emacs@gnu.org; Sat, 03 Jun 2023 12:09:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1q5ToM-0001XD-76 for bug-gnu-emacs@gnu.org; Sat, 03 Jun 2023 12:09: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 16:09:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 63875 X-GNU-PR-Package: emacs X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.16858085065853 (code B ref -1); Sat, 03 Jun 2023 16:09:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 3 Jun 2023 16:08:26 +0000 Original-Received: from localhost ([127.0.0.1]:44151 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q5Tnl-0001WK-FM for submit@debbugs.gnu.org; Sat, 03 Jun 2023 12:08:25 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:59674) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q5Tnh-0001WA-AB for submit@debbugs.gnu.org; Sat, 03 Jun 2023 12:08:24 -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 1q5Tnh-0003w0-3p for bug-gnu-emacs@gnu.org; Sat, 03 Jun 2023 12:08:21 -0400 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q5Tnf-0006Ab-1G for bug-gnu-emacs@gnu.org; Sat, 03 Jun 2023 12:08:20 -0400 Original-Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 3533vrvu013545 for ; Sat, 3 Jun 2023 16:08:15 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-2023-03-30; bh=uSPhyLzEYn0BBCG+DW0nu9ogM6GHhPWb3RPaN5ewi48=; b=AoK1ALHvJ9FVa3dk6LOH8ZxNQyu60kpkjj4UHNi4QSMq2TKJcmPjLbzm2UwytFh+njYC W/CoBIDK52vpI9kYxhD4YW+s5mpyHLsRdL8RgSEkRUceXbF8OwfGOOssK6J/8oaFJDvI k6VkWZqI4W8HlUn6xkiBtj0E38aus1xCJgViYJCVD1uLmDM9u3MPQYbyeMtfyHRkrkIZ h2P2VIPCtN2+ATmjUxQd6inn4NkfVRqgOtYviqr1NOe6YTtgIEwe5oYRVKHJczU6+cyQ A47x3mQIsd6jwVvW492cPphWHGpd1BbqKDMxA1p63TLHwIlWbELVKbGABzMV6/NE0zZI /A== Original-Received: from iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta02.appoci.oracle.com [147.154.18.20]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3qyx2wgmcb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 03 Jun 2023 16:08:15 +0000 Original-Received: from pps.filterd (iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 353EbACH006688 for ; Sat, 3 Jun 2023 16:08:14 GMT Original-Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2102.outbound.protection.outlook.com [104.47.58.102]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3qyuy7vq9u-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 03 Jun 2023 16:08:14 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ldmO8sjt89YbUv5cJYGt09OaOzpY1ZKi175KtcIlQj6VNQAlzXTWYw6y1Qo2WErwGsekBpO1PapyltbQj11TXm7CvRbPydvJCavlhd68YUV4md6MQW7zMykb5GKtAqltwrXKU6kyALnd6ORsCX1YgGSxOD26qjE0OqPpxwr55lEhrIJdEucqrYBvTESlvmFpvrI7npB7QKJ5v1v0EPdl4nvHD3fS5LqhclE/Vcfk2Rkym8bIADVKEQSTvTLOKKs8n2LyauJCVY5QlEto+AkY4CqHIFwYWQE7/NH/u48qQPNnWk0c69PeSDW+iogQg0mM6VR4y3Tm4WGbvodXVVW3Cw== 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=uSPhyLzEYn0BBCG+DW0nu9ogM6GHhPWb3RPaN5ewi48=; b=IcxMlnJcy7LZay49NpcF+keGeIkng5x6Hj6VZJU/bQgH55disvTjmOL1q446+weCPgTUAAg9Sr+FJSGQLcZsGs+Y0yoN6ThXbMvTu0VBt/YYfreubHmDhGeaw6O90wstY8IfTZwEt2UIbX9OYYLtiQgcPaB4uyy0Kequ98/hqFmbRI6zEGla+qdeBh8j5rfARuVaj+BirGRKt2BzWQENaT8ePwyAJSi/+nmaEVHDypNkyGUOLGsagCLA3wuweb+6sneXJB1/3Tuj08NiRSMgksalSYonJGS9vEI3pWI/gQO1O4O27q78+uE065jrVs1Na2bxU6darLaBAHVJsyxRfg== 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=uSPhyLzEYn0BBCG+DW0nu9ogM6GHhPWb3RPaN5ewi48=; b=rXkVtuNkHG+6p7ZKpuGFgf3rC2ZLulIh88Y12MZb5GFRH96Cw5FCvEAgctjXHiiUyD1bE1qQkO/UmRGHSulAv/+2Uyy6VMyx7Fd06Xj7+NcVgN9NL95atjMRdemYY/QE4O9TBuRC7wN8n8gogCqIXn6OHhM61aMDXnx76zg71LM= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by IA0PR10MB7372.namprd10.prod.outlook.com (2603:10b6:208:40f::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6433.24; Sat, 3 Jun 2023 16:08:11 +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 16:08:11 +0000 Thread-Topic: 26.3; Doc of `dired-guess-shell-alist-user' Thread-Index: AdmWNY+dxb5wBdnXSBqE4C10rz9qGA== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|IA0PR10MB7372:EE_ x-ms-office365-filtering-correlation-id: 301a6814-7711-44bb-a460-08db644cbab0 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: sGc4T7qGgIv0ZWN1ffWfZ2OYwqRaswMPjAnjgevlVYYdGXaoYCkLhYkvZp2tjkGl9BTZ23gQnzOzftQa16vyEphMcWUAefUt+hVcsjp9BLigCGX9MRjjyYNTUyPJZyRlnK3alXCxDuRo4km8dQ1cQxn7qAKdlx4BoVT5hbQwkMPgPkOtVuTthRQ/qhUZWABIdIpwiF4ezrNfwsWRfyiSHDz/3gaBxicJJ6QMpUmESXwpDroPN4DU4rfc6RnOmy8b+59h2Gc1O3SBf5uCqXfX9FxxvLhWhvoY5Tz8i2fSWa3h3WC5YPXuwYsfFHNTzaMQ6HxBXwBzlU++RAZb636TlFQi4pprqZiKLHW5ymRd4rWleMEJxq4rg1s61SPfe814Wuawsj0kxhBb8YrmDCw7CZme524NtNPNcISauA08Lvw27WaUGBxrDR/oZy9nPCosOwfEDYXBZDExu6l3kalc4KT9ETI05G3+if0RvtwJIQ4h8JNvVop9Ul4AKP6IEUbthcXqzktOxv+tZ8Be91V5C9qHtMoqA4tj2Bb6NvNGcxepaJwcbOVnWQZSI8ZYkjnJ7yr0wCSB3o0Bx4QW/DwsMvzuHAi4Aao5lagc8KCRdJVfMb90CJyiLbk/oGmuQ9Xs/UHCqaf7C751/vVDPTxdcw== 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)(136003)(396003)(39860400002)(376002)(451199021)(52536014)(8676002)(55016003)(7696005)(76116006)(66556008)(2906002)(66476007)(66446008)(64756008)(26005)(71200400001)(6506007)(6916009)(9686003)(45080400002)(66946007)(186003)(478600001)(86362001)(5660300002)(8936002)(33656002)(38070700005)(122000001)(41300700001)(44832011)(38100700002)(316002)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: T9J00SHh/zJoSinZu2lsAe86wUAG6cNBXATRexyKWFzDvqyW/tbIojKdqZH1WilmuAmIu4+zDhtD8+4vJnqXJP0zna6pqvVlAK3XKDEmUUkpp70fFB4oR6M34ZI5DGD9GFgCPXcpJ5iSx5j5TIlaucitHO2kqt6XXWGDgsKp9YdE4nuAukG6+XxJCOjHvFM8LYmFL0xCSS5JWWbRMUoYOi+XLesroHAGqH+z6HzMB3Qw7MC/qm8Pg3N1QqEpbFwVyUBd9LAP0vy83qowaK7Z0SEim5Qr4cus9+JWic248EUTTUKNrD9i9m3GObwOf9NqmdoQUqIeKYATWeeVnzn2ggIJ1z2Zvi+CFmaQ0L6x9AZwrkkGbcW/9yqTMO5Ed7okU9b06NbGEkHRhbuuSAyH80eRxO4G85JrLoTvY0onLnQk677ofdIz5c6rodCd8NLz19X7rGTDRfnEjLy3R8/ISWPo0Lto9CP565qAdA9+5ZgcOqGvO8091wos+zEHvjBaqR7WYcqgPdOc3rTlYkFlBe9d/BGUo0MIuWhVy2gnfx1NEDlwvbZSEeR2oo40b+eg5K/KuqitsiVA+iWPoeV9oozA0wSbHfxGvTPx1N07pli+oE6TgyiLM4Op/9ZLbs8UJhFX8saY8DR+HbwXYxjiGMmoYW4QhKK9ozHcwBKsMjVRkAIPO/QYviPi4joSpEl7/Bqvz74TuHcLc7i0fJsdY2amk9H7lQcoWyjOm73Id9SU2t6qpGgcz+HmZe qxv5C/fQ7Thm9v6+2/yiDrPD/FdmVTdZo3CXJLkS4KdvB6NcXt/7Jg6epQdU5/daYXTwuLAdtMe+118xK/gZiQo0B3QlgieNBh X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: obpT+T6omjD3i3CRHxI190aBX3uHJ2r/V2Us0hwF0e4hDHiSg1U20hCFTDRH+9r0Z5PWtEtacu0gQIVCDbQaM77M9U1WYu10ZOd7XNmS72CBI63zcMWrHj0wA6DERp4G6i7kVdvAFZR/kbqX6xzmWNNQRhdu9+xKDXU3qhCTIxuer9lSRIkMKdeZkc4zhZ3sQVflPEq3hYVIRIYn/4UCLQ4FiFIUd36vgbmr7DWx81wguWK8EONF1n70U2C5yTweMQDa5YQUwmBFQpSZcXITihCb6Fce4a6qzEjQr+eX1EMB6w5u8evFQoLBxHKWHdETNNREiHo9INzO9IzjcBSMOLwYYWSldxnsuhjITZ5WHWZPiSXfC/VjW89aSYdE3bBl1jmEdQpJf+vJDIW8lURqDRRuoyXF+IcpEVsdl+odSVb5IL0HqRjfdsefvf/uQ2UZdt9M2/sMOHYJOnqGD9o8yqlvSlLXCn9ZF/MMPYK82OX5+qxwlRcK3/JOQ1zKnICjxozxhFPE5TukOQcBULq03e1qgyTnCyBDdTB/V0lmXsrrPz9ApaTxWv3xTyLjdXhaRb6g8Nf3h6jazq/YDUDMVyWHzoMSwqIETZY3ONH5ysn0WkWYOhfeFG66cm/1j+im9f251CfnVctONv9Lnb/CS6ZFcdaC/aFLJ0JUHI5h+nxP+1VQjpa2fnt0brINPKG1mDtD7q8CSYQyxK6Ma3aATYNJrfEzoRGBpWxZv27+k8Y= 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: 301a6814-7711-44bb-a460-08db644cbab0 X-MS-Exchange-CrossTenant-originalarrivaltime: 03 Jun 2023 16:08:11.5327 (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: UCePjMkxO3r7wO4oOBl3HX1UdUjX4TbLkr9vCWJsZ8Arv7ZlTQhnNlObEGwzu+yCnICEUGfoS7J+6U6hkoeIAA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA0PR10MB7372 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 spamscore=0 bulkscore=0 phishscore=0 suspectscore=0 mlxscore=0 malwarescore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2304280000 definitions=main-2306030148 X-Proofpoint-GUID: HgoUi2GKlXwGWVULPfZdslLzSe3sbRJb X-Proofpoint-ORIG-GUID: HgoUi2GKlXwGWVULPfZdslLzSe3sbRJb 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_H5=0.001, RCVD_IN_MSPIKE_WL=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-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:262866 Archived-At: The doc string doesn't say what REGEXP is, e.g., what it's intended to match. It should say that up front and explicitly. Manual (dired-x) `Shell Command Guessing' sort of says it, if you read carefully and guess a bit. Please say explicitly that REGEXP is a regexp that's used to match file names. And say how the alist entries are used. All that's said, so far, is that this is a "User-defined alist of rules for suggested commands." Rules used how? What does matching file names have to do with using a command? Again, the manual does say this somewhat, but not the doc string. The doc refers to `dired-guess-shell-alist-default', but the doc for that variable doesn't explain anything, so it doesn't help with the missing info for `dired-guess-shell-alist-user'. FWIW, the comment in file dired-x.el that introduces these variables describes them better than the doc in some ways: what they're for, how they're used. 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.19045 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''