GNU bug report logs - #32959
26; Emacs manual index entry `C-SPC C-SPC disabling Transient Mark'

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 32959 <at> debbugs.gnu.org
Subject: bug#32959: 26;	Emacs manual index entry `C-SPC C-SPC disabling Transient Mark'
Date: Fri, 12 Oct 2018 17:11:02 +0300

> Date: Fri, 12 Oct 2018 14:00:44 +0000 (UTC)
> From: Drew Adams <drew.adams <at> oracle.com>
> Cc: 32959-done <at> debbugs.gnu.org
> 
> > > 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'.
> > 
> > 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 don't agree.  My rule is to have the unqualified name where the
subject is described in its fullest, and qualify the places which
describe its minor aspects and variations.

> That's very few occurrences, for all of Emacs: 4 in manuals, 10 in doc strings.

Maybe so, but it's a valid use of the wording.

Previous Next

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