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#59934: 28.2; Doc strings of `(kill|delete)-matching-lines' Date: Fri, 9 Dec 2022 22:51:02 +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="760"; mail-complaints-to="usenet@ciao.gmane.io" To: 59934@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Dec 09 23:52:24 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 1p3mEC-000AX6-1P for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 09 Dec 2022 23:52:24 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p3mDs-0007JG-Eo; Fri, 09 Dec 2022 17:52:04 -0500 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 1p3mDr-0007J4-3i for bug-gnu-emacs@gnu.org; Fri, 09 Dec 2022 17:52:03 -0500 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 1p3mDq-0006VW-SG for bug-gnu-emacs@gnu.org; Fri, 09 Dec 2022 17:52:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1p3mDq-00077R-DS for bug-gnu-emacs@gnu.org; Fri, 09 Dec 2022 17:52: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: Fri, 09 Dec 2022 22:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 59934 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.167062628227345 (code B ref -1); Fri, 09 Dec 2022 22:52:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 9 Dec 2022 22:51:22 +0000 Original-Received: from localhost ([127.0.0.1]:38996 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p3mDC-00076z-32 for submit@debbugs.gnu.org; Fri, 09 Dec 2022 17:51:22 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:37966) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p3mD9-00076t-K1 for submit@debbugs.gnu.org; Fri, 09 Dec 2022 17:51:21 -0500 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 1p3mD9-0007Fh-8c for bug-gnu-emacs@gnu.org; Fri, 09 Dec 2022 17:51:19 -0500 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p3mCz-0005RK-LE for bug-gnu-emacs@gnu.org; Fri, 09 Dec 2022 17:51:18 -0500 Original-Received: from pps.filterd (m0333521.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 2B9ME9mY004175 for ; Fri, 9 Dec 2022 22:51:06 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-2022-7-12; bh=5c5wORfTb3SX7ux6GCi/EMPRWHAjmkYUGxewzRcRj0g=; b=AZZw7wBCcHoVuag0hoWpErAcMRAu4Uzbk1xPY6kBc6/sKJiGlLDT1WsRsZ60UywIZYEs hPAK6dCxleiX3BRtfBrOiy6QFvUXgVEVbkY5ynRwXsws9cczA7usIikSpBALsopuCCVg ns51iRiplv0Nb9zie8HKpORHCkcLWfgCg0YAULFDmfSE1uQYb+sYqveNGmnardc7GvKq lHjw0P5KNdkRAd0qCL9y2ETaW66xD1D7EkXLIjdMWXrty2e/VeH4QKQ4/PxZkLJlk3fY DsfBbMv7/SRl79lpNVG1JLFvb/sClu3VGby4plR4pZNPumrZOprEQ5jeXCLTJkQ8O6VO lw== Original-Received: from iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta03.appoci.oracle.com [130.35.103.27]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3maxeywfwh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 09 Dec 2022 22:51:06 +0000 Original-Received: from pps.filterd (iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 2B9MCIaD006792 for ; Fri, 9 Dec 2022 22:51:05 GMT Original-Received: from nam11-dm6-obe.outbound.protection.outlook.com (mail-dm6nam11lp2176.outbound.protection.outlook.com [104.47.57.176]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3maa8277du-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 09 Dec 2022 22:51:04 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GD+/MoAy3t3AwnzlhGl6uD3NTLIjCAHlI77QVJVUN8p6dSDpeXaP6gG+OX+SsksujjEs254TKPhNw3dJlz1a60EZX2aDyycpP3BMZCpsIif2muaf86P7Tn635eGdADbYfxij6QN6PCLHV6iANmNyVQlgQ85RhR4GK/pqxHpvDkE641yWgaR3aI8jGATpeVu7RtWAatSxE0rzavuRYjBUBTWmKmavCAKsaMb0QoPLt8hSnXa/SEwKYSXnBAdTIKDM/emMZPLEz2rICPcoFVjwWzoJVTflpO5tRFAJilbzLLSYo+9jvRT5AFqHmmJeAee+gCHms8jvT3aXKWujYPqNeQ== 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=5c5wORfTb3SX7ux6GCi/EMPRWHAjmkYUGxewzRcRj0g=; b=i+yR2DEyRywNNjmGEeVpalCZ+icjitn14gfBKh8LeMnzHyHMxLpa0kEZOczlBRe3KdBctuLrH/UhEHp3bAauI0R46kCfjDZ35CH5048N/W+DdI5lv2I6k9GgDv6/iV9eowLS6O71Qx9M8CHydoZYfClE5zmhziyh2fZHKqbAH+M+e+Gxnp84cbBzfyr34Hb/eLEzjpuMDmNOmaPjjfQzD+FbVB8i1A6WIntflvlTr+1ClNAhiHz6/J6+NBIa5isaj9zj4sF4RGLJBLUCEkupe6BZBMMCSmDYgFTDA1lazBg0MPbW+z7PC7eIH2DKNr5XvcIcyR3JIiXd7uYaE9kCJA== 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=5c5wORfTb3SX7ux6GCi/EMPRWHAjmkYUGxewzRcRj0g=; b=LwBxjlXcGFhPtUvC9SkgWDHAlxwFVML99z1vNQMsU9buBIGrQJVwvjPvgUAtl5S/pkg/M59LVXCNUQb2wcot2FJbWWJN8ELWDMHO6EneT+Y37oXRhGjxPsnC9sdchaV4Ehtjvbe0NoTdw5bVGD3jHdBJuwN1lQvik2k25slHLjk= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by SN4PR10MB5592.namprd10.prod.outlook.com (2603:10b6:806:207::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.14; Fri, 9 Dec 2022 22:51:02 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::176d:3689:aa5b:91b]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::176d:3689:aa5b:91b%2]) with mapi id 15.20.5880.018; Fri, 9 Dec 2022 22:51:02 +0000 Thread-Topic: 28.2; Doc strings of `(kill|delete)-matching-lines' Thread-Index: AdkMIKyQVubjKMGTTx+U57c/Rdzrsw== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|SN4PR10MB5592:EE_ x-ms-office365-filtering-correlation-id: 03ac3e1d-7349-48ca-1722-08dada37d928 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: SWME9bAEjfSEnwdyVUzKE7XEZ9c+DkHp4lU01BqiFpg6cBeurAm5ntMs2c/z9EpzyBlYkZn52K155NixXQ8mZZQZr2A8dQ2jbU0vcdLyeuXwP6SRCjeyc9WHmG101XNM9tdaFvFO+jZ+LCm/5LQ2M/+pCBbO86HWKcdajzE+ubhcku4f9B8/8f6horVUddA9g9OyrFzSbFO/2eEg/lFWkNjYc1u+HP/PWdwcJ+1bgVe5WuhNMbYzx2N6K33wQ9uC4Me5gHF9j/euAaCUzKH2eoirLwfxQOpzf7UoznEFCAnbI7r2I9BuihDQdv/MaSWGQWvb9u2dGKtthxiry5FMO+BSJsxuGypEcb0VSL4Q7ZllE0eW/0lX+M4QRHSFb+ISdUWXnbvo1ZlE19cXMahQQWsXClDhbemRMN/YAv9bUBz51ChJLFUgzLeHt9i+zmdxFvVV7HQB8G2KLVGTdq1SoGFtsBx0KSlGaNgqT8n9Up2NYC9B9DWKdR21u34g79fVAK3fwq3DN/HCICtaH6xesbagHAgzXFDI+DV6271PD1f6ewhYuPxZs36hJuGOTjHfXeRAluLgJGUdLJFddr2P5rqSG2F0OlIO+CC70teKp3jkAR7+I0kLuN8in3Qgh7+7ILzJASLed9Xutgs2PqXdWEHrl7KxTWsYlL2qvR+o7Rk+ZexV8IZ0vZGNzo3f3jo2PJJZfQLRLXViqrClz87+vg== 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:(13230022)(39860400002)(346002)(136003)(366004)(396003)(376002)(451199015)(186003)(86362001)(38070700005)(83380400001)(2906002)(8936002)(5660300002)(44832011)(52536014)(478600001)(55016003)(66946007)(71200400001)(66556008)(8676002)(6506007)(9686003)(41300700001)(64756008)(76116006)(7696005)(26005)(66476007)(66446008)(316002)(45080400002)(6916009)(122000001)(38100700002)(33656002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: F3gkFf3WD4EpSAaZhSXlfdNxs2MzWWmMgneClL+/ijd4IvcifpCVmQZ0Yx1iKXPSY1Kvca+O/L3Bzbf8Fc4hjv3iO1CYRR5frVgjcNfB21G3DmuwaiDRcWJFXaht/TkZdzXEl1RPyQgVHSNJ4wIcC7r3fIFRC79NZNrrHS0Os+iAW7BD7ga14gdkdF90n+t0wkL0Gw5kIQBJECcyd4gt3YEFylvCuVej7VetIQ/FXiUtqvcEeX4RTjaoLSYzusFixeQDTJvvZJ7DTAGDYyl44pUeGIBsUdtlVdrR9I5pYR0iTem8GT8Ni/okgGCn+JHWlrFVwX+m0LNYwNLQ09CfxSExCcCxxKyE9BgEdz+Pmr9oqFGKKGtgyYUgwygfh5HpkOfkQ46rvQK7aj9Z/+rInjazm637IrZLgtesUJ0Ou7WD1xJMR0qGU0ppBwZznpiuxDqzjFsHAaL1kHQgkcVy5zEWVSk9SEtJ782mDUEFoTyvlB2C3P3tp+UIhlNIK0pBJkG7NxGmUdwUyu5GK1E6HggHGtgCKRfifxkeemfuGa0aDeGHGM8X0qhsY2soik/fIL6oVTGLrJUd3NplX+pTdNWQ1oL6QFhMp5VwU3grLXACJsnqZq5p34s6xN0jrFzBijUKR18MSc+KD3fAZt5QsuDsoFeVyykzTZ0UrLE3sCl+uM2FmnXEManEfFRpG21bzvKh0sVW7vyUvUdM9CDqD0qDH+FgOlzHkZphY+KStEaxAZCvyBazkJ1Y9o LZceyD0WORkweImwzPyI3yXplUZE1sk0w6xfH3BoVmUECosykua45ZECrN6/AHMxvVFdG7DOpddYazdStzI3ulyij0BlboBu5+ 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: 03ac3e1d-7349-48ca-1722-08dada37d928 X-MS-Exchange-CrossTenant-originalarrivaltime: 09 Dec 2022 22:51:02.7373 (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: FUrCQj5iqpSuou1mf9HfdnORtfmW+sOxtx6kTmeN1aYgoNt7B2RFv85WGUxNXpSlLmgm+AxG/FOGX9bD1qigFQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN4PR10MB5592 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.923,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-12-09_13,2022-12-08_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 spamscore=0 adultscore=0 suspectscore=0 mlxlogscore=967 malwarescore=0 phishscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2210170000 definitions=main-2212090187 X-Proofpoint-GUID: xbb-5J80LDExTRTdnPnC-JocdmiFUWeJ X-Proofpoint-ORIG-GUID: xbb-5J80LDExTRTdnPnC-JocdmiFUWeJ 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_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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:250474 Archived-At: These two doc strings are _very_ similar. The two commands are presumably nearly the same, the difference being that one kills to the `kill-ring' and the other just deletes. Please consider, in each of these doc strings, adding a reference to the other command. E.g., "See also `-matching-lines', which is similar but ." That will make uses aware of the existence of the other command. Sometimes users don't consider, or aren't even aware, of the difference between the two kinds of deletion. You might also explicitly point out the use case for `kill-*', e.g., when giving the summary in the "See also": killing lets you subsequently yank the matching lines somewhere. Doesn't hurt to point this out briefly. In GNU Emacs 28.2 (build 2, x86_64-w64-mingw32) of 2022-09-13 built on AVALON Windowing system distributor 'Microsoft Corp.', version 10.0.19044 System Description: Microsoft Windows 10 Pro (v10.0.2009.19044.2251) Configured using: 'configure --with-modules --without-dbus --with-native-compilation --without-compress-install CFLAGS=3D-O2' Configured features: ACL GIF GMP GNUTLS HARFBUZZ JPEG JSON LCMS2 LIBXML2 MODULES NATIVE_COMP NOTIFY W32NOTIFY PDUMPER PNG RSVG SOUND THREADS TIFF TOOLKIT_SCROLL_BARS XPM ZLIB (NATIVE_COMP present but libgccjit not available)