From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#25357: 25.1; Doc for `cursor-sensor-mode' (and modes generally) Date: Thu, 05 Jan 2017 17:28:29 +0200 Message-ID: <83fukxedb6.fsf@gnu.org> References: <9ad8b225-73da-4533-a676-b0f8e84e54ca@default> <878tqq5fw2.fsf@users.sourceforge.net> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1483630162 8763 195.159.176.226 (5 Jan 2017 15:29:22 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 5 Jan 2017 15:29:22 +0000 (UTC) Cc: 25357@debbugs.gnu.org To: npostavs@users.sourceforge.net Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jan 05 16:29:18 2017 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 1cP9yZ-0000ol-W3 for geb-bug-gnu-emacs@m.gmane.org; Thu, 05 Jan 2017 16:29:12 +0100 Original-Received: from localhost ([::1]:46990 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cP9yc-0003YT-Lz for geb-bug-gnu-emacs@m.gmane.org; Thu, 05 Jan 2017 10:29:14 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59126) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cP9yU-0003Wu-OS for bug-gnu-emacs@gnu.org; Thu, 05 Jan 2017 10:29:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cP9yQ-0004Tw-Rs for bug-gnu-emacs@gnu.org; Thu, 05 Jan 2017 10:29:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:56809) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cP9yQ-0004Tl-P3 for bug-gnu-emacs@gnu.org; Thu, 05 Jan 2017 10:29:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cP9yQ-00006j-Ha for bug-gnu-emacs@gnu.org; Thu, 05 Jan 2017 10:29:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 05 Jan 2017 15:29:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25357 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 25357-submit@debbugs.gnu.org id=B25357.1483630105356 (code B ref 25357); Thu, 05 Jan 2017 15:29:02 +0000 Original-Received: (at 25357) by debbugs.gnu.org; 5 Jan 2017 15:28:25 +0000 Original-Received: from localhost ([127.0.0.1]:43975 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cP9xp-00005f-1D for submit@debbugs.gnu.org; Thu, 05 Jan 2017 10:28:25 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:39823) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cP9xn-00005P-Nf for 25357@debbugs.gnu.org; Thu, 05 Jan 2017 10:28:23 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cP9xe-0004Px-Lo for 25357@debbugs.gnu.org; Thu, 05 Jan 2017 10:28:18 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:60295) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cP9xe-0004Pt-I3; Thu, 05 Jan 2017 10:28:14 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4898 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1cP9xd-00026D-Rl; Thu, 05 Jan 2017 10:28:14 -0500 In-reply-to: <878tqq5fw2.fsf@users.sourceforge.net> (npostavs@users.sourceforge.net) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:127783 Archived-At: > From: npostavs@users.sourceforge.net > Cc: 25357@debbugs.gnu.org, Eli Zaretskii > Date: Wed, 04 Jan 2017 22:45:17 -0500 > > > I even think it would help to emphasize that "one" - not zero. > > IOW, you cannot turn off a major mode without turning on another one. > > Sure, here's a patch to the manuals to clarify that. Thanks. > + A @dfn{mode} is a set of definitions that customize Emacs' behavior > +in useful ways. There are two varieties of modes: @dfn{minor modes}, > +which provide features that users can turn on and off while editing. > +And @dfn{major modes}, which are used for editing a particular kind of > +text. I'd suggest not to start a sentence with "And". Instead, something like this should be better: @dfn{major modes}, which ...; and @dfn {minor modes}, which ...