GNU bug report logs - #15832
24.3.50; doc of `up-list' and moving by "parens"

Previous Next

Full log

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 15832 <at> debbugs.gnu.org
Subject: RE: bug#15832: 24.3.50; doc of `up-list' and moving by "parens"
Date: Sun, 9 Feb 2014 22:11:42 -0800 (PST)

> > 2. `up-list' should be added to the list of commands mentioned in
> > (emacs) `Moving by Parens'.  `down-list' and `backward-up-list'
> > are mentioned, but not `up-list'.
> 
> `up-list' doesn't have a keyboard definition, which is why it's
> probably not documented in the Emacs manual.

It should still be mentioned.

> > 3. (elisp) `List Motion' mentions that the syntax table controls
> > which characters are treated like parentheses, which is good.
> > It then cross-references (emacs) `Moving by Parens' "for
> > user-level commands."
> >
> > It is good to cross-reference, but what are described at (elisp)
> > `List Motion' *are* user-level commands, so the characterization
> > "for user-level commands" is confusing and misleading.  The cross
> > reference should just say "see also".
> 
> The things described in the Emacs manual here are clearly more
> user-levelish, so I think that's OK.

If you want to say "for information about OTHER user-level
commands" or "for more information about these user-level
commands" (depending on which is meant), that would be fine, but
as it stands now it is confusing and misleading, giving
the impression that what are described here might NOT be
user-level commands.

Previous Next

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