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.devel Subject: RE: [External] : Re: master 2ed2999: Improve documentation of new Xref options Date: Tue, 7 Sep 2021 17:03:36 +0000 Message-ID: References: <20210905075953.20536.20920@vcs0.savannah.gnu.org> <20210905075955.0F6B720A0A@vcs0.savannah.gnu.org> <6f1fcbee-1825-1219-88fb-e6f28d00ab4d@yandex.ru> <831r62tjf3.fsf@gnu.org> <0eaa7dc7-a3f2-5319-bf09-629f9949e416@yandex.ru> <834kaxsxb8.fsf@gnu.org> <7fe2eafb-e15a-beab-f485-9c80b2913121@yandex.ru> <831r61soqu.fsf@gnu.org> <6c33d3c8-5155-f0fe-ec47-0630d9f3525f@yandex.ru> <83h7ewpmc4.fsf@gnu.org> <6b688b48-eae7-1dbc-3de6-97f071583659@yandex.ru> <838s08peuk.fsf@gnu.org> <834kawpder.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="36325"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "emacs-devel@gnu.org" To: Eli Zaretskii , Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Sep 07 19:04:40 2021 Return-path: Envelope-to: ged-emacs-devel@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 1mNeWV-0009GO-8M for ged-emacs-devel@m.gmane-mx.org; Tue, 07 Sep 2021 19:04:39 +0200 Original-Received: from localhost ([::1]:35410 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mNeWT-0005QU-CQ for ged-emacs-devel@m.gmane-mx.org; Tue, 07 Sep 2021 13:04:37 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39104) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mNeVd-0004IR-2p for emacs-devel@gnu.org; Tue, 07 Sep 2021 13:03:45 -0400 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:54704) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mNeVa-00010c-Tc; Tue, 07 Sep 2021 13:03:44 -0400 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 187GNoUo026869; Tue, 7 Sep 2021 17:03:40 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-2021-07-09; bh=d35TRa+torjWgUANmc7dpGUCzdUTlDFGMB9QJfLSA6Y=; b=prC2Tg6nF6lqW8ATuyQIwhd/EFMvE2PBEAM6l1O7T39XBar9iLsLXjoeJE+ZFwssOP3L UTcTEujo7wewfg+mrSsY/ZSRpzRYOlVFAxy9VgUCTbcTUF76Szp3WA25V/rS9dbB2S/W TDr+e5OkTI4HVou3rOmrflAD7yPotLXJRQ61F0K/r5RXBGNMjQSKEk6w1NHrg4sr3AVT 74hOIfJZ5qchocDfWU0MOlZ4lZU2yVu0t4eIvP2hl4oy8Ee0kCFpvReY1nEIcMF/2qxz ozzlwD1FDQw1cBgt9SzycGmKRNn4y5hG0y2WQ2yCs6QWs33upRs6gD0vzl4kTNZmosYT 1w== 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-2020-01-29; bh=d35TRa+torjWgUANmc7dpGUCzdUTlDFGMB9QJfLSA6Y=; b=XzOS8gBFJg03zyilaAjpgRh+qZu+Xm0olArGgVS+KNumgF4j52goIZg4GCZr6ELYE7St 8kR/Jir5gCdk7wK5KMKSsGx0RNIvZsHBYXEX3Soj7XQMalpcyhgpalP/EkDk9jAXbt9Z P7bvfaXKxPSZ0eyxZXw2p3j75zN7PrOe1bDsOQX52MV30SvHV2ia3gol93GAdiyglznp chCbEmQnaD1P0vcRMO3BIvpUjsmu9cK2F7XCuvMZGjuaRVXmMhMr+CuftisHmaZhrK52 inFqL+3k6s8NawlKrvsR6jpP9T/SUbOTISHGWskxOAZLvDWhKRLsBDVRGc9h8scD+epo GA== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by mx0b-00069f02.pphosted.com with ESMTP id 3awq29kns0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 07 Sep 2021 17:03:39 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 187GuB7m095062; Tue, 7 Sep 2021 17:03:39 GMT Original-Received: from nam04-dm6-obe.outbound.protection.outlook.com (mail-dm6nam08lp2041.outbound.protection.outlook.com [104.47.73.41]) by aserp3030.oracle.com with ESMTP id 3auxue0qjn-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 07 Sep 2021 17:03:38 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=SYE9/7tlv/GX1KVpFtLwQ4rMR1GvqQO91vNATsWyE7Mq04fofOIQJm1g+2sIupUGjSufX8yayoeFxh6HBbtNkK96ok/Ue+C0wppzqObL/Li2ny6BrV0EbhZefFnTiYQjZiJwKnjwqk1trlCj37xKzH9B/NToJDcK5+ViK+kBiYMVafzBYEMIJ1VP+eT6hcVK2N3HlnO0g4B1Q9JUjjTvC5CDdCCR6e/4fAsxdIMflSVGhADhzs9mIsc3kJDuywNtJD2a4qIHBi27fRAOviyfeKPV7yIs6LiPv/CSB9ZO0Rr+rS10pJXbGIWYrG3qGkUXFtbaGoJSKl14xeu2/Ce3wQ== 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; bh=d35TRa+torjWgUANmc7dpGUCzdUTlDFGMB9QJfLSA6Y=; b=h8UQQirJdY/5xnxSXFNXTHAb45rHqE+lytYkDhtVXdF10PRr7qj6w2i0sPYFSWCjM+VMELUPVnL8GsQt04mIUrE2qMGoriWXOhtvvmCfJO7uoiAlAvhVME05RV3M7hVoDNoTlgETa4g4AC6m2B2lBMkxI8ocyEcZw2XlRh8Q9ByyoZY6OujsePtlSZ/MZwUpdPz4PJDc4T0yNQQ3O85RhJDBfe0Pn12vyKbNKKv+9tZHiH64nggy7vGONhb00aiI+fD/fbHOWKm84XrJP/otpiIkplmtYoxNjdIV7eMs664EJ0aDsWyAgmB6byRBB9v1sNZzSqxcqjk4IhXj0KEH2g== 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=d35TRa+torjWgUANmc7dpGUCzdUTlDFGMB9QJfLSA6Y=; b=yyl/kaNkQ/TXZTbi0ws63J+V9ByaHn9ZTy1lPlPeHVraKJzRHve2cuXjGtJzOdBcEcSQzftTWc461DaOQKuuSfdr9NGD7TRxciX1Rn4HfT7EdP2MzPC6z37Vc/hdZOfCnTpP5Ks0J4j+SyMkd0nnnZlxyjxmb2bYlvqM3U/f8G0= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BYAPR10MB2565.namprd10.prod.outlook.com (2603:10b6:a02:b2::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4478.24; Tue, 7 Sep 2021 17:03:36 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::c0bc:7c3a:292f:8a82]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::c0bc:7c3a:292f:8a82%8]) with mapi id 15.20.4478.026; Tue, 7 Sep 2021 17:03:36 +0000 Thread-Topic: [External] : Re: master 2ed2999: Improve documentation of new Xref options Thread-Index: AQHXpAQCUJFybxwLVEOEzvJG4c7QVauYy4PA In-Reply-To: <834kawpder.fsf@gnu.org> Accept-Language: en-US Content-Language: en-US authentication-results: gnu.org; dkim=none (message not signed) header.d=none;gnu.org; dmarc=none action=none header.from=oracle.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: e788dd9e-a12d-4dfa-b614-08d972216ed8 x-ms-traffictypediagnostic: BYAPR10MB2565: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:7219; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 8Jd5jhgzEC9TE59lLlnGH3fKPrZDOTH5NekICarD+EKWMzKKIwTbcyf9t0DKMylfmptr3Z7hPJawFSno4FxMZr85zncrVkj5RbqUQ8oAXezqMZADOpJ2WZabzwvdDYWTWnbEplQIsx9z91sFAL3zwCXo/b4bXRwpCk7zNoaFpE35HHCRIM7KB99Git1wikAYV9r/p7xzN7u30obe/Od+QubsCUv8dv1e6w8iogBW2BFAxFqyw/WPt3++zlGzpByPU1nD0VtuEAkyTft/UIz38i/I8QB3IpiaejV3yFlcsjWoTE1iC5Y59BzqgK+vPiHCzPh4e5pQVaMIjMiUn10biaVdxjKSJ02W/aVOLUHZjaAC+3Ffj0xjI/txSEKo2rK9Vqhu6zg4+AfGCeacrocBAYYl5izvoT5rGL/e+0EPdssP0B12nh1CC5RrEm0MpMJOtTtKLo1MKijRsOdPpzwJWeBn+gfsw12mEY84HHt3eQr4kb5IhwFXf/oDvBbVLO7ytDOyTGa2meW5q/3uc3K2JfBF8BC1bwkllb8RJJKrJ9ugJ7aisqnOLV7kQUH5e0iPla1dq2Y+uM3SojvF+wC/6oac5j3Gy/F0V+NUX+Xfz+tq/+ZdXDHd9KWCeRVamjYcUfJdwHpWrEG8XT4N2febovp6FC3ZNdOpioTmBb2qzpc4HKb9LuTW0Ackx9lY1fSIrIjThWikGxwAiSZ5vwYMfA== 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)(33656002)(26005)(6506007)(66946007)(508600001)(110136005)(66556008)(122000001)(66476007)(64756008)(66446008)(5660300002)(76116006)(4744005)(44832011)(52536014)(316002)(55016002)(38100700002)(186003)(86362001)(38070700005)(2906002)(71200400001)(4326008)(8676002)(7696005)(9686003)(8936002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?4QGRAHTmiPZdZL1GpGa8foTo+vChnh2cHzXcBnzwLaEhet+RQ8q3LXEMFJsy?= =?us-ascii?Q?FkvhIJDNseUlvbhYd5uj2JVVHuZ7RB3H9qaU06cTXPgT1r2kPa8DOA8YkT08?= =?us-ascii?Q?Tp8daug+bcuY+a7GbXSsM7xDSma7cAviER1hBg6lyUC0QTa88X+aYppN+t5Q?= =?us-ascii?Q?CGaLAWGTY217EWvioReNl7jdpY/XowOupL0WLhtJrIFU8qX6onqzLZAPO2ql?= =?us-ascii?Q?SGkzNJNCqnRlzNmtPc4dJjdHHuQx+IiNHCw/NBocqP6lrzUK529v4hhA5c/y?= =?us-ascii?Q?MCQB7XbIW28myuZkx7HjmFaUu5wglIMzfN9MLctb3VzgTgucTS3f0ol8+aqv?= =?us-ascii?Q?zr8AHpOho1VyapNmRZQGHgMuT5H8K2F+0+MrQMj0b0kl9J81sR19kbB2pc0v?= =?us-ascii?Q?RYgbxcsac4da6AKn8Qzw70b+KXjDHxmhBvkfucRRj04xyw0rHwJE6zn24tOI?= =?us-ascii?Q?iQNgmDMoaE8GHPc2QyCNyp34kR941bTddLgK8/9bkdOEinZw0NFRB5t/0H6S?= =?us-ascii?Q?2KvTkkaikfjdyIjXVVzOkfRjkY7Bx8fT5KlTjgkGjg8/lpoNW8MxGuAoRTxj?= =?us-ascii?Q?6hMYgM8PXxcTO+xXJKFO5EfWTIMc/aWTTWcDDvucXv11XW/TifShE4tbQ7On?= =?us-ascii?Q?GF x-ms-exchange-transport-forked: True 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: e788dd9e-a12d-4dfa-b614-08d972216ed8 X-MS-Exchange-CrossTenant-originalarrivaltime: 07 Sep 2021 17:03:36.7405 (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: /EwCOZADcWZ+Vz7Rv4A8r1lW3AKoubz4zBOF4/eK2pBFeqg84F84+ClT5qsJ6QWQl1/SSBWT6qrm3u6wwUDPsA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR10MB2565 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10099 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 phishscore=0 suspectscore=0 bulkscore=0 spamscore=0 malwarescore=0 mlxlogscore=739 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2108310000 definitions=main-2109070111 X-Proofpoint-ORIG-GUID: g5Vp3Ok1zVl5kTI9OOh8ghJxmDmCR0-- X-Proofpoint-GUID: g5Vp3Ok1zVl5kTI9OOh8ghJxmDmCR0-- 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: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:274268 Archived-At: > I only meant the former, because it is a Dired command, like > dired-do-find-regexp-and-replace. I was thinking about Dired users. If possible, `dired-do-*' commands should behave similarly. There's value in them having a consistent interface. So much so that I'd say that if some command has to break this consistency then its name shouldn't use the prefix `dired-do-'. Just one opinion, of course.