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#55050: 27.2; Doc strings for commands that do query-replacements Date: Thu, 21 Apr 2022 02:46:16 +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="26244"; mail-complaints-to="usenet@ciao.gmane.io" To: 55050@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Apr 21 04:47:19 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 1nhMql-0006c3-B5 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 21 Apr 2022 04:47:19 +0200 Original-Received: from localhost ([::1]:59292 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nhMqj-0005es-Rm for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 20 Apr 2022 22:47:17 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53232) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nhMqa-0005eV-BL for bug-gnu-emacs@gnu.org; Wed, 20 Apr 2022 22:47:08 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54107) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nhMqU-00011K-70 for bug-gnu-emacs@gnu.org; Wed, 20 Apr 2022 22:47:08 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nhMqU-0000ZG-2n for bug-gnu-emacs@gnu.org; Wed, 20 Apr 2022 22:47: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: Thu, 21 Apr 2022 02:47:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 55050 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.16505091922138 (code B ref -1); Thu, 21 Apr 2022 02:47:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 21 Apr 2022 02:46:32 +0000 Original-Received: from localhost ([127.0.0.1]:48004 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nhMq0-0000YP-0Z for submit@debbugs.gnu.org; Wed, 20 Apr 2022 22:46:32 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:40128) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nhMpx-0000YH-Sr for submit@debbugs.gnu.org; Wed, 20 Apr 2022 22:46:30 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53156) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nhMpx-0005bb-M1 for bug-gnu-emacs@gnu.org; Wed, 20 Apr 2022 22:46:29 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:39984) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nhMpu-0000so-A3 for bug-gnu-emacs@gnu.org; Wed, 20 Apr 2022 22:46:28 -0400 Original-Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 23KLbMOo019753 for ; Thu, 21 Apr 2022 02:46:19 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=HX+cCk0R5hwGSgV7QhL4iZXuT6dFVV9cLASND70KBRs=; b=LxaPBTY3jvOeed9MoZTiQEjDkOG9ZJLYTkyzoLtJXhBOOSjOxIBqxOyRESwb4/giELwq UM77suP4es+BqNeSuwWLvGWI/0JN9RiBOaC9SprQAwW8SIskr4BobcHGtVV37k9EbS/g kjfwLMX6QK+HzF4vW98CGeJDBmLlyZ8ySyvzlZNRXKg+tdwNcE1bQSY0PZHqKIvlR9lU iewBjlLhBqZRjee+i+FMSz08icq5fX89FCn/qIfVWmcqjgUwj1O2xHvbIlzu+znJRjLB 5B5pX9LxPrWmkz5qBmKp2kef1vT6Stm/WZN8RjdMP7ZRs4mQBqx+2ToD4XEjmeIa4fiZ BA== Original-Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com with ESMTP id 3ffmd1aumj-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 21 Apr 2022 02:46:19 +0000 Original-Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.16.1.2/8.16.1.2) with SMTP id 23L2PpIl004310 for ; Thu, 21 Apr 2022 02:46:18 GMT Original-Received: from nam10-bn7-obe.outbound.protection.outlook.com (mail-bn7nam10lp2103.outbound.protection.outlook.com [104.47.70.103]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com with ESMTP id 3ffm88tr4f-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 21 Apr 2022 02:46:18 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=l+CT/QpIyVr0FvMmgBJc+NOHZJQ5kzNdOb3jlO/fDe1WwUxSI07UyyCm0SfjWscMbmW5an4wDx18VDx6u0TmAGUrR5jnPc+7L3mrwqhTX0a3HHPPaE1DsA/JV3o3cCbdK8S7Puj4MajCkDj+iK1h+WlxnGk9vfXXAIMwXX2Y7ORpccuzI3PBJsGRx1bUERa+TnUpbL8bKhA+QF0bk8dhLL9nOXonZ37nCreLxqeg7p4jPmUHJA+IlXZIfF+TGa4qbQUQiw8LrhNXZEplv7z2Bp4AqXoxK/siSPqxdeP5Gkz/sw1z6ww6EuDNB22zo7DhqI1xGLmp66WGYB0FrMD3IA== 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=HX+cCk0R5hwGSgV7QhL4iZXuT6dFVV9cLASND70KBRs=; b=Mapr8kcKmdbzikL1xvP5PbDdRoGDejlOWY/NjIqpFrLq+H8/Bzt3MdrXy4TRcP/7eLaFboIfFs51KrbxI/Gfb3W6pqxVV9eNHkJ78hM0h1Vi8NsrydbTfN4q822ywPe6SlBrOZXrNkqcd7LlNnGbT/yNt6tbQjqQCL6JesLl4NlC3Fu0pSaEvVglAc6duEdddpL4eqi3CykSlG0nzrsj9M/cLQLmewBvztEKBFr6sEFaVSQ/q1rQBzYprgMCSCuGTUSGtyNhUoKYfO4w/16ccJngI/vG8zFlladWX9rrG6XvzDYq2hoVQLfQ6GOwZP22ok9A0fb8sBPa0dA0IFCw9w== 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=HX+cCk0R5hwGSgV7QhL4iZXuT6dFVV9cLASND70KBRs=; b=Nsprk1HYMlm/dnqxyMgbE2OTjE64VzE+xpxyXZP8yQfHZY6enG72+Cj0BLTZmTjGQ2kKWZoi6W28cyEgto3H4sYFseMKdTprIwAARKICX26bXwhFMGPobWtJiOdl273b0X/WVHZZwWs5IuQA1gWg+0Lx5C8v7ILyvxFQ5ehRJbk= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by CY4PR1001MB2216.namprd10.prod.outlook.com (2603:10b6:910:43::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5186.14; Thu, 21 Apr 2022 02:46:16 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::a0e7:5f38:ab50:5123]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::a0e7:5f38:ab50:5123%9]) with mapi id 15.20.5186.014; Thu, 21 Apr 2022 02:46:16 +0000 Thread-Topic: 27.2; Doc strings for commands that do query-replacements Thread-Index: AdhVKe98MoVws1hdR2SPIuAUvKLyOg== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: ba60677e-c8f3-4475-79d7-08da23411b8f x-ms-traffictypediagnostic: CY4PR1001MB2216:EE_ x-microsoft-antispam-prvs: x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: u8geW4pd8MpKjOyqNwqAysP4Amg/oPOVW8D5Pk4FP9fYc0pX3hKQSuEMk0dh+CVq1XvCnMJUJkXlDAylQmFS73rjCOVPMNJwK9a4Ej935t5inTpbHBJKvFZnRSHx5ht/iQb6rdzGRZG6hlr4zwBRXoS3lzhma3WrWuxfspv1K4cwHEBdIUgfKeEXeWrUK4ir4TBQquYjQeTME73/M57RCHwB3JImsepOXHG68dY4d668V1QBVWlYyswQYGQO9sosu3aS9J00z5cghQx9aaGb75l5fuAHMaD9E/BaPvy4CzjfexzBO9eKCPhwCar/SQyzt9Cxcoe1LETcBq55jYs2Zsc+7cKK/UBF9rV+VKs3xIaep9BFKOzHLGFHvfUpgtsgTIgVsrUUxEOQ2VWxkCN8kYbcF3qpS40bK2+OVw+HbFeEGvE50ge0WYORx64rz4TdqVENsSelLcttyhHyXLqOfqa0L4soog5yf3+Up0bYzQwSL1rPs0Um9rYEIQzulDW1Aw6yUymi5x2tbqiW9TVB5g8pvd1v2u9QL6ASLgoDkNPeTOmfc0CPLdawsvozfczP6psBELiTJpFQtv58pHZI4LVWx0lGSIkhdqIxclk40A1FA8zpfrx767LVx6pVY0jz7tM/HXMZnoXKOq3vgfDm4hAsAKUs96MZdqo2m8X+MYbzX3/BoVp3FGfHxq/RjZRbEit4K7cFumssdekgRPzLIQAVsN/mLIn4qxtNEDjMdbYaeXW14QbB+0Ysg8NlI cbm34Q+KyC1e+3jQUfXwTxg2YJSktlkfG2hGcEeViFJfqg= 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:(13230001)(366004)(508600001)(66946007)(38070700005)(38100700002)(55016003)(83380400001)(186003)(66556008)(66476007)(66446008)(64756008)(44832011)(8676002)(122000001)(2906002)(5660300002)(8936002)(52536014)(33656002)(26005)(71200400001)(966005)(6506007)(76116006)(7696005)(9686003)(86362001)(316002)(6916009)(45080400002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: LmH2CVeG9eNw1dMeIcyvIv+l27gBSvTWyXeatE+cZSOlGnLws8wlaEvZKxvEcXiou7h++1RS8UAh1jqE5S1eThiPGyhWsuvzWgXROJ/Bo+GuC0ZDpdazK65iUjsEmVMYBadmsdUYJndpFO2IW2zZicrf/cvNV58BHvRaJC8WuiNWLeTOy9cviap67oMT67vGJAD5quY9Y6IT/3TumOJgfcAOu3h+mDpjj8y6Vwvh5DrK9YtRnKgjfbMxye4HgtUMcAocflsB9POYs1mSL/pXyZFqeBPm+gUHMotgmoyAyrD/WGhKXvd2BQndzCHlbWr8iVTdmQAqHHZ+WwhzYAoacG3UzO1mWV9IczpOJfNYEAHiMR1WDTwcXgyvsMvn+g/YNwLvCWQWv0R9+UCOfDL73VE2TQOmK7ZmYsZCFY3QPZLhCk3V0VcMiUpYF6kRO1w01jdzP38cULi20gMdPH0grM1dpVMc/0T+BNbcr2N2/LJga82uJfqvhMs0WfcJn1/39xhMvJgIPiK0yfquOsflUtCNoi5JV7WAOs4yw+Bzelik+LwiM4BsY92xwt7eHWDn3SQKwm+85n+ISmf4sAl7jPcrr2UaJVS0ZsjrP3+UPmntzDKV+BrS9aRCooEjfXB7Ea8ht65NDadtC2lclhAGsF6n7NHSmfpB8HtD4r8MF1l1RmHcWCmlQdt/jMMRx3HHm2lAl6GlfmFxZDdMwYfbgF082mreYCNBSdfzp86Nme+rciALHQy38Yj4tp scUI6nX6PGLCKDpNukXwSQutm2XXhHakS+4kECwh/V92YSVKQUao8AkmiRHU+YE+m/i693+7Fo60ko8h07E8Dl7bxliCGByew5 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: ba60677e-c8f3-4475-79d7-08da23411b8f X-MS-Exchange-CrossTenant-originalarrivaltime: 21 Apr 2022 02:46:16.8424 (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: vY9CcT1auSZdtLTog2t0/DDlKVo5QATTl7Q+JYIV3zWS+zCtyA/X2lgTOdUjv3w3BowvEfuZ1ny4ei5v0n+M2Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY4PR1001MB2216 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.486, 18.0.858 definitions=2022-04-20_06:2022-04-20, 2022-04-20 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 phishscore=0 malwarescore=0 suspectscore=0 spamscore=0 mlxlogscore=923 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2202240000 definitions=main-2204210011 X-Proofpoint-ORIG-GUID: Re858J_2VzNm3jX_bx8oNPsUYcHECLZh X-Proofpoint-GUID: Re858J_2VzNm3jX_bx8oNPsUYcHECLZh Received-SPF: pass client-ip=205.220.165.32; envelope-from=drew.adams@oracle.com; helo=mx0a-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" Xref: news.gmane.io gmane.emacs.bugs:230341 Archived-At: This is about the doc of commands, such as `dired-do-find-regexp-and-replace', that use a query-replace dialog. There are a bunch of such commands now. For the most part, they don't tell you anything about what to expect, in terms of a dialog. In particular, they don't reference the doc of `query-replace`, which is (at least) where the dialog should be described. The only saving grace is that there's a prompt that suggests that if you hit `?' you might get some information about what you can do. Assuming you notice that prompt, of course. The doc of all such commands should, directly or indirectly, tell you about the keys you can use and what they do - what you learn by hitting `?'. See, for example, this user's question: https://emacs.stackexchange.com/q/71451/105 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.19043 System Description: Microsoft Windows 10 Pro (v10.0.2009.19043.1586)