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: Fri, 12 Oct 2018 14:00:44 +0000 (UTC) Message-ID: References: <<9b01a158-aff2-42b2-88e3-c29d704cc22a@default>> <<83k1mnwoiv.fsf@gnu.org>> 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 1539352752 21083 195.159.176.226 (12 Oct 2018 13:59:12 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 12 Oct 2018 13:59:12 +0000 (UTC) Cc: 32959-done@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Oct 12 15:59:07 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 1gAxy6-0005Mf-Qv for geb-bug-gnu-emacs@m.gmane.org; Fri, 12 Oct 2018 15:59:07 +0200 Original-Received: from localhost ([::1]:40786 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gAy0D-0006uc-CZ for geb-bug-gnu-emacs@m.gmane.org; Fri, 12 Oct 2018 10:01:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44143) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gAy03-0006rG-N8 for bug-gnu-emacs@gnu.org; Fri, 12 Oct 2018 10:01:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gAy01-0000lZ-P6 for bug-gnu-emacs@gnu.org; Fri, 12 Oct 2018 10:01:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:43097) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gAxzx-0000f0-VZ for bug-gnu-emacs@gnu.org; Fri, 12 Oct 2018 10:01:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gAxzx-0003lb-PC for bug-gnu-emacs@gnu.org; Fri, 12 Oct 2018 10:01: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: Fri, 12 Oct 2018 14:01:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 32959 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 32959-done@debbugs.gnu.org id=D32959.153935285714462 (code D ref 32959); Fri, 12 Oct 2018 14:01:01 +0000 Original-Received: (at 32959-done) by debbugs.gnu.org; 12 Oct 2018 14:00:57 +0000 Original-Received: from localhost ([127.0.0.1]:47355 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gAxzs-0003lB-Ex for submit@debbugs.gnu.org; Fri, 12 Oct 2018 10:00:57 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:54084) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gAxzp-0003kv-Te for 32959-done@debbugs.gnu.org; Fri, 12 Oct 2018 10:00:54 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w9CDwdDk188133; Fri, 12 Oct 2018 14:00:48 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-2018-07-02; bh=FvN1t3GPNcKHfzx/vSkFBiWg/3IzYt2gYGlGbKFeVk4=; b=yt1y+gYNIR5ZrEO3xmjOCcZsayjDHR9zz2VLdQo+k5vDCdV6978AjPe6FTMKABX4b6fD wNC5wnZroWC87Yy+ybYTambB2SkLMyjYJxF61Ih9LDw9rtdBP5LXCix/HMIuKDDckpr9 FyFEEQhBGoi1K6UoOzaezc+idgbXyQCLwJzxtV7NvX3ByHmQCNwnDyVFpE0f1BX+zNHn Ll2c5Ubru4ar0r7z/dd6/F8xzZEIumBUppKP8BbR21ED5Y2+roN4fU6e/LN2HRDAHfYd EeLKEoqEcowcbjMR4Fx34viN22N2YWzW2MFO1KFBT9GrVxh9Eltto40o1/SKqxk5sp3F Gw== Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp2130.oracle.com with ESMTP id 2mxmfuauwp-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 12 Oct 2018 14:00:47 +0000 Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w9CE0kfT031733 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 12 Oct 2018 14:00:46 GMT Original-Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w9CE0jY6013539; Fri, 12 Oct 2018 14:00:45 GMT In-Reply-To: <<83k1mnwoiv.fsf@gnu.org>> 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=9043 signatures=668706 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-1807170000 definitions=main-1810120139 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:151174 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 entr= y > > is named just `C-u C-x C-x', not `C-u C-x C-x disabling Transient Mark'= . >=20 > There is already an index entry "C-SPC C-SPC", so we need to > disambiguate the second one. In that case, the plain `C-SPC C-SPC' should be something like `C-SPC C-SPC, set mark without activating'. > I changed the qualification to say "enabling Transient Mark > mode temporarily". That's certainly better than "disabling". Thx. > > 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. >=20 > I don't find it confusing at all, so I didn't change the text. Do you know of other places in Emacs where we speak of activating/deactivating a _mode_? Actually, yes, it turns out there are a few - but very few. Should you change your mind and decide to correct them, here they are: In the Emacs manual: Node `CUA Bindings': "CUA mode by default activates Delete-Selection mode..." Node `Indentation Commands': "the command activates a transient mode..." Node `Key Bindings': "activating a mode might override your..." In the Elisp manual: Node `Minor Modes': "possible to activate and deactivate minor modes..." That's it, for the manuals - 4 occurrences altogether. In doc strings, we also have a few occurrences: vc-mode: "This minor mode is automatically activated..." allout-mode: "automatic activation of `allout-mode'" allout-auto-activation: "outline mode auto-activation" Info-edit-mode-hook: `Info-edit-mode' is activated indent-rigidly: "any other key deactivates the transient mode" set-mark-command: "activates `transient-mark-mode'" follow-delete-other-windows-and-split: "Follow mode is activated" ps-prologue-file: "major/minor-mode is activated" isearch-yank-word-or-char: "`subword-mode' is activated" vc-refresh-state: "VC mode is deactivated" That's very few occurrences, for all of Emacs: 4 in manuals, 10 in doc stri= ngs. I would say "turn on" or "enable" a mode, which is what Emacs says everywhere else, AFAIK. These occurrences are just typos/slips, I imagine.