GNU bug report logs - #9981
24.0.91; mismatch in doc for `buffer-visibility-spec'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 9981 in the body.
You can then email your comments to 9981 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.0.91; mismatch in doc for `buffer-visibility-spec'
Date: Sun, 6 Nov 2011 17:33:41 -0800

(elisp) Invisible Text says this for a list value:
 
 Each element of the list specifies a criterion for
 invisibility; if a character's `invisible' property fits any
 one of these criteria, the character is invisible.  The list
 can have two kinds of elements:
 
 `ATOM'
   A character is invisible if its `invisible' property
   value is ATOM or if it is a list with ATOM as a member.
 
 `(ATOM . t)'
   A character is invisible if its `invisible' property
   value is ATOM or if it is a list with ATOM as a member.
   Moreover, a sequence of such characters displays as an
   ellipsis.
  
But the doc string says this:
 
 "a text character is invisible if its `invisible' property is an
  element in that list (or is a list with members in common)."
 
That's not the same thing.  The doc string does not speak to the second case for
the spec, (ATOM . t).  A char with `invisible' property of `foo' is neither a
member of the invisibility spec `((foo . t))' nor is it a list with the element
(foo . t).  Similarly for a char with `invisible' property of (foo).

According to the doc string, to be invisible with that spec, a char would have
to either be (foo . t) or be a list with (foo . t) as an element.

What's more, the doc string does not state that the form of the list elements is
in fact prescribed: ATOM or (ATOM . t).
 

In GNU Emacs 24.0.91.1 (i386-mingw-nt5.1.2600) of 2011-10-30 on MARVIN
 Windowing system distributor `Microsoft Corp.', version 5.1.2600
 configured using `configure --with-gcc (4.6) --no-opt --cflags
 -I"D:/devel/emacs/libs/libXpm-3.5.8/include"
 -I"D:/devel/emacs/libs/libXpm-3.5.8/src"
 -I"D:/devel/emacs/libs/libpng-dev_1.4.3-1/include"
 -I"D:/devel/emacs/libs/zlib-dev_1.2.5-2/include"
 -I"D:/devel/emacs/libs/giflib-4.1.4-1/include"
 -I"D:/devel/emacs/libs/jpeg-6b-4/include"
 -I"D:/devel/emacs/libs/tiff-3.8.2-1/include"
 -I"D:/devel/emacs/libs/gnutls-2.10.1/include" --ldflags
 -L"D:/devel/emacs/libs/gnutls-2.10.1/lib"'
 

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <9981 <at> debbugs.gnu.org>
Subject: RE: bug#9981: 24.0.91; mismatch in doc for `buffer-visibility-spec'
Date: Sun, 16 Sep 2012 17:23:56 -0700

ping

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 9981 <at> debbugs.gnu.org
Subject: Re: bug#9981: 24.0.91; mismatch in doc for `buffer-visibility-spec'
Date: Sat, 08 Feb 2014 21:53:55 -0800

"Drew Adams" <drew.adams <at> oracle.com> writes:

> But the doc string says this:
>
>  "a text character is invisible if its `invisible' property is an
>   element in that list (or is a list with members in common)."

That symbol no longer seems to exist.  Closing.  If this is still
relevant for some other symbol, please reopen.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 9981 <at> debbugs.gnu.org
Subject: RE: bug#9981: 24.0.91; mismatch in doc for `buffer-visibility-spec'
Date: Tue, 11 Feb 2014 07:14:02 -0800 (PST)

> > But the doc string says this:
> >
> >  "a text character is invisible if its `invisible' property is an
> >   element in that list (or is a list with members in common)."
> 
> That symbol no longer seems to exist.

There is a typo in the subject line.  It is `buffer-invisibility-spec'.
                                                    ^^

> Closing.  If this is still
> relevant for some other symbol, please reopen.

Sorry.  Glenn has apparently blocked me from reopening bugs.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 9981 <at> debbugs.gnu.org
Subject: Re: bug#9981: 24.0.91; mismatch in doc for `buffer-visibility-spec'
Date: Tue, 11 Feb 2014 17:07:25 -0800

Drew Adams <drew.adams <at> oracle.com> writes:

>> >  "a text character is invisible if its `invisible' property is an
>> >   element in that list (or is a list with members in common)."
>> 
>> That symbol no longer seems to exist.
>
> There is a typo in the subject line.  It is `buffer-invisibility-spec'.

Right.  Fixed on trunk.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

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