From unknown Sun Jun 22 07:54:58 2025 X-Loop: help-debbugs@gnu.org Subject: bug#52337: 27.2; Doc string of `dired-check-process' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 06 Dec 2021 20:57:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 52337 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 52337@debbugs.gnu.org X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Received: via spool by submit@debbugs.gnu.org id=B.16388241671645 (code B ref -1); Mon, 06 Dec 2021 20:57:02 +0000 Received: (at submit) by debbugs.gnu.org; 6 Dec 2021 20:56:07 +0000 Received: from localhost ([127.0.0.1]:35533 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1muL1r-0000QS-9r for submit@debbugs.gnu.org; Mon, 06 Dec 2021 15:56:07 -0500 Received: from lists.gnu.org ([209.51.188.17]:54134) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1muL1p-0000QJ-RR for submit@debbugs.gnu.org; Mon, 06 Dec 2021 15:56:06 -0500 Received: from eggs.gnu.org ([209.51.188.92]:42918) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muL1p-0007dm-EE for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 15:56:05 -0500 Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:33026) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muL1m-0004Ib-Lk for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 15:56:04 -0500 Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 1B6JhUSc010269 for ; Mon, 6 Dec 2021 20:56:01 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=+QtoiGnpAsYzmwd0/IDxgKPXHcT9d7lMGEGEujuyJ0o=; b=aQjtNg1ilm5b2NTEPB5ygZPb9h7e36DXUW6bEhkpOtKaSIojSVYvTCZbbTJdL17zEpLl 7ySRwiDXwKGM0VQBN+gHSJOG46jWCRkahct8BnusryT3nFv+umA2UDknQR5xX636QSfM VVpGI9Q9WIf6QK765p5O/jSdmdNBALtK89Uh09x/aM0QcX2GuF0Cus5294FncMnc8sZ9 NuMXHxFixsZVgcBETxEp9eKHAHLU7ww5+MHi80lXd4j43KdUQT4zX3H3AM/F+J5O4+9r QkeqgtmNbXakb8CNDgw+CAXZ0krpgG/3oYV0ItGfZMudvhWNVmhAOSPdzLdwLfxb269r UA== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by mx0b-00069f02.pphosted.com with ESMTP id 3csbbqku74-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 06 Dec 2021 20:56:00 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 1B6KV8nK109693 for ; Mon, 6 Dec 2021 20:55:59 GMT Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2103.outbound.protection.outlook.com [104.47.58.103]) by userp3030.oracle.com with ESMTP id 3cqwewm5f3-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 06 Dec 2021 20:55:59 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=UZQW/qscmO6pDvx0D2JhlNk53XUy6RuBeTwI06ro+Q8dC4+iA6AV8rZd64bFVDcy5IWsF7cof0O18mEg4Z1D5g4jWaJn6ujlSq2oZyJZCYgqVX5A7tcApe3lvaRd3wD7tQw9fDgfuVFsqZf2UXawBKMY7Tw6dg8uDQKNeUsDEJwdvf6+ApKOHn0bKAM4muDRyeTHJJVq9IhVE6TIGgIrY08dX7nVeTspWptaTMuX0QRUKmsyjKQpsRwVfGaDf1/Zq3zpSKOKPPAlkOXNdWoICZARrq25Gvwpozzauj79UJ75zqj5CPiG1TkGa8JWUPXJXJxbnXPjzvB1vgRhrzocHg== 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=+QtoiGnpAsYzmwd0/IDxgKPXHcT9d7lMGEGEujuyJ0o=; b=EU8fB+P24CIjBOOwE2lWSik9DgircqwH+vIgJ+F4VPcszO1cTIvHHfrRbK4J16j0OGMstuwBT4xEVf1WYq1w/TL0stLflsz8oWZGP4SlzztYp+dBv2+dL9ws+TUf65nmAnIhvn4bUjCUjPW+PS2l2KpH6YUXLwXhKjlxo2oX+YtsHyguJ21zaW8x4C6R3A2BbFkx4xItbuUi/lejO+Qo/gvQqmRQ6eJtCV0850nNqRaXWB/URV/WIvU7bGL9BErWatKl/5n5D2z7xAo+STwTaG/tjw6aW4xFGu07uGEVnQ8FECu1SGXdxFVhlKEhxILbzjQNqJA9Xafhr5o+DabQ8A== 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=+QtoiGnpAsYzmwd0/IDxgKPXHcT9d7lMGEGEujuyJ0o=; b=mVBYau7E44eLKIn4hs6N7/cJDGrGX02xuXPpOSJ5CnQ4i5n5SgQp22Sx60eFpvbcm10lfCpE9Cwm7Px/pu0AlKfGg/qqzQvqfH44Y5W374ZFAi1NZ2BSwpQB0ecEURRnMLMn8+HDTQ5k7h3D0+AiWVml2RSIRzxbY8LXDpECWOM= Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BY5PR10MB4035.namprd10.prod.outlook.com (2603:10b6:a03:1f8::33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4755.21; Mon, 6 Dec 2021 20:55:57 +0000 Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0%9]) with mapi id 15.20.4755.021; Mon, 6 Dec 2021 20:55:57 +0000 From: Drew Adams Thread-Topic: 27.2; Doc string of `dired-check-process' Thread-Index: Adfq445s4m/XIhYOR8ulw8vDNHGH+A== Date: Mon, 6 Dec 2021 20:55:57 +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: 9314af0f-5d8b-4263-89bc-08d9b8facd83 x-ms-traffictypediagnostic: BY5PR10MB4035:EE_ x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:6790; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: VS6s38qL5Mo3rwP4IdUUgfVj7O+RfaoMh1sIZDHnMgOdtgtkhy/FUkiSeoJPDuMwqJKySqjCjQFi2JCqvM9jCTeEgVUDNCtlABnwMKrlTSCPwc2Jn4pPWMBvkhO3X82ifnZ03yCBIBOgudet2OdcQuX88mfwydCb9IVpl65RlmBJk6NgVN+qSahdMM8tftaZc9mHEOcSchXcXUWeTuYCF3bk+L/f6tSnY7S2FlfmNhhwFRN+jI0oeUUg/7hkgfsWX1aKZSzhqd1hvkiyLRyV63NyEViOAaMUBy50GWvAjSUYes/VxROXY9ma82I6OUbXv77H20ikW/6Ua9u8QrmWvjD7QxYG7aS6AAjC+3F39DqriSmWnETkjasIgK0zTEYvEkVGK/bQDwH9djIdLHE8NXmZTbWMXdESdYm3YO/DhxOU+ijmoyhAlNuaxEi1KRggi6x/+a4hiBS/iRQhiEC5hzXyaFxiu94qCTeywOrijkouUCFCHgToAkLT8SF2PCpoKa6mdg2h8tQw6LHoxXPWtbf/IPoPjwDsNg1ez3cGSJTB9GDDeeJqc3RZ8VkI6EeczSd8qeTJd6JPXCIffm8cMHEQPNOxZUofJoIt3FiQL7/B+boWw8d64xj0887+XYoaT56ZiLW1LJDH0XCfGwzbxgDYxN84S2BlZWCkFL+RmVxV/BzgLadqkxRxtRmazc89ghOi0mhQjZHS0IUhyXboZTXFLCFNQzBuBCWOGkWHczQ= 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)(7696005)(52536014)(8936002)(316002)(86362001)(8676002)(38070700005)(38100700002)(4744005)(44832011)(122000001)(33656002)(55016003)(5660300002)(26005)(2906002)(66556008)(66476007)(66446008)(76116006)(71200400001)(66946007)(64756008)(45080400002)(186003)(508600001)(83380400001)(9686003)(6916009)(6506007)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: 33nD3n4rzg6RoncWvv/gTCnzRaR2z+57FJdwHmN7uNHVTkaMcOyrwHp4YdFxCt3rGM5nVNrHJK0F6DPZ/KqocTpSGorXAjBvpULxij2kxLip6bJzl9b8qENztA2gBzTsyRWGLr2fapp+BoSpYN7mcsiUyL9/3cjG1EQrnxRif50yujtmqe0kH/gIWafDZ8uvsnN1joMTPSaCScA1gZSObPLWFc89AyQph0IUXbMyYv/MWv4QPYpPWy//4l+ILa0ztOslipYp7/JjDkXs1IbGZIxbr9cCSBNwBKSdDDV4+ms7IRafNCTaT/KPCVmQw4s5TQYfHlFPUSb2Bnk4ET1udywybcRZs1o/0vjqbi7epszIdXK5wKkfahfQzxiE1qct5S8PpfsUguHnSKBlzi1FKZEgy/vCBUg83X8JxzAtZMOQl6UHoreiHW7dUg5kbsJdtj3Au9hk/rVz693ZUUpB/s1SPPqJ0JerAgRoZ3YiLiJlQ+TDR+/AOEmTQvTQTWSxKnBctzGAeVVd93JH8t/tvogmO2kJ0NgFQNyZBRl3G802dNt/WkTYUeqcb3Exz082kpouWIY25D8VQz3MnarIDuKk9mCyhGgTl5JMUspjOBAv3B2lrIrYe1ACzlqp4xD1tyTklrCjoBxHwdcKSptAnoAzSYsKkCGsi8UOI1P+sUIQjSIW8vYBiYFSszPdfX6whLmZWf3gUnGcThDvv4B6LwupP470WoQi8qYwvVI2TER9bxmEQNG2GTgnuZQd6yUPHFxeGQrxfQOUZMJLntcHdNiz8p22ROWBcnt4NQQVyE64SlqbjQbF96kiSYbSFPv0TKTOjM13DbAWlLu+u/Me6pmDR/IOeUclebcyEfRx7dUd8GZ+RDGDf9b68Nf3jLShUPi8BAujPzdMawGnBZbqfXjs7KqNnGx2zsS1hlPSAawxhXeeyL9fWhk62p31EHaUDuXaQANquDz1MqLtBdqe7XSdSzJPTmKmlA5E8v2i8bjVk3teY8lgvmddrKwFVfNglfOiaABUZAnrNaZsQcCEYv4oDLQEsozY9WlBvYsanujA1FdWbl3CiTCMLjpaQuFm+Wsz9AHHo9UU+svcecAeV/Ba3ctYYZqyZ59YFQlhOjyTo6Fmj8QfdalLMEyVznoI/ZBYmfG96dWjFBgK257u0PsSmE/uvO+HdKeTgOcuDV6yGr5FwJWPZe+qJPu2nuiAHiLmbbPtSaVs2dJFPDnDlWx3LgGxlckgUOKfnDo/5gM08GUxtAHqOIVH3A2ykhXTMqFWY+h2uCPra+70zU/E0pOyYb+kimEL7vNQaMJgmM6bP63An6scRYDJRGLxN/r6snHENMLA5cMIKjObq0j9aQq5rfNcImBuMV/J/RAJG0pen1QWNLqBf5sRRvaDltbpI3k65LR/7+Dk97z/xTkrbhWROjZDLDev1jDyeiiQ8xJuUSmek+nJraKPMgp9c1qE9kpPyWyJdlGSzEboqaxAzeKavNELddSIUGZxkbwP84/J3DJIDmPWA6yeomBx3d6v1fBiYBbLvStEKylh6GO8Ve7VLaZ39FEG7fvc0yG3NDlFmxryAQc+uYFLqB0/6vs6r4jebCyZlx9pMDff2SgDFQ== 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: 9314af0f-5d8b-4263-89bc-08d9b8facd83 X-MS-Exchange-CrossTenant-originalarrivaltime: 06 Dec 2021 20:55:57.7546 (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: 1jiALkv0zcMAwcvZtYN7koD1gxq/hfl7DUbstkiQ2j7aViwkB6iNREEUMVG/4pqZlToMQOsBaD090K627NYlHQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR10MB4035 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10190 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 suspectscore=0 adultscore=0 mlxlogscore=853 bulkscore=0 malwarescore=0 mlxscore=0 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2110150000 definitions=main-2112060126 X-Proofpoint-GUID: gd8irREYLFvJaRWQ5bAi6e4LIEXaCGq4 X-Proofpoint-ORIG-GUID: gd8irREYLFvJaRWQ5bAi6e4LIEXaCGq4 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 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) 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 (--) 1. Please consider filling the third sentence ("On error,..."). 2. The "Else returns nil for success." isn't too clear. Please consider making it more clear that the return value is nil for success and either ARGUMENTS or PROGRAM for failure. It's also not clear under what conditions, or when, ARGUMENTS is returned or PROGRAM is returned. "Offending" doesn't help in that regard. Is it possible for both ARGUMENTS and PROGRAM to "offend"? In GNU Emacs 27.2 (build 1, x86_64-w64-mingw32) of 2021-03-26 built on CIRROCUMULUS Repository revision: deef5efafb70f4b171265b896505b92b6eef24e6 Repository branch: HEAD Windowing system distributor 'Microsoft Corp.', version 10.0.19042 System Description: Microsoft Windows 10 Pro (v10.0.2009.19042.1348) Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Type C-x 1 to delete the help window. Configured using: 'configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static'' From unknown Sun Jun 22 07:54:58 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Drew Adams Subject: bug#52337: closed (Re: bug#52337: 27.2; Doc string of `dired-check-process') Message-ID: References: <83sfv4xq55.fsf@gnu.org> X-Gnu-PR-Message: they-closed 52337 X-Gnu-PR-Package: emacs Reply-To: 52337@debbugs.gnu.org Date: Tue, 07 Dec 2021 17:49:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1638899342-24608-1" This is a multi-part message in MIME format... ------------=_1638899342-24608-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #52337: 27.2; Doc string of `dired-check-process' which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 52337@debbugs.gnu.org. --=20 52337: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D52337 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1638899342-24608-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 52337-done) by debbugs.gnu.org; 7 Dec 2021 17:48:30 +0000 Received: from localhost ([127.0.0.1]:38550 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mueZp-0006O5-S3 for submit@debbugs.gnu.org; Tue, 07 Dec 2021 12:48:30 -0500 Received: from eggs.gnu.org ([209.51.188.92]:52338) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mueZm-0006Nq-Am for 52337-done@debbugs.gnu.org; Tue, 07 Dec 2021 12:48:29 -0500 Received: from [2001:470:142:3::e] (port=51282 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mueZg-0003vD-Rx; Tue, 07 Dec 2021 12:48:20 -0500 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=cMg+RYD8GbAsz1Tda40djimHmUaQHqVaBwC2NMZDbjU=; b=CkpCbh9kVaKW 7lHFlAj2ta7JHOqhh40wTmsWuSwVLQGwZm3+LXlGHopd4f0nfPyBPtxaD3LYF9OD1cc2z8JCT6Ihh mRPo9Of0ekWmL7OKew6Qfl9EUhejZc8yJAmKu3Dr3a3fQ7hFYpU+iwjSeZ2EI0IEpjx0FJCkCjjgg JFrrVm1/nBbyXDlL+a+iqen07yP2v4RVHr3kqOqFnYEHfqHQNpT3StpGD5tPVTch8jRawRxwUCvUX aMWovX9fDG5K/XB2/kNgBLpjycR/STgnWLeN/dTGhIlTeLpv6JGA1mF36V/JnXT1ieQScJkl6PEg0 5udHpemkp2zPzeUH6yj2zQ==; Received: from [87.69.77.57] (port=1676 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 1mueZg-0003pE-Kr; Tue, 07 Dec 2021 12:48:20 -0500 Date: Tue, 07 Dec 2021 19:48:22 +0200 Message-Id: <83sfv4xq55.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-Reply-To: (message from Drew Adams on Mon, 6 Dec 2021 20:55:57 +0000) Subject: Re: bug#52337: 27.2; Doc string of `dired-check-process' References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 52337-done Cc: 52337-done@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: -3.3 (---) > From: Drew Adams > Date: Mon, 6 Dec 2021 20:55:57 +0000 > > 1. Please consider filling the third sentence ("On error,..."). > > 2. The "Else returns nil for success." isn't too clear. Please consider > making it more clear that the return value is nil for success and either > ARGUMENTS or PROGRAM for failure. > > It's also not clear under what conditions, or when, ARGUMENTS is > returned or PROGRAM is returned. "Offending" doesn't help in that > regard. Is it possible for both ARGUMENTS and PROGRAM to "offend"? Thanks, I fixed this on the emacs-28 branch. ------------=_1638899342-24608-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 6 Dec 2021 20:56:07 +0000 Received: from localhost ([127.0.0.1]:35533 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1muL1r-0000QS-9r for submit@debbugs.gnu.org; Mon, 06 Dec 2021 15:56:07 -0500 Received: from lists.gnu.org ([209.51.188.17]:54134) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1muL1p-0000QJ-RR for submit@debbugs.gnu.org; Mon, 06 Dec 2021 15:56:06 -0500 Received: from eggs.gnu.org ([209.51.188.92]:42918) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muL1p-0007dm-EE for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 15:56:05 -0500 Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:33026) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muL1m-0004Ib-Lk for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 15:56:04 -0500 Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 1B6JhUSc010269 for ; Mon, 6 Dec 2021 20:56:01 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=+QtoiGnpAsYzmwd0/IDxgKPXHcT9d7lMGEGEujuyJ0o=; b=aQjtNg1ilm5b2NTEPB5ygZPb9h7e36DXUW6bEhkpOtKaSIojSVYvTCZbbTJdL17zEpLl 7ySRwiDXwKGM0VQBN+gHSJOG46jWCRkahct8BnusryT3nFv+umA2UDknQR5xX636QSfM VVpGI9Q9WIf6QK765p5O/jSdmdNBALtK89Uh09x/aM0QcX2GuF0Cus5294FncMnc8sZ9 NuMXHxFixsZVgcBETxEp9eKHAHLU7ww5+MHi80lXd4j43KdUQT4zX3H3AM/F+J5O4+9r QkeqgtmNbXakb8CNDgw+CAXZ0krpgG/3oYV0ItGfZMudvhWNVmhAOSPdzLdwLfxb269r UA== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by mx0b-00069f02.pphosted.com with ESMTP id 3csbbqku74-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 06 Dec 2021 20:56:00 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 1B6KV8nK109693 for ; Mon, 6 Dec 2021 20:55:59 GMT Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2103.outbound.protection.outlook.com [104.47.58.103]) by userp3030.oracle.com with ESMTP id 3cqwewm5f3-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 06 Dec 2021 20:55:59 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=UZQW/qscmO6pDvx0D2JhlNk53XUy6RuBeTwI06ro+Q8dC4+iA6AV8rZd64bFVDcy5IWsF7cof0O18mEg4Z1D5g4jWaJn6ujlSq2oZyJZCYgqVX5A7tcApe3lvaRd3wD7tQw9fDgfuVFsqZf2UXawBKMY7Tw6dg8uDQKNeUsDEJwdvf6+ApKOHn0bKAM4muDRyeTHJJVq9IhVE6TIGgIrY08dX7nVeTspWptaTMuX0QRUKmsyjKQpsRwVfGaDf1/Zq3zpSKOKPPAlkOXNdWoICZARrq25Gvwpozzauj79UJ75zqj5CPiG1TkGa8JWUPXJXJxbnXPjzvB1vgRhrzocHg== 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=+QtoiGnpAsYzmwd0/IDxgKPXHcT9d7lMGEGEujuyJ0o=; b=EU8fB+P24CIjBOOwE2lWSik9DgircqwH+vIgJ+F4VPcszO1cTIvHHfrRbK4J16j0OGMstuwBT4xEVf1WYq1w/TL0stLflsz8oWZGP4SlzztYp+dBv2+dL9ws+TUf65nmAnIhvn4bUjCUjPW+PS2l2KpH6YUXLwXhKjlxo2oX+YtsHyguJ21zaW8x4C6R3A2BbFkx4xItbuUi/lejO+Qo/gvQqmRQ6eJtCV0850nNqRaXWB/URV/WIvU7bGL9BErWatKl/5n5D2z7xAo+STwTaG/tjw6aW4xFGu07uGEVnQ8FECu1SGXdxFVhlKEhxILbzjQNqJA9Xafhr5o+DabQ8A== 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=+QtoiGnpAsYzmwd0/IDxgKPXHcT9d7lMGEGEujuyJ0o=; b=mVBYau7E44eLKIn4hs6N7/cJDGrGX02xuXPpOSJ5CnQ4i5n5SgQp22Sx60eFpvbcm10lfCpE9Cwm7Px/pu0AlKfGg/qqzQvqfH44Y5W374ZFAi1NZ2BSwpQB0ecEURRnMLMn8+HDTQ5k7h3D0+AiWVml2RSIRzxbY8LXDpECWOM= Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BY5PR10MB4035.namprd10.prod.outlook.com (2603:10b6:a03:1f8::33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4755.21; Mon, 6 Dec 2021 20:55:57 +0000 Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0%9]) with mapi id 15.20.4755.021; Mon, 6 Dec 2021 20:55:57 +0000 From: Drew Adams To: "bug-gnu-emacs@gnu.org" Subject: 27.2; Doc string of `dired-check-process' Thread-Topic: 27.2; Doc string of `dired-check-process' Thread-Index: Adfq445s4m/XIhYOR8ulw8vDNHGH+A== Date: Mon, 6 Dec 2021 20:55:57 +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: 9314af0f-5d8b-4263-89bc-08d9b8facd83 x-ms-traffictypediagnostic: BY5PR10MB4035:EE_ x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:6790; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: VS6s38qL5Mo3rwP4IdUUgfVj7O+RfaoMh1sIZDHnMgOdtgtkhy/FUkiSeoJPDuMwqJKySqjCjQFi2JCqvM9jCTeEgVUDNCtlABnwMKrlTSCPwc2Jn4pPWMBvkhO3X82ifnZ03yCBIBOgudet2OdcQuX88mfwydCb9IVpl65RlmBJk6NgVN+qSahdMM8tftaZc9mHEOcSchXcXUWeTuYCF3bk+L/f6tSnY7S2FlfmNhhwFRN+jI0oeUUg/7hkgfsWX1aKZSzhqd1hvkiyLRyV63NyEViOAaMUBy50GWvAjSUYes/VxROXY9ma82I6OUbXv77H20ikW/6Ua9u8QrmWvjD7QxYG7aS6AAjC+3F39DqriSmWnETkjasIgK0zTEYvEkVGK/bQDwH9djIdLHE8NXmZTbWMXdESdYm3YO/DhxOU+ijmoyhAlNuaxEi1KRggi6x/+a4hiBS/iRQhiEC5hzXyaFxiu94qCTeywOrijkouUCFCHgToAkLT8SF2PCpoKa6mdg2h8tQw6LHoxXPWtbf/IPoPjwDsNg1ez3cGSJTB9GDDeeJqc3RZ8VkI6EeczSd8qeTJd6JPXCIffm8cMHEQPNOxZUofJoIt3FiQL7/B+boWw8d64xj0887+XYoaT56ZiLW1LJDH0XCfGwzbxgDYxN84S2BlZWCkFL+RmVxV/BzgLadqkxRxtRmazc89ghOi0mhQjZHS0IUhyXboZTXFLCFNQzBuBCWOGkWHczQ= 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)(7696005)(52536014)(8936002)(316002)(86362001)(8676002)(38070700005)(38100700002)(4744005)(44832011)(122000001)(33656002)(55016003)(5660300002)(26005)(2906002)(66556008)(66476007)(66446008)(76116006)(71200400001)(66946007)(64756008)(45080400002)(186003)(508600001)(83380400001)(9686003)(6916009)(6506007)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?33nD3n4rzg6RoncWvv/gTCnzRaR2z+57FJdwHmN7uNHVTkaMcOyrwHp4YdFx?= =?us-ascii?Q?Ct3rGM5nVNrHJK0F6DPZ/KqocTpSGorXAjBvpULxij2kxLip6bJzl9b8qENz?= =?us-ascii?Q?tA2gBzTsyRWGLr2fapp+BoSpYN7mcsiUyL9/3cjG1EQrnxRif50yujtmqe0k?= =?us-ascii?Q?H/gIWafDZ8uvsnN1joMTPSaCScA1gZSObPLWFc89AyQph0IUXbMyYv/MWv4Q?= =?us-ascii?Q?PYpPWy//4l+ILa0ztOslipYp7/JjDkXs1IbGZIxbr9cCSBNwBKSdDDV4+ms7?= =?us-ascii?Q?IRafNCTaT/KPCVmQw4s5TQYfHlFPUSb2Bnk4ET1udywybcRZs1o/0vjqbi7e?= =?us-ascii?Q?pszIdXK5wKkfahfQzxiE1qct5S8PpfsUguHnSKBlzi1FKZEgy/vCBUg83X8J?= =?us-ascii?Q?xzAtZMOQl6UHoreiHW7dUg5kbsJdtj3Au9hk/rVz693ZUUpB/s1SPPqJ0Jer?= =?us-ascii?Q?AgRoZ3YiLiJlQ+TDR+/AOEmTQvTQTWSxKnBctzGAeVVd93JH8t/tvogmO2kJ?= =?us-ascii?Q?0NgFQNyZBRl3G802dNt/WkTYUeqcb3Exz082kpouWIY25D8VQz3MnarIDuKk?= =?us-ascii?Q?9mCyhGgTl5JMUspjOBAv3B2lrIrYe1ACzlqp4xD1tyTklrCjoBxHwdcKSptA?= =?us-ascii?Q?noAzSYsKkCGsi8UOI1P+sUIQjSIW8vYBiYFSszPdfX6whLmZWf3gUnGcThDv?= =?us-ascii?Q?v4B6LwupP470WoQi8qYwvVI2TER9bxmEQNG2GTgnuZQd6yUPHFxeGQrxfQOU?= =?us-ascii?Q?ZMJLntcHdNiz8p22ROWBcnt4NQQVyE64SlqbjQbF96kiSYbSFPv0TKTOjM13?= =?us-ascii?Q?DbAWlLu+u/Me6pmDR/IOeUclebcyEfRx7dUd8GZ+RDGDf9b68Nf3jLShUPi8?= =?us-ascii?Q?BAujPzdMawGnBZbqfXjs7KqNnGx2zsS1hlPSAawxhXeeyL9fWhk62p31EHaU?= =?us-ascii?Q?DuXaQANquDz1MqLtBdqe7XSdSzJPTmKmlA5E8v2i8bjVk3teY8lgvmddrKwF?= =?us-ascii?Q?VfNglfOiaABUZAnrNaZsQcCEYv4oDLQEsozY9WlBvYsanujA1FdWbl3CiTCM?= =?us-ascii?Q?LjpaQuFm+Wsz9AHHo9UU+svcecAeV/Ba3ctYYZqyZ59YFQlhOjyTo6Fmj8Qf?= =?us-ascii?Q?dalLMEyVznoI/ZBYmfG96dWjFBgK257u0PsSmE/uvO+HdKeTgOcuDV6yGr5F?= =?us-ascii?Q?wJWPZe+qJPu2nuiAHiLmbbPtSaVs2dJFPDnDlWx3LgGxlckgUOKfnDo/5gM0?= =?us-ascii?Q?8GUxtAHqOIVH3A2ykhXTMqFWY+h2uCPra+70zU/E0pOyYb+kimEL7vNQaMJg?= =?us-ascii?Q?mM6bP63An6scRYDJRGLxN/r6snHENMLA5cMIKjObq0j9aQq5rfNcImBuMV/J?= =?us-ascii?Q?/RAJG0pen1QWNLqBf5sRRvaDltbpI3k65LR/7+Dk97z/xTkrbhWROjZDLDev?= =?us-ascii?Q?1jDyeiiQ8xJuUSmek+nJraKPMgp9c1qE9kpPyWyJdlGSzEboqaxAzeKavNEL?= =?us-ascii?Q?ddSIUGZxkbwP84/J3DJIDmPWA6yeomBx3d6v1fBiYBbLvStEKylh6GO8Ve7V?= =?us-ascii?Q?LaZ39FEG7fvc0yG3NDlFmxryAQc+uYFLqB0/6vs6r4jebCyZlx9pMDff2SgD?= =?us-ascii?Q?FQ=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: 9314af0f-5d8b-4263-89bc-08d9b8facd83 X-MS-Exchange-CrossTenant-originalarrivaltime: 06 Dec 2021 20:55:57.7546 (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: 1jiALkv0zcMAwcvZtYN7koD1gxq/hfl7DUbstkiQ2j7aViwkB6iNREEUMVG/4pqZlToMQOsBaD090K627NYlHQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR10MB4035 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10190 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 suspectscore=0 adultscore=0 mlxlogscore=853 bulkscore=0 malwarescore=0 mlxscore=0 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2110150000 definitions=main-2112060126 X-Proofpoint-GUID: gd8irREYLFvJaRWQ5bAi6e4LIEXaCGq4 X-Proofpoint-ORIG-GUID: gd8irREYLFvJaRWQ5bAi6e4LIEXaCGq4 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 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 (--) 1. Please consider filling the third sentence ("On error,..."). 2. The "Else returns nil for success." isn't too clear. Please consider making it more clear that the return value is nil for success and either ARGUMENTS or PROGRAM for failure. It's also not clear under what conditions, or when, ARGUMENTS is returned or PROGRAM is returned. "Offending" doesn't help in that regard. Is it possible for both ARGUMENTS and PROGRAM to "offend"? In GNU Emacs 27.2 (build 1, x86_64-w64-mingw32) of 2021-03-26 built on CIRROCUMULUS Repository revision: deef5efafb70f4b171265b896505b92b6eef24e6 Repository branch: HEAD Windowing system distributor 'Microsoft Corp.', version 10.0.19042 System Description: Microsoft Windows 10 Pro (v10.0.2009.19042.1348) Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Type C-x 1 to delete the help window. Configured using: 'configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static'' ------------=_1638899342-24608-1--