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#47957: [External] : bug#47957: diredx-aux doctrings [PATCH INCLUDED] Date: Thu, 22 Apr 2021 20:15:56 +0000 Message-ID: References: <20210422194508.mbsunzjovwdpyp2i@E15-2016.optimum.net> 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="35906"; mail-complaints-to="usenet@ciao.gmane.io" To: Boruch Baum , "47957@debbugs.gnu.org" <47957@debbugs.gnu.org> Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Apr 22 22:21:14 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 1lZfp3-00095r-5c for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 22 Apr 2021 22:21:13 +0200 Original-Received: from localhost ([::1]:33378 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lZfp2-00064U-8K for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 22 Apr 2021 16:21:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37812) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lZfl1-0002wQ-OC for bug-gnu-emacs@gnu.org; Thu, 22 Apr 2021 16:17:06 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52303) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lZfkz-0000ni-VN for bug-gnu-emacs@gnu.org; Thu, 22 Apr 2021 16:17:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lZfkz-000556-PL for bug-gnu-emacs@gnu.org; Thu, 22 Apr 2021 16:17:01 -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, 22 Apr 2021 20:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 47957 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 47957-submit@debbugs.gnu.org id=B47957.161912257019468 (code B ref 47957); Thu, 22 Apr 2021 20:17:01 +0000 Original-Received: (at 47957) by debbugs.gnu.org; 22 Apr 2021 20:16:10 +0000 Original-Received: from localhost ([127.0.0.1]:35616 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lZfkA-00053w-6E for submit@debbugs.gnu.org; Thu, 22 Apr 2021 16:16:10 -0400 Original-Received: from aserp2130.oracle.com ([141.146.126.79]:39164) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lZfk6-00053A-60 for 47957@debbugs.gnu.org; Thu, 22 Apr 2021 16:16:08 -0400 Original-Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 13MKEEWs106247; Thu, 22 Apr 2021 20:15:59 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2020-01-29; bh=zeDyjCGgAuy+0csNgV/GdDAeZrbSG2Znlfn/ZcofQ+s=; b=0QwPDrZnNHgRIZgT8I+M/RRbfT954ZOl0OqWUz0fzxjWaj0UKBAVfMpcFA9NIkIxWeZr qcLCHZ3vfcV+aI3yHkiIuQlHslIZEbwLXoQ62XGN1iKTiVLiyO35E4FmTzcMt+cNp7G1 Xac6zO89uFyUlGYr/9ORvLGkYtLoefGy9fMB5W1jMbegjj163q2avCaM8ZYc+y4mp+vj k3LF2VVqqVVjfwZJ8DovWxZReCg9IKYTduT53hVuAnfO/1Qg8dKJfRPu/bHTfNxTCEVt bQyHMFgKFBLKkl3CZywf7NrIq4W7qul7b0A8mNHC/5ux6VrOLAy/8ru0d7tbsw87TNRU tA== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2130.oracle.com with ESMTP id 37yn6cen7u-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 22 Apr 2021 20:15:58 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 13MKFN7J103810; Thu, 22 Apr 2021 20:15:58 GMT Original-Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2104.outbound.protection.outlook.com [104.47.58.104]) by aserp3020.oracle.com with ESMTP id 383cbdaa3r-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 22 Apr 2021 20:15:58 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=TVm+wNMKuuhAV1kDLF9VNxJJFy5okNo8QcpWPgdp/9ffIlK445p392ExRE0MSh2JaAoOzx++3IR1LnKMKVpwYT5B7+B5RpLkPSIU94+6NPv3YVCyaMSSPtvO9wsbPSvgOLGZO8vdpRhleBCLAVoz+5kUp+eXj1vythBiQ/VJz2EXkdvxToTOMFzTHuM1cQc/9HuDcjO9QDamzKvFxB5vtmT2QHYGD7QITHuvXPML1pfT71/hnEjBzFTuPEMtl7jTH1H/insARoycS2K0pEAsHQXeiI/WHh3vOud59yBsOhmi5EZJLzdDuYOhVCvp6W7USbeCevwX3q9Qi6F+nbqTTw== 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-SenderADCheck; bh=zeDyjCGgAuy+0csNgV/GdDAeZrbSG2Znlfn/ZcofQ+s=; b=JIrIGeQxmL1chjijxQC6JEgnr/6LpO4fbv1MkPGgeIT0owj54+Gf6JOpYTSnHlrmgjlRnmEa4cmhZuS1JYlb/t5p49QM4lm69ZJL1fY6ppHEf0Vn80/ETlfABFfErmwxGNrdK9A6fGSZkCRdNlUthCu54XXIgCphSCO0iTmncICRHTgIPgX86huMmT6S/plyYPqb50X8gh7Mw7wS1eUT71kQlGW401zqFgP+y2SHMmoC5EasEfIAxZ5u+EIHkq0m6KJvWOShDSCCPhJLgOH3wvEDsDWeX0ZAW1Q+UJUxENr6ClG4h2azXVhFUNuymv0TFjnmf6NWvmU+5jqkvvdvsQ== 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=zeDyjCGgAuy+0csNgV/GdDAeZrbSG2Znlfn/ZcofQ+s=; b=vD1poWN7NFEomddlUrhr2CJiPm7aC7XvCaTFbFELVOP1j4ugd7PrlstG7a8WSPD2bj/+F57PwJmKxWMlNI8mvUmbRC34mR55iOoD5Hk/FFmpgf0GGkM9sHE24N+clqV1SyFjwkEhMODQ7/9iCc3FuOhFWkQC9uwKfBVmiDOEXHw= Original-Received: from SA2PR10MB4474.namprd10.prod.outlook.com (2603:10b6:806:11b::15) by SA2PR10MB4570.namprd10.prod.outlook.com (2603:10b6:806:11e::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4042.19; Thu, 22 Apr 2021 20:15:56 +0000 Original-Received: from SA2PR10MB4474.namprd10.prod.outlook.com ([fe80::2109:9725:fd4a:6494]) by SA2PR10MB4474.namprd10.prod.outlook.com ([fe80::2109:9725:fd4a:6494%6]) with mapi id 15.20.4065.021; Thu, 22 Apr 2021 20:15:56 +0000 Thread-Topic: [External] : bug#47957: diredx-aux doctrings [PATCH INCLUDED] Thread-Index: AQHXN7G9cFdwggJ+oE+joonSrC/qjarA9W5g In-Reply-To: <20210422194508.mbsunzjovwdpyp2i@E15-2016.optimum.net> Accept-Language: en-US Content-Language: en-US authentication-results: gmx.com; dkim=none (message not signed) header.d=none;gmx.com; dmarc=none action=none header.from=oracle.com; x-originating-ip: [73.170.83.28] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 2df17815-163f-4f91-af9c-08d905cb7016 x-ms-traffictypediagnostic: SA2PR10MB4570: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:8273; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: gVq7bq/1n0jAr+Nyl9JPu3QxglgQajRKrbFkeah6bBCzAic0F1Kle9hz5aXRZ0TpjRn+RnAQn5AAHUtgzMN2mmnNuEaR/7XYWqtOggTRZKtAPL4t0Hxh/jzLplj/+kTUZ2/8J1UuAyYiMDuuoUJcxX6GVI/NLKKRebrOvHpVvxrcD2m5y50LkHaql7902rTSXy1bDtsQcVaA4ubbZBssNtkOY7SDfyt09no+HMeu6zs2S+XOgCLRLCkGZLxEaffGmJZ1WwhNUxWKSkgwrxV6ptOeF8wapIdada+YA6oyJ57bnIhBbKtBhWByp6Ky4+VNEw+jopHi+6FHl5WvKaiL9v31S39hxNljb+/qMecpAoETqStlR1BXTxnlhUoAS3cgB1R9DGw+p+Sc4HIqGR2WQhLRlmhtKkDZtgSYt8OpJFqH0tkGsQ3ojMRO+sOgqLEB3ZnP+PdXTRCcu7F6j85f8AT7yAWTU0HYJ1uYK1Fdxdcpm1+efAIShWSDODlloW5pc9HJWtazzSjci4woJM68XHUv+VP+WH1Pn9IJGebmv4zbPJqFuzwMFpi/G7RSDHJQdx9lyB8W5mzgvTZK02IOl1k5Z+sxNM7vsgO8Krf1Vs4= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SA2PR10MB4474.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(376002)(346002)(39860400002)(396003)(136003)(366004)(64756008)(8676002)(66446008)(44832011)(122000001)(478600001)(26005)(76116006)(83380400001)(316002)(66556008)(52536014)(66476007)(6506007)(66946007)(86362001)(38100700002)(33656002)(7696005)(2906002)(5660300002)(186003)(55016002)(8936002)(110136005)(9686003)(71200400001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: ziv1xV+tKsaPzacUF63X5UBDfpniuZMK42i3z49WUqBLrDhGlo9wxnkJJiQyyYXyNjkfhA/S6Lc3GJMNBrv/Excexth/0UTfW2VNkCPnNTmzRbHoEnYGXZ6EIuoh2Ffsj7K8rEHUG3g5hfbjKhUxXPKp36hhyI9wUUy6gopbdq1SmxNWdJYbXhVnKbW+2I6Pf1eUK2AwXmMTull89CdYxVXYz/vHhpTGbrAzcrtgtWhKZzY84q4FGnekDfr/Rw1BQRa+QQAa7cC4rFOpy65RmRuHW8NQhG2tsttdbNhUCDBSNacUIhVSJfQmIETnzxiqq/wS/3+COspT08R9QJ0yz2HmE98RZ9Wk4xKWiwlKDbEOY/rHHwY/Csx30IBFJS0H6t7K2Z+zLPB/g+1sgDot7pVHXFGLuTjNCJpyUoHbk4CoiCyyDDeGbbqKfnvkuYLot2FBZUdScyfGRDrjXpepbzV3M2oFT8zvDt339HbisFdF95l6ai23NIYsS4ZqJuTv6CXnCwuCpInGDB4VVRawEQrDpNilr86nj/hIryd9IL99kyGe/yLIQdvI2cA+eVCyvXXiGBWugVjnnFYWHf9WFHdFHNXQwuseksr6K+izJkxbj9p8LJZ5n2FWhYWILpRM4l7d6CThmFHDgwPMiYexUEhDT8eCyPJN+YM7lvj2O5853wVR5U0jxbqhTpx542TZ/kZyn370ysaWrfSJk02+ITSWlTguW5o7WBgaWW+AiCj5pQVnGV2WSngz0cSl 4yuWkwYYkgqDjjwzDoexXt6ItItvBICzJ29dDgG96NLKOr2dP+95CGbv8dA1KQ/+1cQIeIbtmlF2K6sBKs1fzrdTFoa2jB2Xqb x-ms-exchange-transport-forked: True X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SA2PR10MB4474.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 2df17815-163f-4f91-af9c-08d905cb7016 X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Apr 2021 20:15:56.6182 (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: J4bCo5STxvi5pxcYvK0mQbAAkO3aKnRLreapNCeX9At3Vbtx2YTzKWY/dQt4g3CFbhCljHlodymL+z487MjM3w== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA2PR10MB4570 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9962 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 bulkscore=0 mlxlogscore=999 phishscore=0 mlxscore=0 adultscore=0 spamscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104060000 definitions=main-2104220150 X-Proofpoint-GUID: JUYZN8ETt8-vKeYsmqjUJC7R-9l1JMHp X-Proofpoint-ORIG-GUID: JUYZN8ETt8-vKeYsmqjUJC7R-9l1JMHp X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9962 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 priorityscore=1501 bulkscore=0 suspectscore=0 impostorscore=0 mlxscore=0 lowpriorityscore=0 clxscore=1011 spamscore=0 mlxlogscore=999 adultscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104060000 definitions=main-2104220150 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:204714 Archived-At: Thanks for doing this. A minor suggestion (for consideration) for `dired-do-kill-lines', based on my feeling that "kill" here is a misleading misnomer: Say "remove", not "kill" (which generally has to do with removing text and placing it on the kill ring). FWIW, I have this doc string for it in Dired+. Apart from the added optional arg INIT-COUNT, the behavior is the same. ___ Remove all marked lines, or the next ARG lines. The files or directories on those lines are _not_ deleted. Only the Dired listing is affected. To restore the removals, use `M-x revert-buffer= '. With a numeric prefix arg, remove that many lines going forward, starting with the current line. (A negative prefix arg removes lines going backward.) If you use a prefix arg to remove the line for a subdir whose listing you have inserted into the Dired buffer, then that subdir listing is also removed. To remove a subdir listing _without_ removing the subdir's line in its parent listing, go to the header line of the subdir listing and use this command with any prefix arg. When called from Lisp, non-nil INIT-COUNT is added to the number of lines removed by this invocation, for the reporting message. ___ (Also, don't forget to prefix lines that start with ( with \.)