From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#16074: 24.3.50; enhancement request: Remove "pop" from command names & doc for `C-(u|x) C-SPC' Date: Sun, 25 Aug 2019 15:03:07 -0700 (PDT) Message-ID: References: <87y2zh94nz.fsf@gnus.org> <87a7bxm12m.fsf@mail.linkov.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="120824"; mail-complaints-to="usenet@blaine.gmane.org" Cc: Lars Ingebrigtsen , Stefan Kangas , 16074@debbugs.gnu.org To: Juri Linkov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Aug 26 00:05:19 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1i20dT-000VJJ-3G for geb-bug-gnu-emacs@m.gmane.org; Mon, 26 Aug 2019 00:05:19 +0200 Original-Received: from localhost ([::1]:48376 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i20dQ-00084c-Ut for geb-bug-gnu-emacs@m.gmane.org; Sun, 25 Aug 2019 18:05:17 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33378) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i20dD-0007zl-ML for bug-gnu-emacs@gnu.org; Sun, 25 Aug 2019 18:05:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i20dC-0005Lx-MP for bug-gnu-emacs@gnu.org; Sun, 25 Aug 2019 18:05:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36391) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1i20dC-0005LT-Ah for bug-gnu-emacs@gnu.org; Sun, 25 Aug 2019 18:05:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1i20dC-0005JJ-5P for bug-gnu-emacs@gnu.org; Sun, 25 Aug 2019 18:05: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: Sun, 25 Aug 2019 22:05:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 16074 X-GNU-PR-Package: emacs Original-Received: via spool by 16074-submit@debbugs.gnu.org id=B16074.156677067120366 (code B ref 16074); Sun, 25 Aug 2019 22:05:02 +0000 Original-Received: (at 16074) by debbugs.gnu.org; 25 Aug 2019 22:04:31 +0000 Original-Received: from localhost ([127.0.0.1]:45212 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i20ch-0005IQ-FP for submit@debbugs.gnu.org; Sun, 25 Aug 2019 18:04:31 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:43680) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i20cf-0005IB-ET for 16074@debbugs.gnu.org; Sun, 25 Aug 2019 18:04:30 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x7PM4Mle186481; Sun, 25 Aug 2019 22:04:23 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=7fiSbshoRXXAyIxkqL0Wm2tGzh7scR3LUv0vdzVAB8E=; b=XDsa9ItNJrmFuo/SgPPorM2CjcHHOQIqUAvhMXmYYfzRWPBQemIQA6WKXCSVq2Csr6tn BU/OyZbnF8cXtmZGe4aHXyZHXakR4nnkzpWQwqv2T1MCFPQAcTLsHszukoSfWANLmZYj PWlywb/eEVNjHyxpi7N7tPN5yqpos0VVvtSlMkh9KhVpYdp7MPZd0h8sBUOLu3RKS3lP Qes7RVOLCk5pa7G+6rIGmQrflbU4gQwA8FShkk+BXkEz3jpnxoFG2qNJj3o+s9Yc/Xju rXXg293c6nMN2del2gxU3CgtRD2bzYUu+HnRx7VKziKmTMvhtFX2o1vsSRiRBRA0Fpqm tQ== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by userp2120.oracle.com with ESMTP id 2ujwvq54g8-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 25 Aug 2019 22:04:22 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x7PM4Hkf096381; Sun, 25 Aug 2019 22:04:21 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3020.oracle.com with ESMTP id 2ujw78vcpw-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 25 Aug 2019 22:04:20 +0000 Original-Received: from abhmp0020.oracle.com (abhmp0020.oracle.com [141.146.116.26]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x7PM37co021019; Sun, 25 Aug 2019 22:03:08 GMT In-Reply-To: <87a7bxm12m.fsf@mail.linkov.net> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4873.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9360 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908250247 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9360 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908250247 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:165861 Archived-At: > > The enhancement request is to fix this wrong > > terminology wrt BOTH `global-mark-ring' and > > `mark-ring'. >=20 > And `yank' doesn't yank, and `kill' doesn't kill literally. > What is the most important is that docstrings should describe > the behavior in all details. The name is more a matter of taste. Irrelevant. Emacs _has_ "pop" in its terminology, just like it has "yank" and "kill" (buffer, text). This mistaken use of "pop" doesn't fit Emacs's use of the word (or even typical outside uses of it). And Emacs _has_ a term, "cycle", for the behavior here. "Cycle" is the term Emacs uses for rings. And it's not just about the name. It's also about the doc, which incorrectly tells users that the behavior is to "pop" the mark/position "off" the ring. That's wrong; it's not what happens. That doesn't "describe the behavior in all details". Instead, it describes a different behavior, which doesn't happen. Hand-waving alone can't justify this misleading. On the other hand, as I replied to Eli, you can decide whether fixing this is "worth the necessary time, energy, VC resources and your whatnot." That's up to you.