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#52337: 27.2; Doc string of `dired-check-process' Date: Mon, 6 Dec 2021 20:55:57 +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="36900"; mail-complaints-to="usenet@ciao.gmane.io" To: 52337@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Dec 06 21:57:12 2021 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 1muL2t-0009Lf-K1 for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 06 Dec 2021 21:57:11 +0100 Original-Received: from localhost ([::1]:52532 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1muL2s-0007j3-AC for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 06 Dec 2021 15:57:10 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:43196) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muL2k-0007ik-UZ for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 15:57:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52220) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1muL2k-0004aX-MS for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 15:57:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1muL2k-0000Rj-M1 for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 15:57:02 -0500 X-Loop: help-debbugs@gnu.org 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-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.16388241671645 (code B ref -1); Mon, 06 Dec 2021 20:57:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 6 Dec 2021 20:56:07 +0000 Original-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 Original-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 Original-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 Original-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 Original-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== Original-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 Original-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 Original-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= Original-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 Original-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 Thread-Topic: 27.2; Doc string of `dired-check-process' Thread-Index: Adfq445s4m/XIhYOR8ulw8vDNHGH+A== Accept-Language: en-US Content-Language: en-US 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+sUIQjSIW8vYBiYFSszPdfX6whLmZWf3gUnGcThDvv4B6LwupP470WoQi8qYwvVI2TER9bxmEQNG2GTgnuZ Qd6yUPHFxeGQrxfQOUZMJLntcHdNiz8p22ROWBcnt4NQQVyE64SlqbjQbF96kiSYbSFPv0TKTOjM13DbAWlLu+u/Me6pmDR/IO 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-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:221788 Archived-At: 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''