From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#32959: 26; Emacs manual index entry `C-SPC C-SPC disabling Transient Mark' Date: Sun, 7 Oct 2018 00:04:56 +0000 (UTC) Message-ID: <9b01a158-aff2-42b2-88e3-c29d704cc22a@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1538870650 11739 195.159.176.226 (7 Oct 2018 00:04:10 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 7 Oct 2018 00:04:10 +0000 (UTC) To: 32959@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Oct 07 02:04:06 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g8wYH-0002wV-Kr for geb-bug-gnu-emacs@m.gmane.org; Sun, 07 Oct 2018 02:04:05 +0200 Original-Received: from localhost ([::1]:40703 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g8waN-00079l-Ug for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Oct 2018 20:06:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52627) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g8waD-00079N-MJ for bug-gnu-emacs@gnu.org; Sat, 06 Oct 2018 20:06:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g8waA-0001Id-E0 for bug-gnu-emacs@gnu.org; Sat, 06 Oct 2018 20:06:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:34666) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1g8waA-0001IT-9k for bug-gnu-emacs@gnu.org; Sat, 06 Oct 2018 20:06:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1g8waA-0003VI-1S for bug-gnu-emacs@gnu.org; Sat, 06 Oct 2018 20:06: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, 07 Oct 2018 00:06:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 32959 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.153887072813424 (code B ref -1); Sun, 07 Oct 2018 00:06:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 7 Oct 2018 00:05:28 +0000 Original-Received: from localhost ([127.0.0.1]:38924 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g8wZc-0003US-3p for submit@debbugs.gnu.org; Sat, 06 Oct 2018 20:05:28 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:42907) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g8wZY-0003UE-6d for submit@debbugs.gnu.org; Sat, 06 Oct 2018 20:05:25 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g8wZN-0000ie-P6 for submit@debbugs.gnu.org; Sat, 06 Oct 2018 20:05:18 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:38332) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1g8wZG-0000cE-N3 for submit@debbugs.gnu.org; Sat, 06 Oct 2018 20:05:08 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52515) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g8wZF-0006wK-S3 for bug-gnu-emacs@gnu.org; Sat, 06 Oct 2018 20:05:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g8wZ9-0000Yw-PQ for bug-gnu-emacs@gnu.org; Sat, 06 Oct 2018 20:05:03 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:52662) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1g8wZ9-0000XY-AO for bug-gnu-emacs@gnu.org; Sat, 06 Oct 2018 20:04:59 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w97008Aj146341 for ; Sun, 7 Oct 2018 00:04:58 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=uMo2CowUdiba5y6A8fAtY5qMi0jgK6oXawrlFMVyeqM=; b=0LkAkUmXo7HHrJQDuCV/UUHGUt0sDeJNz13WStNz/44vgiLRP+7jDdXgD/CK2aCNfcpB BxFpNWTgkPhWQ9nmsZx/+z0cjO1Mf+wlGUf04+woT2LYcdt37IEPNv5LVjuCNeKoeyHc fRDAGlq1eOZHWjIoEjADWNbBjb8Vs6acis7t0yUPLk2ttQEj7QFCDS00DTeNqu5C8+VG 6O5Sit075i+7NhRL3kqF22nBMKWrShhGTAl5/H5CCIIzcJAvSmUaDzoINCQiSvtLPxaK U6ZGZWe3ofX5aSVkEa1NEqMJQzY+mqgAPAmVR7VdJAAhSY7jzbFWHzyOzA6UyimGgwbd CA== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp2120.oracle.com with ESMTP id 2mxn0phpnk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 07 Oct 2018 00:04:58 +0000 Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w9704vit008243 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 7 Oct 2018 00:04:57 GMT Original-Received: from ubhmp0017.oracle.com (ubhmp0017.oracle.com [156.151.24.70]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w9704vfK015232 for ; Sun, 7 Oct 2018 00:04:57 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4735.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9038 signatures=668706 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 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-1807170000 definitions=main-1810060244 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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: 208.118.235.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:150968 Archived-At: This index entry seems to be misnamed. Compare, for example, the index entry for `C-u C-x C-x' (which goes to the same node). The latter entry is named just `C-u C-x C-x', not `C-u C-x C-x disabling Transient Mark'. Why would `C-SPC C-SPC' be associated with disabling transient-mark mode, since it in fact activates the mode temporarily. What's more, something that did, in fact, disable `transient-mark-mode' should be called "disabling transient mark mode', not "disabling transient mark" (which doesn't mean anything, AFAIK), let alone "disabling Transient Mark" (no reason to capitalize). Seems like the entry name should just be `C-SPC C-SPC'. Beyond the name of this entry, this doc seems confusing to me. Should it talk about turning the mode on/off, or about enabling/disabling the mode, or about activating/deactivating the mode. The node uses all three, which only confuses. We do identify turning a mode on/off with enabling/disabling the mode, so using both of those, or even a mix, is not a problem. But I don't think the doc should speak of activating the mode: "you an activate it temporarily using...". You don't activate a mode. You can activate the region or activate the mark, but not a mode. And in terms of the index entry in question, you do not disable (or enable) a transient mark. This subject is already difficult enough - even just the notion of an active region/mark and the notion of transient-mark mode. Adding temporarily enabling that mode makes things even more complicated - difficult to understand. This doc needs to be clear and straightforward, to set these things straight. Please consider somehow clarifying things in this node, in addition to renaming index entry `C-SPC C-SPC, disabling Transient Mark'. Whatever you come up with is fine by me - I'm sure it will be an improvement. In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.16299 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''