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

Previous Next

Full log

View this message in rfc822 format

From: npostavs <at> users.sourceforge.net
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 25357 <at> debbugs.gnu.org, Eli Zaretskii <eliz <at> gnu.org>
Subject: bug#25357: 25.1; Doc for `cursor-sensor-mode' (and modes generally)
Date: Thu, 05 Jan 2017 22:58:09 -0500

[Message part 1 (text/plain, inline)]

Drew Adams <drew.adams <at> oracle.com> writes:
>
> Thanks.  Some minor comments.  If they help, fine; if not, ignore.
> One not-so-minor comment, flagged by ** (in two places).

Thanks, that was helpful.

>
> ** How so, "again"?  Here we are telling someone how to turn it
> on interactively.  I think we should also tell them how to do it
> using Lisp.

This is a subjective thing of course.  I guess it seems obvious to me
that a command can be called as a function, and it's explained in
`(elisp) What Is a Function'.  Adding cross references to that in every
place we talk about invoking some command is just clutter.

Eli Zaretskii <eliz <at> gnu.org> writes:

> 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 ...

Fixed this too.

[v2-0001-Clarify-major-mode-switching.patch (text/plain, attachment)]

Previous Next

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