Subject: bug#15832: 24.3.50; doc of `up-list' and moving by "parens"

From: Drew Adams <[email-masked]>
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.