GNU bug report logs - #24890
25.1; Several documentation problems

Previous Next

Full log

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Jorge Morais Neto <jorge13515 <at> gmail.com>
Cc: 24890 <at> debbugs.gnu.org
Subject: Re: bug#24890: 25.1; Several documentation problems
Date: Thu, 10 Nov 2016 20:53:15 +0200

> From: Jorge Morais Neto <jorge13515 <at> gmail.com>
> Date: Thu, 10 Nov 2016 16:10:19 -0200
> Cc: 24890-done <at> debbugs.gnu.org
> 
> On 10 November 2016 at 14:26, Eli Zaretskii <eliz <at> gnu.org> wrote:
> >> From: Jorge Morais Neto <jorge13515 <at> gmail.com>
> >> Date: Thu, 10 Nov 2016 12:36:58 -0200
> >> Cc: 24890 <at> 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.

Previous Next

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