bug#24890: 25.1; Several documentation problems

[Eli Zaretskii <eliz@gnu.org>]

> From: Jorge Morais Neto <jorge13515@gmail.com>
> Date: Thu, 10 Nov 2016 16:10:19 -0200
> Cc: 24890-done@debbugs.gnu.org
> 
> On 10 November 2016 at 14:26, Eli Zaretskii <eliz@gnu.org> wrote:
> >> From: Jorge Morais Neto <jorge13515@gmail.com>
> >> Date: Thu, 10 Nov 2016 12:36:58 -0200
> >> Cc: 24890@debbugs.gnu.org
> >> In git (branch emacs-25), the docstring of outline-hide-sublevels is only:
> >> "Hide everything but the top LEVELS levels of headers, in whole buffer.
> >> This also unhides the top heading-less body, if any.
> >> [...]
> >
> > Maybe I'm missing something, but what does "Hide everything but the
> > top LEVELS levels of headers" mean, if not that all the headers of
> > those levels are revealed?
> 
> I parse that excerpt as "Hide (everything but the top LEVELS levels of
> headers)", with parenthesis used for grouping as in Mathematics.  But
> in an outline buffer, "everything but the top LEVELS levels of
> headers" means "headers of level > LEVELS and all bodies".  Therefore
> I interpret the excerpt as "hide (headers of level > LEVELS and all
> bodies)", with no action for headers of level ≤ LEVELS. Thus if a
> header of level ≤ LEVELS started hidden, in principle it would stay
> hidden.  Perhaps I am just misunderstanding English.  My native and
> primary language is Portuguese.  If you think the current wording is
> clear then we can leave it as is.

Yes, I think it's clear.