[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
doc string of buffer-invisibility-spec
From: |
Drew Adams |
Subject: |
doc string of buffer-invisibility-spec |
Date: |
Wed, 30 May 2007 09:31:51 -0700 |
The doc string says:
Invisibility spec of this buffer.
The default is t, which means that text is invisible
if it has a non-nil `invisible' property.
If the value is a list, a text character is invisible if its `invisible'
property is an element in that list.
If an element is a cons cell of the form (PROP . ELLIPSIS),
then characters with property value PROP are invisible,
and they have an ellipsis as well if ELLIPSIS is non-nil.
It does not say anything about the situation where the `invisible'
property is itself a list. The Elisp manual, node Invisible Text
says this, in addition (where ATOM is a member of the
`buffer-invisibility-spec' value):
A character is invisible if its `invisible' property
value is ATOM or if it is a list with ATOM as a member.
The last part is what is missing from the doc string; "or if it is a
list with ATOM as a member".
IIUC, this implies, e.g., that if `buffer-invisibility-spec' is (foo
bar toto) and some text has property `invisible' with value (foo bar),
then it will be invisible, as will text with `invisible' value `foo'
and text with value (bar toto titi). The doc string only covers the
case where the value is `foo', `bar', or `toto', not the possible
list-value cases.
It might even be helpful in the manual to explicitly point out an
example such as value (toto titi), where `b-i-s' is, say, (foo toto)
- to show that the value need not be a subset of `b-i-s', that any
non-empty intersection will make the text invisible.
In GNU Emacs 22.1.50.1 (i386-mingw-nt5.1.2600)
of 2007-05-22 on LENNART-69DE564
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --cflags -Ic:/g/include'
Important settings:
value of $LC_ALL: nil
value of $LC_COLLATE: nil
value of $LC_CTYPE: nil
value of $LC_MESSAGES: nil
value of $LC_MONETARY: nil
value of $LC_NUMERIC: nil
value of $LC_TIME: nil
value of $LANG: ENU
locale-coding-system: cp1252
default-enable-multibyte-characters: t
Major mode: Info
Minor modes in effect:
encoded-kbd-mode: t
tooltip-mode: t
tool-bar-mode: t
mouse-wheel-mode: t
menu-bar-mode: t
file-name-shadow-mode: t
global-font-lock-mode: t
font-lock-mode: t
blink-cursor-mode: t
unify-8859-on-encoding-mode: t
utf-translate-cjk-mode: t
auto-compression-mode: t
line-number-mode: t
Recent input:
<help-echo> C-h i <help-echo> <help-echo> <down-mouse-2>
<mouse-2> g i n v i s i b l e SPC <tab> <return> C-h
v b u f f e r - i n v i s <tab> <return> <help-echo>
<help-echo> <help-echo> <help-echo> <help-echo> <help-echo>
<help-echo> <help-echo> <help-echo> <help-echo> <help-echo>
<menu-bar> <help-menu> <report-emacs-bug>
Recent messages:
Loading dired...done
For information about the GNU Project and its goals, type C-h C-p.
Loading info...
Loading easymenu...done
Loading info...done
Composing main Info directory...done
Loading help-fns...done
Loading pp...done
Type C-x 1 to remove help window.
Loading emacsbug...done
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- doc string of buffer-invisibility-spec,
Drew Adams <=