GNU bug report logs - #25357
25.1; Doc for `cursor-sensor-mode' (and modes generally)

Previous Next

Full log

Message #23 received at 25357 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Noam Postavsky <npostavs <at> users.sourceforge.net>
Cc: 25357 <at> debbugs.gnu.org, Eli Zaretskii <eliz <at> gnu.org>
Subject: RE: bug#25357: 25.1; Doc for `cursor-sensor-mode' (and modes
 generally)
Date: Wed, 4 Jan 2017 11:06:10 -0800 (PST)

> >> > More generally, I do not see, in either the Emacs or the Elisp manuals,
> >> > anywhere where we explain the argument to a major mode, telling you how
> >> > to turn the mode on/off from Lisp.
> >>
> >> It's mentioned in "Minor Modes" in the user manual.
> >
> > But it's a major mode...  I tried `i' for major mode etc.
> 
> Why do you think it's a major mode? cursor-sensor.el has:
> (define-minor-mode cursor-sensor-mode ...

In that case, there are two bugs:

1. The doc string should say that it is a minor mode, and say how
to change the value (on/off).  I think this has been addressed by
bug #20462.

2. (This bug) The manuals should document how to turn on/off a major mode
using Lisp.  Please retitle this bug appropriately.

Sorry if this mode is not an example of a major mode.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.