[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#24890: 25.1; Several documentation problems
From: |
Eli Zaretskii |
Subject: |
bug#24890: 25.1; Several documentation problems |
Date: |
Thu, 10 Nov 2016 20:53:15 +0200 |
> 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.